Agente de IA no WhatsApp com n8n, com a resposta escrita pelo seu workflow
Uma etapa da automação faz um POST da mensagem do cliente, assinada e com até 10 mensagens recentes do chat, para um nó Webhook do n8n. Um nó AI Agent escreve a resposta, um nó Respond to Webhook devolve {"reply": "..."} em até 20 segundos, e esse texto é enviado pelo número do WhatsApp Business, que continua funcionando no app. Agentes mais lentos recebem o webhook da Meta diretamente e respondem pela Graph API.
O easyCoexistence conecta à Cloud API da Meta, por meio da Coexistência, o número do WhatsApp Business que você já usa no app, e roda automações nele.
Tempo que a etapa Call my webhook espera pela resposta do seu workflow antes de falhar.
Mensagens mais recentes do chat enviadas em history, da mais antiga para a mais nova, terminando com a mensagem que iniciou a execução.
Caracteres de uma resposta enviada como um único texto no WhatsApp; o que passar disso é cortado.
Intervalo mínimo entre dois e-mails de falha para a mesma automação quando uma etapa de webhook falha.
O que o n8n Cloud permite em um nó Code: crypto e moment; o n8n self-hosted habilita crypto com NODE_FUNCTION_ALLOW_BUILTIN.
Janela de atendimento ao cliente após a última mensagem dele; depois disso, a Meta aceita apenas mensagens de template.
Como uma mensagem do WhatsApp chega a um agente de IA no n8n?
Por meio de uma automação no número. O número precisa receber as mensagens por meio do easyCoexistence (o modo “Through easyCoexistence”), para que a Meta as entregue aqui. Uma automação cujo gatilho é A message arrives e cuja etapa é Call my webhook envia então um POST da mensagem para a Production URL do seu n8n. O workflow responde na mesma resposta HTTP, e o texto devolvido chega ao cliente como uma mensagem do WhatsApp enviada pelo seu número.
Antes de o n8n ser chamado, a execução já passou pelas proteções. Uma entrega que a Meta repete nunca inicia uma segunda execução, uma resposta que você digitou no app pausa a automação naquele chat (4 horas por padrão), e a resposta só sai em até 24 horas após a última mensagem do cliente. Seu workflow decide apenas o que dizer.
O que o easyCoexistence envia ao nó Webhook do n8n?
Um POST em JSON com User-Agent easyCoexistence-automations/1, X-EC-Event definido como automation.step e um cabeçalho X-EC-Signature. message traz o texto do cliente ou, no caso de mídia, um marcador como [image] com a legenda; uma mensagem de voz chega como [voice message] seguido das palavras dela quando uma chave da OpenAI ou da OpenRouter está salva. history traz até 10 mensagens recentes do chat, da mais antiga para a mais nova, cada uma com uma direção: in para o cliente, out para a resposta de uma automação e echo para uma pessoa escrevendo pelo celular. Cobre as mensagens guardadas durante o período de retenção da conta (30, 90 ou 365 dias, 90 por padrão), e somente as que chegaram enquanto as mensagens do número passavam pelo easyCoexistence.
Um teste pelo painel Try it do editor envia o mesmo POST com dry_run definido como true, um history vazio, o contato de exemplo 15550000000 chamado Test customer e um id de mensagem começando com test_. Nada é enviado a ninguém, mas seu workflow roda de verdade, então pule efeitos colaterais, como criar pedidos, quando dry_run for true.
{
"event": "automation.step",
"dry_run": false,
"automation": { "id": "b7e0c3a2-5d1f-4c8e-9a6b-2f4d8e1c7a90", "name": "Send to my system" },
"run_id": "0d9f6a41-8c2e-4b7a-a315-6e9c2b8d4f17",
"channel": {
"type": "whatsapp",
"connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f",
"phone": "+1 631-555-0142",
"phone_number_id": "106540352242922"
},
"connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": {
"id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==",
"type": "text",
"text": "Do you have gluten-free bread today?",
"at": "2026-11-11T14:02:11.000Z"
},
"history": [
{ "direction": "in", "text": "Hi! Are you open today?", "at": "2026-11-11T13:58:40.000Z" },
{ "direction": "out", "text": "Hi Ana! Yes, until 8 pm.", "at": "2026-11-11T13:58:45.000Z" },
{ "direction": "in", "text": "Do you have gluten-free bread today?", "at": "2026-11-11T14:02:11.000Z" }
]
}Como verificar a assinatura no n8n?
Adicione um nó Code logo após o nó Webhook. X-EC-Signature tem o formato t=<unix seconds>,v1=<hex>, em que v1 é um HMAC-SHA256 de t, um ponto e o corpo, usando como chave o Signing secret da automação. Para copiá-lo, abra a automação salva e selecione a etapa Call my webhook dela. Cada automação tem seu próprio segredo, e as ferramentas MCP nunca o devolvem, então uma automação criada pela sua IA ainda exige copiar esse segredo do painel uma vez. Um botão New secret o substitui e o antigo para de funcionar na hora, e só o dono da conta pode vê-lo, não um membro convidado da equipe.
Rejeite um t com mais de 5 minutos de diferença do seu relógio, compare em tempo constante e lance um erro em caso de falha: o workflow então dá erro antes do Respond to Webhook, o n8n responde 500 e nada é enviado. O n8n Cloud permite o módulo crypto em nós Code; o n8n self-hosted precisa de NODE_FUNCTION_ALLOW_BUILTIN=crypto. A ação Hmac do nó Crypto com um nó IF também funciona, embora a comparação do IF não seja em tempo constante.
// n8n Code node, mode "Run Once for Each Item", placed right after the Webhook node.
// n8n Cloud allows require('crypto'); self-hosted needs NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the automation's Signing secret, from its editor page
const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec($json.headers['x-ec-signature'] || '');
if (!m) throw new Error('Missing X-EC-Signature');
if (Math.abs(Date.now() / 1000 - Number(m[1])) > 300) throw new Error('Stale signature');
// The body was signed as compact JSON, which JSON.stringify rebuilds from the parsed body.
const mac = crypto.createHmac('sha256', SECRET).update(`${m[1]}.${JSON.stringify($json.body)}`).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(m[2], 'hex'))) throw new Error('Bad signature');
return { json: $json.body }; // event, dry_run, contact, message, history...Como configurar o nó AI Agent e a resposta?
Passe ao nó AI Agent o texto do cliente como mensagem do usuário e todo o resto na mensagem de sistema: quem é o negócio, os fatos que ele pode citar, o tom e o chat recente de history, para que uma pergunta de acompanhamento faça sentido. Conecte o modelo de chat que você quiser, além de ferramentas como uma HTTP Request tool que consulta um pedido.
Termine com um nó Respond to Webhook que responde com JSON e coloca o texto do agente em um campo chamado reply. O easyCoexistence remove os espaços nas extremidades, ignora um reply vazio ou que não seja string e envia o restante como um único texto de WhatsApp de até 4.096 caracteres, então peça ao modelo frases simples, e não markdown.
AI Agent node
Prompt: Define below
Prompt (User Message): {{ $json.message.text }}
Options > System Message:
You answer WhatsApp messages for Bloom Café, 12 Baker St, open Tue to Sun 8:00 to 20:00.
Reply in 1 to 3 short sentences, in the customer's language, as plain text.
Never invent prices or stock. If unsure, say a person will reply here soon.
Recent chat, oldest first:
{{ $json.history.map(h => (h.direction === 'in' ? 'Customer: ' : 'Business: ') + h.text).join('\n') }}
Chat Model: your OpenAI, Anthropic or OpenRouter model
Tools (optional): an HTTP Request tool that looks up orders
Respond to Webhook node
Respond With: JSON
Response Body: { "reply": {{ $json.output.toJsonString() }} }O que acontece quando o workflow está lento, falha ou não devolve nada?
Cada resultado fica registrado na aba Runs da automação, com a saída ou o erro da etapa, para que você veja qual destes casos aconteceu:
- Sem resposta em 20 segundos: a etapa falha com Webhook did not answer, nada é enviado e a execução mostra Failed.
- Um status fora de 2xx, incluindo redirecionamentos: a etapa falha com Webhook answered HTTP e o código.
- Um 2xx sem uma string reply: a execução fica Done, a etapa mostra HTTP 200, no reply, e o cliente não recebe nenhuma resposta automática.
- Uma execução com falha envia um e-mail para que você mesmo responda a esse cliente, no máximo uma vez por automação a cada 6 horas.
- Um chat que você respondeu pelo celular dentro da pausa (4 horas por padrão, ajustável em Advanced) é ignorado como
human_activeantes de o n8n ser chamado. - Várias mensagens seguidas iniciam várias execuções. Um Wait de 1 minuto antes de Call my webhook faz responder uma vez só, porque uma mensagem mais nova que aciona a mesma automação substitui a execução em espera.
Quando o n8n deve receber o webhook da Meta diretamente?
Quando o agente precisa de mais de 20 segundos, quando o workflow precisa ver todos os eventos (status, suas respostas pelo celular, ids de mídia), quando ele envia algo que nenhum passo cobre, como um Flow ou uma mensagem de catálogo, ou quando o negócio quer a importação do histórico de 6 meses, que só vai para um destino direto salvo em até 24 horas após a conexão. O modo direto desliga as automações do número: a Meta envia o próprio payload direto ao n8n e o easyCoexistence nunca vê as mensagens.
No n8n, use o nó Webhook simples, não o nó WhatsApp Trigger, que espera o seu próprio app da Meta e o segredo dele. Ative Allow Multiple HTTP Methods para que um caminho longo e aleatório receba o handshake GET da Meta e os POSTs, responda ao GET com o hub.challenge bruto como texto e salve essa Production URL com um verify token por meio de set_webhook_destination. As respostas então saem de um nó HTTP Request para o endpoint de envio, e a deduplicação, a pausa do celular e a checagem de 24 horas passam a ser responsabilidade sua.
| Call my webhook (Automations on) | Direct webhook (automations off) | |
|---|---|---|
| Who calls n8n | easyCoexistence, when the automation matches | Meta, for every event on the number |
| Time to answer | 20 seconds, reply in the response | No limit: send later through the Graph API |
| Authentication | X-EC-Signature with the automation's secret | A long random secret in the URL path |
| Guards | Dedupe, phone pause and 24-hour check built in | Yours to write |
| What n8n can send | Text in the reply; the other steps of the automation can send buttons, files and templates | Any Cloud API message type, templates included |
| History import | Not available | If saved within 24 hours of connecting |
| Kept by easyCoexistence | Message text for your retention period (90 days by default), run logs 30 days | Nothing |
Como configurar
- Turn on automations for the numberOn the number's page, the Automations and incoming messages card shows Automations on or Direct to your server. Click Turn on automations if needed; numbers connected without a webhook URL start with automations on.
- Build and publish the workflowWebhook node (POST, Respond: Using 'Respond to Webhook' Node), Code node, AI Agent node, Respond to Webhook node. Publish or activate it and copy the Production URL.
- Create the automation, switched OffIn Automations, click New automation and pick Send to my system under Start from an example. Paste the Production URL into Webhook URL, set the switch to Off so it does not answer customers yet, and click Save.
- Copy the Signing secret into n8nSelect the Call my webhook step of the saved automation, copy Signing secret and paste it into the Code node.
- Test, then switch it OnClick Test, type a sample message in Try it and press Run test: n8n runs with dry_run true and the result shows the reply. When it reads right, switch the automation On and save.
Erros comuns
- Deixar a opção Respond do nó Webhook em Immediately. O n8n responde Workflow got started na hora, a execução registra HTTP 200, no reply, e o cliente não recebe nada. Escolha Using 'Respond to Webhook' Node.
- Colar a Test URL, a que tem /webhook-test/. Ela só escuta enquanto o editor espera um evento de teste; as automações precisam da Production URL de um workflow publicado.
- Verificar com o segredo de encaminhamento do número. Call my webhook é assinado com o Signing secret da própria automação; o segredo de encaminhamento assina apenas os eventos encaminhados, então etapas legítimas falham na verificação.
- Devolver o texto em outro formato. Só é enviado um corpo JSON com uma string de nível superior chamada reply; {"output": "..."} ou um corpo text/plain são registrados como no reply.
A etapa Call my webhook entrega a mensagem do cliente ao n8n e envia de volta a resposta, com deduplicação, a pausa quando você responde pelo celular e a checagem de 24 horas já incluídas, sem cobrança extra por execução. De R$ 29,90 até R$ 3,90 por número por mês, caindo conforme você adiciona números, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O ChatGPT ou o Claude podem criar essa automação para mim?
Sim. Com o conector do easyCoexistence adicionado, peça uma automação no seu número que envie as mensagens recebidas para a URL do seu n8n; a IA chama create_automation com uma etapa call_webhook e depois test_automation. Peça para criar a automação desativada até o teste passar. O Signing secret não é devolvido pelo MCP, então copie-o da página da automação.
O workflow pode enviar imagens, botões ou templates?
Não pelo campo reply, que leva apenas texto. Deixe a automação fazer isso: passos como Send a picture or file, Ask a question with buttons e Send a template podem ficar antes ou depois de Call my webhook. Para outros tipos de mensagem, envie-os por um nó HTTP Request para a Cloud API, com o endpoint de envio e o token que get_api_credentials devolve, e não devolva reply, para que o cliente não receba duas respostas.
Um mesmo workflow pode responder a vários números?
Sim. Aponte uma automação por número para a mesma Production URL e crie ramificações por channel.phone_number_id ou automation.id. Cada automação tem seu próprio Signing secret, então escolha o segredo pelo automation.id antes de verificar a assinatura.
Um n8n self-hosted funciona?
Sim, desde que a Production URL seja HTTPS pública. O easyCoexistence recusa http, localhost e endereços privados ou internos ao salvar a URL e de novo antes de cada chamada, e não segue redirecionamentos.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em