Um webhook é uma forma de o WiseData Leads avisar o seu sistema automaticamente sempre que um novo lead entra na sua conta. Em vez de você ficar conferindo a plataforma e copiando dados manualmente, a cada novo lead importado a plataforma envia as informações dele para um endereço (uma URL) do seu sistema — seu CRM, sua automação ou uma planilha conectada. É a base para integrar o WiseData Leads ao seu fluxo de trabalho, em tempo real.
Hoje o evento que dispara um webhook é o "Lead importado": assim que um lead é importado e totalmente processado, o aviso é enviado.
Disponibilidade: webhooks são um recurso do plano Pro. Nos demais planos, a página mostra um convite para fazer upgrade.
Como criar um webhook
Na página Webhooks, clique em Novo webhook e preencha:
Nome — um rótulo para você identificar o webhook (por exemplo, "Meu CRM").
URL de destino — o endereço (que começa com https://) do seu sistema que vai receber os dados.
Seções do payload — quais blocos de informação do lead você quer receber. Marque pelo menos uma. Apenas os campos das seções marcadas são enviados.
Validar e-mail antes de enviar (opcional) — explicado abaixo.
Clique em Criar webhook para concluir.
As seções de dados
Você escolhe exatamente o que quer receber de cada lead, entre estas seções:
Cadastro, Atividade econômica, Endereço, Contato, Simples Nacional, Sócios (QSA), Enriquecimento, Redes sociais, Validação de e-mail e Grupo.
Por padrão vêm marcadas Cadastro e Contato, mas você ajusta conforme o que o seu sistema precisa.
Validar e-mail antes de enviar
Se você ativar essa opção, a validação de e-mail do lead acontece automaticamente logo após a importação, e o webhook só é enviado quando o resultado estiver pronto — assim seu sistema já recebe a informação de qualidade do e-mail junto. É prático, mas lembre-se de que a validação de e-mail consome créditos (como qualquer validação). Sem essa opção, o webhook é enviado assim que o lead é processado, sem esperar pela validação.
Depois de criar: o secret
Ao criar o webhook, a plataforma mostra uma vez só um secret (um código de segurança). Copie e guarde esse código no momento — ele serve para o seu sistema confirmar que o aviso veio mesmo do WiseData Leads. Os detalhes de como usá-lo estão no artigo sobre o secret e a validação de assinatura.
Gerenciando seus webhooks
Na lista de webhooks você pode editar (nome, URL, seções e validação), desativar temporariamente (sem apagar) e reativar quando quiser, além de excluir de vez. Para acompanhar o que foi enviado e reenviar entregas que falharam, use a aba Logs — explicada em outro artigo.
Resumindo: um webhook entrega cada novo lead direto no seu sistema, em tempo real. Para criar, vá em Webhooks → Novo webhook, defina nome e URL, escolha as seções de dados e (se quiser) a validação de e-mail. Guarde o secret exibido na criação. Recurso disponível no plano Pro.