Webhooks de entrada

Com a versão de armazenamento em nuvem do Linked Helper, é possível adicionar perfis a uma campanha via webhook de entrada.

• Criar webhook
• Enviar dados para o webhook
  • Esquema do payload e exemplos
• Excluir webhook

Criar webhook

Nota: webhooks de entrada estão disponíveis apenas para usuários da versão de armazenamento em nuvem do Linked Helper.

• Abra uma campanha e vá para a aba Workflow
• Clique no ícone Webhook ao lado do botão Add
  
• Dê um nome e clique no botão Add webhook
  
• Depois que o webhook for criado, você pode:
  • ativar o modo Stand by, que permite manter a campanha pronta para ser retomada quando novos perfis forem recebidos; caso contrário, será necessário iniciá-la manualmente quando os perfis forem adicionados;
  • copiar a URL do webhook e adicioná-la à sua outra ferramenta:
    
  •  Adicionar outro webhook para receber perfis de diferentes fontes:
    

Enviar dados para o webhook

Esquema do payload e exemplos

O webhook pode receber requisições POST com dados no corpo da requisição:

• obrigatório: URLs do LinkedIn ou Sales Navigator
• opcional: campos personalizados

É possível enviar múltiplas URLs em uma única requisição, cada uma com vários campos personalizados (ou nenhum). 

Esquema do payload:

{
  "type": "object",
  "required": ["people"],
  "properties": {
    "people": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": ["externalId"],
        "properties": {
          "externalId": {
            "type": "string",
            "minLength": 1,
            "format": "uri",
            "description": "LI/SN profile URL. Backend extracts person external id from the link."
          },
          "customFields": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "object",
              "required": ["key", "value"],
              "properties": {
                "key": {
                  "type": "string",
                  "minLength": 4,
                  "pattern": "^cs_.+"
                },
                "value": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            },
            "description": "Optional per-person custom fields."
          }
        },
        "additionalProperties": false
      },
      "description": "List of people to add to campaign."
    }
  },
  "additionalProperties": false
}

Exemplo de payload com variáveis personalizadas:

{
  "people": [
    {
      "externalId": "https://www.linkedin.com/in/jane-doe-123456789/",
      "customFields": [
        {
          "key": "cs_source",
          "value": "webhook"
        }
      ]
    },
    {
      "externalId": "https://www.linkedin.com/sales/lead/ACwAAAZXyZABcD1234567890abcdef,NAME_SEARCH,abcd1234",
      "customFields": [
        {
          "key": "cs_source",
          "value": "manual-import"
        },
        {
          "key": "cs_segment",
          "value": "enterprise"
        }
      ]
    }
  ]
}

Exemplo de payload sem variáveis personalizadas:

{
  "people": [
    {
      "externalId": "https://www.linkedin.com/in/jane-doe-123456789/",
      "customFields": []
    },
    {
      "externalId": "https://www.linkedin.com/sales/lead/ACwAAAZXyZABcD1234567890abcdef,NAME_SEARCH,abcd1234",
      "customFields": []
    }
  ]
}

Excluir webhook

• Abra uma campanha e vá para a aba Workflow
• Clique no ícone Webhook ao lado do botão Add
  
• Clique no ícone de lixeira na linha do webhook que deseja excluir e confirme a ação: