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.
- 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, como Índice de Intenção, impressões, engajamentos ou gasto maior que um valor.
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.