Integrar no n8n
Passo a passo para enviar e receber mensagens da WhatsApp API da Rollin Host no n8n usando o nó HTTP Request e o nó Webhook — mesmo sem nó oficial.
Não existe um “nó oficial” da WhatsApp API no n8n — mas você não precisa dele. Tudo funciona com o nó HTTP Request (para enviar) e o nó Webhook (para receber). Este guia mostra exatamente onde clicar.
Parte 1 — Enviar mensagem (nó HTTP Request)
Passo 1 — guardar o token com segurança (credencial)
Pra não colar o token em todo nó, crie uma credencial uma vez só:
-
No n8n, vá em Credentials → Add credential.
-
Procure e escolha Header Auth.
-
Preencha:
- Name:
token - Value: seu token do painel
- Name:
-
Salve com um nome fácil, ex.: “WhatsApp API Rollin”.
Passo 2 — montar o nó HTTP Request
-
Adicione um nó HTTP Request.
-
Configure:
- Method:
POST - URL:
https://rollin.uazapi.com/send/text - Authentication:
Generic Credential Type→Header Auth→ escolha “WhatsApp API Rollin” - Send Body: ligado (ON)
- Body Content Type:
JSON
- Method:
-
Em Body (JSON), cole:
{
"number": "5511999999999",
"text": "Olá! Mensagem enviada pelo n8n 🚀"
}- Clique em Test step. Se a mensagem chegar no celular, está funcionando. ✅
Passo 3 — usar dados dinâmicos
Para o número e o texto virem de passos anteriores (planilha, formulário, mensagem recebida), troque os valores fixos por expressões do n8n. Exemplo no Body:
{
"number": "{{ $json.telefone }}",
"text": "Olá {{ $json.nome }}, recebemos seu pedido!"
}
Enviar imagem, áudio, botões… no n8n
É o mesmo nó HTTP Request — muda só a URL e o Body. Veja todos os formatos em Enviar mensagens. Exemplos rápidos:
- URL:
https://rollin.uazapi.com/send/media - Body:
{
"number": "5511999999999",
"type": "image",
"file": "https://exemplo.com/foto.jpg",
"text": "Olha a novidade!"
} - URL:
https://rollin.uazapi.com/send/menu - Body:
{
"number": "5511999999999",
"type": "button",
"text": "Como posso ajudar?",
"choices": ["Suporte|suporte", "Vendas|vendas"]
} - URL:
https://rollin.uazapi.com/send/media - Body:
{
"number": "5511999999999",
"type": "ptt",
"file": "https://exemplo.com/audio.ogg"
} Parte 2 — Receber mensagem (nó Webhook)
Passo 1 — criar o Webhook no n8n
-
Adicione um nó Webhook (início do fluxo).
-
Configure:
- HTTP Method:
POST - Path: algo secreto, ex.:
whats-rollin-8f3a
- HTTP Method:
-
Copie a Test URL (botão no topo do nó).
Passo 2 — ligar no painel da Rollin
-
No painel: WhatsApp API → Gerenciar → seção Webhook.
-
Marque Habilitar webhook, cole a URL do n8n e clique em Salvar webhook.
Passo 3 — capturar o formato real
-
No nó Webhook do n8n, clique em Listen for test event.
-
Mande uma mensagem para o seu número conectado (de outro celular).
-
O n8n mostra o JSON que chegou — agora você pode puxar
text,sender,messageidnos próximos nós.
Fluxo completo: auto-resposta
Um robô que responde automaticamente fica assim:
[Webhook recebe mensagem] ──▶ [IF / lógica] ──▶ [HTTP Request envia resposta]
No HTTP Request de resposta, use o remetente que chegou no webhook:
{
"number": "{{ $json.body.sender }}",
"text": "Recebi sua mensagem! Já te respondo. 🙌"
}
Problemas comuns
| Sintoma | Causa | Solução |
|---|---|---|
401 Unauthorized | token errado | confira a credencial Header Auth (token) |
400 no envio | número ou JSON errado | número 5511… sem +; valide o JSON |
| Webhook não dispara | fluxo não está “ouvindo” | clique em Listen for test event antes de mandar a mensagem |
| Funciona no teste, para depois | usou Test URL e não ativou | use Production URL + Active ligado |
| Robô responde a si mesmo | filtro anti-loop desligado | mantenha o padrão (ignora mensagens da própria API) |
Próximos passos
Última atualização: