Migração 100% grátis + 1 mês grátis com cupom MIGRAR1MES · novos clientes em planos até R$ 200/mês Migrar agora

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ó:

  1. No n8n, vá em Credentials → Add credential.

  2. Procure e escolha Header Auth.

  3. Preencha:

    • Name: token
    • Value: seu token do painel
  4. Salve com um nome fácil, ex.: “WhatsApp API Rollin”.

Passo 2 — montar o nó HTTP Request

  1. Adicione um nó HTTP Request.

  2. Configure:

    • Method: POST
    • URL: https://rollin.uazapi.com/send/text
    • Authentication: Generic Credential TypeHeader Auth → escolha “WhatsApp API Rollin”
    • Send Body: ligado (ON)
    • Body Content Type: JSON
  3. Em Body (JSON), cole:

{
  "number": "5511999999999",
  "text": "Olá! Mensagem enviada pelo n8n 🚀"
}
  1. 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:

Parte 2 — Receber mensagem (nó Webhook)

Passo 1 — criar o Webhook no n8n

  1. Adicione um nó Webhook (início do fluxo).

  2. Configure:

    • HTTP Method: POST
    • Path: algo secreto, ex.: whats-rollin-8f3a
  3. Copie a Test URL (botão no topo do nó).

Passo 2 — ligar no painel da Rollin

  1. No painel: WhatsApp API → Gerenciar → seção Webhook.

  2. Marque Habilitar webhook, cole a URL do n8n e clique em Salvar webhook.

Passo 3 — capturar o formato real

  1. No nó Webhook do n8n, clique em Listen for test event.

  2. Mande uma mensagem para o seu número conectado (de outro celular).

  3. O n8n mostra o JSON que chegou — agora você pode puxar text, sender, messageid nos 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

SintomaCausaSolução
401 Unauthorizedtoken erradoconfira a credencial Header Auth (token)
400 no envionúmero ou JSON erradonúmero 5511… sem +; valide o JSON
Webhook não disparafluxo não está “ouvindo”clique em Listen for test event antes de mandar a mensagem
Funciona no teste, para depoisusou Test URL e não ativouuse Production URL + Active ligado
Robô responde a si mesmofiltro anti-loop desligadomantenha o padrão (ignora mensagens da própria API)

Próximos passos

Última atualização: