Como conectar com a Emanda por Webhook
Receba contatos vindos de outro sistema e coloque cada um num Fluxo Próprio, que já começa a jornada sozinho.
O que é o webhook da Emanda
O webhook é um endereço da Emanda que recebe contatos vindos de outro sistema e coloca cada um deles dentro de um Fluxo Próprio. Quando o seu sistema avisa "chegou um contato novo", a Emanda cadastra a pessoa e começa a jornada que você desenhou.
Exemplos de uso:
- Um formulário do seu site manda nome, e-mail e telefone de quem se inscreveu.
- Seu CRM ou ERP avisa quando um cliente mudou de etapa.
- Uma ferramenta de automação (n8n, Zapier, Make) repassa contatos de outra plataforma.
- Acesso ao painel da Emanda.
- Um sistema que saiba fazer uma chamada POST com corpo em JSON. Quase todos sabem. Na dúvida, pergunte ao seu desenvolvedor.
O webhook recebe somente dados de contato: e-mail, telefone e nome. Pelo menos o e-mail ou o telefone precisa vir preenchido.
Passo a passo no painel
São 7 passos. O ponto principal: o fluxo precisa estar publicado para os contatos entrarem.
Abra o Fluxo Próprio
No menu, vá em Automações e clique em Fluxo Próprio, no canto de cima.
Dê um nome e clique no Gatilho de entrada
Todo fluxo começa com o bloco Gatilho de entrada. Escreva o nome do fluxo no campo de cima e clique no bloco para abrir as opções à direita.
Escolha "Webhook recebido (sistema externo)"
Em Tipo de gatilho, troque "Entrou no segmento" por Webhook recebido (sistema externo).
Clique em Configurar webhook
Aqui você também pode ligar Aplicar uma tag, para marcar todo mundo que chegar por esse caminho (ex.: "Lead do site"). Depois clique em Configurar webhook.
Copie a URL
Clique em Copiar e cole essa URL no seu sistema (formulário, n8n, Zapier, ERP). Cada fluxo tem uma URL própria.
DicaSe a URL não aparecer, salve o fluxo e abra esta tela de novo.
Envie um contato de teste e faça o mapeamento
Faça o seu sistema mandar um contato de teste (veja Como enviar os dados). Depois clique em Atualizar: os campos que chegaram aparecem na lista. Clique em cada um para adicioná-lo ao mapeamento.
Confira se cada campo foi ligado ao dado certo da Emanda. A Emanda sugere sozinha, mas você pode trocar na lista à direita. O quadro fica verde quando há pelo menos E-mail ou Telefone. Tudo é salvo automaticamente; clique em Concluir.
Monte as mensagens e publique
Adicione os blocos da jornada (E-mail, WhatsApp, Espera) abaixo do gatilho. Quando estiver pronto, clique em Publicar.
AtençãoEnquanto o fluxo estiver em rascunho, os contatos enviados ficam só registrados e não entram na jornada.
Como enviar os dados
O seu sistema deve fazer uma chamada POST para a URL do webhook, com o cabeçalho Content-Type: application/json e os dados do contato no corpo. Não precisa de senha nem token extra: a própria URL já é a chave, então trate-a como segredo.
Exemplo de corpo. Os nomes dos campos são livres, você liga cada um a um dado da Emanda no mapeamento:
{
"nome": "Maria Souza",
"email": "[email protected]",
"telefone": "5511999998888"
}
Os campos podem estar dentro de outros objetos. Nesse caso o caminho usa ponto, por exemplo cliente.email.
| Dado na Emanda | Obrigatório | Observação |
|---|---|---|
| E-mail do cliente | Pelo menos um dos dois | É por ele que a Emanda reconhece um contato que já existe |
| Telefone do cliente | Pelo menos um dos dois | Com DDI e DDD, só números (ex.: 5511999998888) |
| Nome do cliente | Não | Usado nas mensagens, como em "Olá, Maria" |
Exemplo pronto para testar pelo terminal (troque a URL pela sua):
curl -X POST "https://app.emanda.com.br/api/flows/hook/SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"nome":"Maria Souza","email":"[email protected]","telefone":"5511999998888"}'
Como testar e confirmar que chegou
Toda chamada recebida fica gravada, mesmo quando o contato ainda não entra no fluxo. Envie um contato de teste com o seu próprio e-mail, abra o gatilho e clique em Atualizar. Depois leia o campo status da resposta:
| Resposta | O que significa | O que fazer |
|---|---|---|
accepted |
Deu certo: o contato entrou no fluxo | Nada, a jornada já começou |
already_in_flow |
O contato já tinha entrado nesse fluxo | Normal. Cada contato entra uma vez só |
discovery |
Chegou, mas o mapeamento não foi feito | Faça o mapeamento e envie de novo |
mapping_incomplete |
Mapeamento sem e-mail nem telefone | Ligue um campo a E-mail ou Telefone |
no_contact_value |
Chegou sem e-mail e sem telefone | Confira os valores que o sistema manda |
flow_not_active (409) |
Fluxo em rascunho ou pausado | Clique em Publicar |
not_found (404) |
URL errada ou bloco apagado | Copie a URL de novo no painel |
Exemplos em ferramentas comuns
Em qualquer ferramenta a receita é a mesma: método POST, a URL da Emanda, corpo em JSON com e-mail e/ou telefone.
| Ferramenta | Onde configurar | O que preencher |
|---|---|---|
| n8n | Nó HTTP Request | Method: POST · URL da Emanda · Body em JSON |
| Zapier | Webhooks by Zapier › POST | Payload Type: json · nome, email, telefone |
| Make | HTTP › Make a request | Method: POST · Body: Raw · JSON |
| Sistema próprio | Peça ao desenvolvedor | Mande o exemplo de Como enviar os dados |
Perguntas frequentes
Enviei, mas o contato não recebeu nada. Por quê?
Confira três coisas: o fluxo está publicado, o mapeamento tem E-mail ou Telefone, e a resposta veio com accepted. Se veio already_in_flow, esse contato já tinha passado pelo fluxo.
Se o contato já existe na minha base, ele é duplicado?
Não, quando vem com e-mail. A Emanda procura pelo e-mail e usa o contato que já existe. Dados vazios são completados; o que já estava preenchido não é trocado.
Posso mandar só o telefone?
Pode. O ideal é mandar os dois, porque o e-mail identifica a pessoa com mais segurança.
Alguém pode usar a minha URL?
Quem tiver a URL consegue colocar contatos no seu fluxo. Não publique a URL em lugares abertos. Se ela vazar, apague o gatilho e crie outro para gerar uma URL nova.
Meu sistema só envia GET ou formulário comum.
O webhook aceita apenas POST com JSON. Use uma ferramenta intermediária como n8n, Zapier ou Make para converter o envio.