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 "Outro sistema mandou os dados (webhook)"
Em Tipo de gatilho, troque "Entrou em um grupo de clientes (segmento)" por Outro sistema mandou os dados (webhook).
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"). Mais abaixo, no bloco Reentrada, escolha o que fazer se o mesmo contato chegar de novo (veja Se o mesmo contato chegar de novo). 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 |
restarted |
O contato já tinha passado pelo fluxo e começou de novo | Nada, a regra de reentrada deixou |
ignored |
Chegou, mas o contato não entrou de novo. O campo reason diz por quê |
Veja a tabela abaixo |
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 |
Quando a resposta é ignored, o campo reason explica:
reason |
O que significa |
|---|---|
already_in_flow |
O contato está no meio da jornada e a regra não deixa reiniciar no meio |
already_done |
O contato já terminou a jornada e a regra é Não permitir reentrada |
too_soon |
Ainda não deu o tempo que a regra pede para começar de novo |
Se o mesmo contato chegar de novo
O mesmo contato pode chegar várias vezes pelo webhook, como um cliente que muda de etapa no CRM duas vezes. No bloco Reentrada do gatilho você escolhe o que acontece:
- Não permitir reentrada: o envio novo é ignorado. Cada contato faz a jornada uma vez só.
- Reiniciar em qualquer etapa: o contato volta para a primeira mensagem, mesmo que esteja no meio.
- Reiniciar só se já terminou a jornada: começa de novo só quem já terminou. Quem está no meio continua de onde está.
Fluxos de webhook criados antes dessa opção, e que nunca tiveram a reentrada escolhida, seguem como antes: cada contato entra uma vez só.
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 ignored, o contato já estava no fluxo ou já tinha passado por ele, e a regra de Reentrada não deixou começar de novo.
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.