# 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](https://api-wa.me/n8n/bot-wame-whatsapp-instagram-messenger.json), conecta duas credenciais e testa. Este guia é o complemento editorial da landing [n8n Bot para WhatsApp, Instagram e Messenger](/n8n-bot-whatsapp-instagram-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 `provider` diz 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: 1. **Uma instância WAME** ativa. Crie ou pegue sua chave no [portal](https://portal.api-wa.me/). Serve tanto para a conexão oficial (Cloud API) quanto para a não oficial (QR Code). 2. **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. 3. **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`: ```text 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: ```text Webhook WAME → Extrair Mensagem → Gerar Resposta (IA) → Memória por Contato → Enviar Resposta ``` 1. **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 como `https://SEU-N8N/webhook/wame-bot`. O campo `provider` do envelope indica se a mensagem veio do WhatsApp, do Instagram ou do Messenger. 2. **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. 3. **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. 4. **Memória por Contato** — um buffer window ligado ao AI Agent. Guarda a janela das últimas mensagens separada por contato, dando continuidade à conversa. 5. **Enviar Resposta** — um HTTP Request que faz `POST` para o endpoint de texto da WAME, mandando a resposta de volta pelo canal de origem: ```text 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`: ```bash 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`): ```json { "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](/docs/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: 1. Envie uma mensagem de texto para o número/perfil da sua instância no **WhatsApp**. O bot deve responder em segundos. 2. Repita pelo **Instagram Direct** e pelo **Messenger**. A resposta deve chegar pelo mesmo canal de onde partiu a mensagem. 3. 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](/n8n-bot-whatsapp-instagram-messenger). - Baixe o template: [bot-wame-whatsapp-instagram-messenger.json](https://api-wa.me/n8n/bot-wame-whatsapp-instagram-messenger.json). - Entenda os webhooks: [documentação de webhooks](/docs/webhooks). - Crie ou gerencie sua instância: [portal WAME](https://portal.api-wa.me/). ## Perguntas 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.