Criar um assistente de IA no WhatsApp (voz + texto) com o n8n
· Por AI Compare
Texto, mensagens de voz e imagens no WhatsApp, respondidos por um agente de IA do n8n, mais a configuração da Meta de que precisa.
O que vai criar
A versão WhatsApp de um assistente pessoal de IA: envie texto, mensagens de voz ou imagens para um número de WhatsApp e um agente de IA do n8n responde. As mensagens de voz são transcritas, as imagens podem ser descritas e o agente pode usar ferramentas como o seu calendário ou os seus documentos.
Baseia-se no padrão usado em modelos do n8n como «WhatsApp AI agent that understands text, image and audio».
O WhatsApp é mais difícil do que o Telegram
O Telegram dá-lhe um bot num minuto. O WhatsApp exige a WhatsApp Business Cloud API da Meta:
- Uma conta de programador da Meta e uma app da Meta com o produto WhatsApp adicionado.
- Um número de telefone registado na WhatsApp Business Platform (a Meta fornece um número de teste gratuito para desenvolvimento).
- Um token de acesso permanente (token de System User nas Meta Business Settings), o Phone Number ID e o WhatsApp Business Account ID.
- Um webhook a apontar para o n8n.
Alguns modelos usam fornecedores como a Twilio ou a 360dialog em vez da Meta diretamente; simplificam a configuração, mas acrescentam uma mensalidade por número.
Um limite importante
O WhatsApp permite um webhook por app da Meta. No n8n, isso significa que não pode estar à escuta com um webhook de teste e um de produção ao mesmo tempo. Desative o workflow de produção enquanto testa, ou use apps da Meta separadas para teste e produção.
Estrutura do workflow
| # | Nó | Função |
|---|---|---|
| 1 | WhatsApp Trigger (event: messages) | Recebe as mensagens recebidas |
| 2 | IF: é uma mensagem (não uma atualização de estado) | Ignorar os eventos «enviada/entregue/lida» |
| 3 | Switch: tipo de mensagem | texto, áudio, imagem |
| 4 | WhatsApp: Get media URL + download com HTTP Request | Obtém a mensagem de voz ou a imagem em binário |
| 5 | OpenAI: Transcribe (ramo de áudio) | De voz para texto |
| 6 | OpenAI: Analyze image (ramo de imagem) | Descrever a imagem ou ler o texto que contém |
| 7 | Edit Fields (Set) | Juntar tudo num campo prompt |
| 8 | AI Agent + modelo de chat + memória | Memória associada ao número do remetente |
| 9 | WhatsApp: Send message | Responder ao remetente |
Regras a cumprir
- Janela de 24 horas: pode responder livremente nas 24 horas seguintes à última mensagem do utilizador. Fora dessa janela, o WhatsApp só permite modelos de mensagem pré-aprovados.
- Consentimento: envie mensagens apenas a quem o contactou ou aceitou receber mensagens.
- Custos: a Meta cobra por conversa ou mensagem, consoante a categoria e o país; consulte os preços atuais da Meta.
Uso pessoal ou empresarial
Para um assistente pessoal, limite o workflow ao seu próprio número com um nó IF. Para um bot destinado a clientes, veja Agente de apoio ao cliente com IA no WhatsApp.
Artigos relacionados
- Assistente de IA no Telegram com o n8n (configuração mais simples)
- Ligar credenciais no n8n
