Bot de IA no WhatsApp, Instagram e Messenger com n8n (template pronto)
Monte um bot de IA (GPT/OpenAI) que responde no WhatsApp, Instagram e Messenger num único fluxo do n8n. Template pronto WAME, com memória por contato.
Neste tutorial você monta um atendente de IA que responde no WhatsApp, no Instagram e no Messenger a partir de um único fluxo do n8n. A IA usa um modelo da OpenAI (o mesmo motor do ChatGPT), mantém memória por contato e envia as respostas pela WAME. Você não precisa criar app na Meta nem virar Tech Provider: importa o template pronto, conecta duas credenciais e testa.
Este guia é o complemento editorial da landing n8n Bot para WhatsApp, Instagram e Messenger.
1. O que você vai montar
O objetivo é simples: uma pessoa manda mensagem em qualquer um dos três canais e recebe uma resposta gerada por IA, no mesmo canal, com contexto da conversa.
- IA nos 3 canais — WhatsApp, Instagram Direct e Messenger, atendidos pelo mesmo bot.
- Um único fluxo — a WAME entrega tudo no envelope no formato Meta; o campo
providerdiz qual canal originou a mensagem. - Memória por contato — cada pessoa tem sua própria janela de contexto, então o bot lembra o que foi dito antes sem misturar conversas.
2. Pré-requisitos
Antes de começar, você precisa de três coisas:
- Uma instância WAME ativa. Crie ou pegue sua chave no portal. Serve tanto para a conexão oficial (Cloud API) quanto para a não oficial (QR Code).
- Um n8n — Cloud ou self-hosted. No self-hosted, garanta um domínio público com HTTPS, pois a WAME precisa alcançar a URL do webhook.
- Uma chave da OpenAI para o AI Agent gerar as respostas.
3. Importar o template
No n8n, crie um novo workflow e use a opção de importação. Há dois caminhos:
- Import from URL — cole a URL do arquivo
.json:
https://api-wa.me/n8n/bot-wame-whatsapp-instagram-messenger.json
- Import from File — se preferir, baixe o mesmo arquivo e importe do seu computador.
Ao importar, o n8n cria o fluxo completo com os cinco nós já conectados. Você ainda precisa preencher as credenciais (passo 6), mas a estrutura vem pronta.
4. Os 5 nós explicados
O template é enxuto de propósito. Cada nó tem uma responsabilidade clara:
Webhook WAME → Extrair Mensagem → Gerar Resposta (IA) → Memória por Contato → Enviar Resposta
- Webhook WAME — recebe os três canais no mesmo envelope no formato Meta. O caminho (path) do webhook é
wame-bot, então a URL final fica algo comohttps://SEU-N8N/webhook/wame-bot. O campoproviderdo envelope indica se a mensagem veio do WhatsApp, do Instagram ou do Messenger. - Extrair Mensagem — um nó de código que lê o envelope, ignora eventos de status (entregue, lido) e extrai apenas o texto da mensagem, além do remetente. É aqui que o fluxo filtra ruído e fica com o que importa.
- Gerar Resposta — um AI Agent com modelo da OpenAI, o mesmo motor do ChatGPT. Recebe o texto do contato e produz a resposta. É o cérebro do bot.
- Memória por Contato — um buffer window ligado ao AI Agent. Guarda a janela das últimas mensagens separada por contato, dando continuidade à conversa.
- Enviar Resposta — um HTTP Request que faz
POSTpara o endpoint de texto da WAME, mandando a resposta de volta pelo canal de origem:
POST https://us.api-wa.me/{{instance}}/message/text
Como o instance vem do próprio envelope recebido, a resposta sai sempre pela instância certa, no canal certo.
5. Conectar a WAME ao n8n
Agora você aponta o webhook da WAME para o n8n. O detalhe importante é usar o formato meta: é ele que entrega WhatsApp, Instagram e Messenger no envelope unificado que o template entende.
Pegue a URL do seu Webhook WAME no n8n (o path é wame-bot) e configure a instância com um PUT:
curl -X PUT "https://us.api-wa.me/YOUR_KEY/instance" \
-H "Content-Type: application/json" \
-d '{"allowWebhook":true,"allowNumber":"all","webhookFormat":"meta","webhookMessage":"https://SEU-N8N/webhook/wame-bot"}'
Troque YOUR_KEY pela chave da sua instância e https://SEU-N8N/webhook/wame-bot pela URL real do seu n8n.
A partir daí, toda mensagem recebida chega no seguinte formato. Entre os canais muda apenas o campo provider (aqui, whatsapp):
{
"object": "wame",
"provider": "whatsapp",
"instance": "YOUR_INSTANCE_ID",
"official": true,
"entry": [
{
"id": "YOUR_INSTANCE_ID",
"changes": [
{
"field": "messages",
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "5511999990000",
"phone_number_id": "YOUR_INSTANCE_ID"
},
"contacts": [
{ "profile": { "name": "Fulano" }, "wa_id": "5511988887777" }
],
"messages": [
{
"from": "5511988887777",
"id": "wamid.XXX",
"timestamp": "1700000000",
"type": "text",
"text": { "body": "Olá!" }
}
]
}
}
]
}
]
}
Como o formato é sempre o mesmo, o nó Extrair Mensagem funciona igual para os três canais — só o provider diferencia a origem. Para detalhes de payload e eventos, veja a documentação de webhooks.
6. Configurar credenciais
Duas credenciais precisam ser preenchidas depois do import:
- OpenAI — no nó Gerar Resposta, abra o modelo e selecione (ou crie) a credencial da OpenAI com a sua chave. Aqui você também escolhe o modelo e o system prompt.
- WAME — no nó Enviar Resposta (HTTP Request), confirme o server (
https://us.api-wa.me) e a chave da instância. Como o endpoint usa a instância vinda do envelope, garanta que a chave corresponde à que recebeu a mensagem.
Sem essas duas credenciais o fluxo não roda: a IA não gera resposta e a WAME não recebe o envio.
7. Testar nos 3 canais
Com o webhook configurado e o workflow ativo, faça o teste real:
- Envie uma mensagem de texto para o número/perfil da sua instância no WhatsApp. O bot deve responder em segundos.
- Repita pelo Instagram Direct e pelo Messenger. A resposta deve chegar pelo mesmo canal de onde partiu a mensagem.
- No n8n, acompanhe as execuções para conferir cada etapa: o envelope recebido, o texto extraído, a resposta da IA e o status do envio.
Se algo não responder, verifique primeiro se o workflow está ativo e se a URL do webhook no PUT bate exatamente com a do n8n.
8. Personalizar o bot
O template é um ponto de partida. Ajustes comuns:
- System prompt — no nó Gerar Resposta, defina o tom, o idioma e as regras do atendente (ex.: "Você é o assistente da Loja X, responde em pt-BR, é objetivo").
- Conhecimento do negócio — injete informações de produtos, horários e políticas no prompt, ou conecte uma base de conhecimento para respostas mais precisas.
- Encaminhar para humano — adicione uma condição: quando a IA não souber responder ou o cliente pedir atendimento humano, envie uma mensagem avisando e notifique seu time (e-mail, outro canal ou uma inbox de atendimento).
Como tudo vive em um único fluxo, essas mudanças valem automaticamente para os três canais.
9. Comece agora
Você tem um atendente de IA multicanal rodando com pouquíssima configuração: importa o template, conecta OpenAI e WAME, aponta o webhook e testa. Sem app na Meta, sem virar Tech Provider — a WAME cuida da parte oficial e não oficial, com mais de 50 mil instâncias em produção desde 2017.
- Conheça a landing completa: n8n Bot para WhatsApp, Instagram e Messenger.
- Baixe o template: bot-wame-whatsapp-instagram-messenger.json.
- Entenda os webhooks: documentação de webhooks.
- Crie ou gerencie sua instância: portal WAME.
Pronto para automatizar seu WhatsApp?
Crie sua conta gratuita e comece a enviar mensagens pela API em minutos.
Começar grátisPerguntas frequentes
Preciso criar um app na Meta ou virar Tech Provider para usar esse bot?+
Não. A WAME é Meta Business Partner desde 2017 e cuida da parte oficial (Cloud API) e não oficial (QR Code). Você usa a instância pronta, sem criar app na Meta nem virar Tech Provider. O n8n só recebe o webhook e responde pela API da WAME.
Um único fluxo do n8n atende os três canais?+
Sim. A WAME entrega WhatsApp, Instagram e Messenger no mesmo envelope no formato Meta, mudando apenas o campo provider. O fluxo lê esse campo, gera a resposta com IA e responde no canal de origem — tudo em um workflow só.
Qual modelo de IA o template usa?+
O nó Gerar Resposta é um AI Agent com um modelo da OpenAI (o mesmo motor do ChatGPT). Você conecta sua própria chave da OpenAI e pode escolher o modelo e o system prompt do seu negócio.
O bot lembra do histórico da conversa?+
Sim. O nó Memória por Contato usa um buffer window com a janela das últimas mensagens, separado por contato. Assim cada pessoa tem seu próprio contexto, sem misturar conversas.
Funciona no n8n Cloud e no self-hosted?+
Funciona nos dois. Basta que a URL do webhook do n8n seja acessível pela internet para a WAME conseguir entregar as mensagens. No self-hosted, garanta um domínio público com HTTPS.
Continue lendo
API de Instagram e Messenger na mesma API do WhatsApp: uma instância, um padrão
API de Instagram Direct e Messenger oficiais na mesma API do WhatsApp: uma instância, um padrão Meta, o campo provider escolhe o canal. Sem criar app na Meta.
API não oficial do WhatsApp: recursos que a oficial não tem (com exemplos)
Recursos da API não oficial do WhatsApp (QR Code): botões, listas, enquete, figurinha, reação, grupos, status e Pix — com exemplos em cURL e Node.js.
WAME API na prática: seu primeiro envio no WhatsApp, Instagram e Messenger em 10 minutos
Quickstart da WAME API: crie a instância, conecte e faça o primeiro envio no WhatsApp, Instagram e Messenger com SDK Node, PHP ou cURL em 10 minutos.