Fluxo de IA no n8n com WhatsApp: nó, webhook e templates

Passo a passo

1. 1

   Instale o nó da comunidade

   No n8n, abra Settings > Community Nodes > Install, digite n8n-nodes-zapzap e aceite. É um nó da comunidade, publicado no npm (versão 0.1.3, de 27/10/2026) e com código aberto no GitHub. No n8n Cloud, confira na documentação do n8n se a sua conta aceita nós da comunidade; se não aceitar, siga pelo HTTP Request no último passo.

2. 2

   Crie a credencial com API key e secret

   No painel da ZapZap, abra Settings > API e copie a API Key e o API Secret. No n8n, crie uma credencial ZapZap API, cole os dois valores e salve: o n8n testa a credencial ao salvar e mostra uma mensagem verde se deu certo. Deixe a Base URL como está. O campo Default Country Code é opcional: com 55, o número 11 99999-0001 vira 5511999990001.

3. 3

   Envie a primeira mensagem

   Adicione o nó ZapZap, deixe Resource = Message e Operation = Send Text, escolha a instância na lista (instância é um número de WhatsApp conectado; se a lista vier vazia, crie e conecte um no painel antes), informe o número e o texto e execute. Para vários itens, ative Continue On Fail.

4. 4

   Receba mensagens com o ZapZap Trigger

   Adicione o ZapZap Trigger, escolha a credencial e a instância e ative o workflow: o nó registra a URL na instância e a remove quando você desativa. O n8n precisa de um endereço público em HTTPS (defina WEBHOOK_URL). A saída traz campos prontos como from, text, type, chatId, isGroup, fromMe e messageId. Cada entrega vem assinada (X-ZapZap-Signature, HMAC-SHA256 com horário) e o nó rejeita as falsificadas ou com mais de 5 minutos.

5. 5

   Monte o fluxo de IA

   Ligue o ZapZap Trigger a um nó AI Agent do n8n (com o modelo que você escolher lá) e o resultado a um nó ZapZap em Send Text. Ative Ignore My Own Messages no Trigger para a resposta automática não disparar o fluxo de novo. O nó ZapZap também pode ser usado como ferramenta de um agente de IA do n8n.

6. 6

   Ou use HTTP Request e Webhook, sem instalar nada

   No HTTP Request, use POST em https://api.zapzapapi.com/api/v1/{instanceId}/send/text com os cabeçalhos x-api-key e x-api-secret e um corpo JSON com number e text. Para receber, crie um nó Webhook, copie a Production URL e cadastre-a na instância pelo endpoint webhook (POST /{instanceId}/webhook, com os eventos que quiser). Ative o workflow para a Production URL responder.

// Exemplo ILUSTRATIVO do nó HTTP Request no n8n (POST), caso você não use o nó da comunidade
// Campos e caminho exatos: https://api.zapzapapi.com/llms.txt
POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text
Headers:
  x-api-key: SUA_API_KEY
  x-api-secret: SEU_API_SECRET
  Content-Type: application/json
Body:
{
  "number": "5511999999999",
  "text": "Olá! Seu agendamento foi confirmado."
}