Webhooks enviam dados do LinkedScope para outras ferramentas, como n8n, Make, Zapier ou o seu CRM. Você escolhe a categoria de dados e o LinkedScope faz um POST em JSON na URL que você indicar, na frequência certa.
- Onde: Configurações > Webhooks
- Quem pode configurar: Titular, Admin e Gerente
- Formato: POST com corpo em JSON
Categorias e quando cada uma é enviada
| Categoria | Quando envia | O que envia |
|---|---|---|
| Empresas Impactadas | Agendado (diário, semanal ou mensal) | Empresas alcançadas no intervalo escolhido, com métricas, Índice de Intenção e dados do CRM. |
| Campanhas | Agendado | Métricas das campanhas no intervalo escolhido. |
| Anúncios | Agendado | Métricas dos anúncios no intervalo escolhido. |
| Leads | Tempo real | Cada lead novo, com respostas do formulário, UTMs e empresa. |
| Engagers | Tempo real | Cada novo engajamento (reação ou comentário) dos últimos 7 dias, com a pessoa, a empresa e o post. |
| Prospecção | Sob demanda | Os prospects que você envia pelas Ações em massa. |
Horários dos webhooks agendados
- Diário: todos os dias às 09:00 UTC.
- Semanal: toda segunda-feira às 09:00 UTC.
- Mensal: todo dia 1, às 09:00 UTC.
Webhooks em tempo real
- Leads do site e de formulários nativos recebidos um a um chegam na hora, um por envio. Leads importados em lote chegam agrupados ao fim da importação.
- Leads enviados antes da conexão da conta de anúncios, que chegam na importação inicial, não disparam o webhook.
- Engagers são enviados ao fim de cada atualização do Engagers, agrupados, apenas com engajamentos dos últimos 7 dias. A primeira coleta de uma fonte nova não inunda o destino com o histórico.
- Envios agrupados têm no máximo 200 itens. Acima disso, o LinkedScope faz vários envios seguidos.
Filtros de envio
Leads, Engagers e Empresas Impactadas aceitam as condições Enviar somente Contas Alvo e Enviar somente não clientes. Empresas Impactadas também aceita limites mínimos de Índice de Intenção, Impressões e Engajamentos pagos (maior que um valor). Webhooks antigos com a condição de gasto continuam funcionando, mas ela não é mais oferecida em condições novas.
Segurança
Informe um Token de autenticação (opcional) ao criar o webhook. Ele é enviado no header Auth de cada chamada: valide esse valor no destino para ter certeza de que a chamada veio do LinkedScope.
Próximos passos
- Como criar um webhook: passo a passo com todos os campos.
- Webhook pausado automaticamente: por que acontece e como reativar: o que fazer quando o destino para de responder.
Perguntas frequentes
Os webhooks de Empresas, Campanhas e Anúncios não estão chegando.
Essas categorias precisam do LinkedIn Ads conectado com uma conta de anúncios selecionada. Sem isso, o envio é bloqueado. Veja Como conectar o LinkedIn Ads ao LinkedScope.
O webhook de Engagers parou.
Confira se a conexão do LinkedIn no Engagers continua ativa. Veja Como adicionar e gerenciar as fontes do Engagers.
Posso usar o mesmo webhook para várias categorias?
Não. Cada webhook tem uma categoria. Crie um webhook por categoria, mesmo que apontem para a mesma URL.