Como conectar o WhatsApp no n8n, passo a passo
Conecte o número na API de WhatsApp da Certu pelo QR code, cole a URL do nó Webhook do n8n como destino das mensagens recebidas e responda com um nó HTTP Request usando a sua chave. Funciona sem a API oficial da Meta. Custa R$ 48,50 por mês por número, com 3 dias grátis sem cartão.
Guia da Equipe Certu, atualizado em 17/11/2026. Leva uns 15 minutos.
Quais são os 7 fatos principais?
- Conecte o número na API de WhatsApp da Certu pelo QR code, cole a URL do nó Webhook do n8n como destino das mensagens recebidas e responda com um nó HTTP Request usando a sua chave.
- Custa R$ 48,50 por mês por número, com 3 dias grátis sem cartão.
- Um n8n rodando (n8n Cloud ou o seu servidor) com URL pública em https.
- Crie a instância no painel e leia o QR code com o celular, em Aparelhos conectados › Conectar aparelho.
- Quando aparecer "Conectada", anote o id da instância (começa com inst_) e crie uma chave de API na mesma tela.
- Abra um workflow novo e adicione o nó Webhook.
- HTTP Method: POST Path: algo como whatsapp Respond: Immediately (o servidor da Certu espera resposta em até 10 segundos) Copie a Production URL do nó.
Quais são os números principais?
| Número | O que significa |
|---|---|
| 10 segundos | HTTP Method: POST Path: algo como whatsapp Respond: Immediately (o servidor da Certu espera resposta em até 10 segundos) Copie a Production URL do nó. |
| R$ 48,50 | A conexão do WhatsApp pela Certu custa R$ 48,50 por número por mês, sem cobrança por mensagem. |
Antes de começar
Tenha à mão três coisas.
- Um n8n rodando (n8n Cloud ou o seu servidor) com URL pública em
https. - Uma conta no painel da API de WhatsApp.
- O celular com o WhatsApp do número que vai atender.
1. Conecte o número
Crie a instância no painel e leia o QR code com o celular, em Aparelhos conectados › Conectar aparelho. Quando aparecer "Conectada", anote o id da instância (começa com inst_) e crie uma chave de API na mesma tela.
2. Crie o nó Webhook no n8n
Abra um workflow novo e adicione o nó Webhook.
- HTTP Method:
POST - Path: algo como
whatsapp - Respond: Immediately (o servidor da Certu espera resposta em até 10 segundos)
Copie a Production URL do nó. Ela termina em /webhook/whatsapp.
3. Cole a URL no webhook "Ao receber"
Volte ao painel, clique em Webhooks na instância e cole a URL do n8n no campo Ao receber. Clique em Testar: o painel manda um evento de exemplo e mostra o código que o n8n respondeu. Com o workflow em modo de teste, o evento aparece no n8n assim:
{
"event": "message.received",
"instance_id": "inst_8f2a0c1d9e",
"created_at": "2026-11-17T14:10:02Z",
"data": {
"id": "3EB0C8A1F2",
"from": "5548999990000",
"from_me": false,
"name": "Ana",
"is_group": false,
"type": "text",
"text": "Oi, meu pedido já saiu?"
}
}
No n8n, o texto da mensagem fica em {{ $json.body.data.text }} e o número de quem escreveu em {{ $json.body.data.from }}.
4. Responda com um nó HTTP Request
Ligue um nó HTTP Request depois do Webhook (ou depois do seu nó de IA, se quiser que uma IA escreva a resposta).
- Method:
POST - URL:
https://certu.com.br/api/v1/instances/inst_SEU_ID/messages/text - Header:
Authorization=Bearer certu_sk_SUA_CHAVE - Body (JSON):
{
"to": "{{ $json.body.data.from }}",
"text": "Recebemos a sua mensagem: {{ $json.body.data.text }}"
}
Guarde a chave numa credencial do n8n (Header Auth) em vez de colar direto no nó.
5. Ative e teste
Ative o workflow e mande uma mensagem de outro celular pro número conectado. A resposta chega em segundos. Se não chegar, confira no n8n a aba Executions e, no painel, se a instância está "Conectada".
Dicas que evitam dor de cabeça
Siga estes cuidados antes de pôr em produção.
- Não responda a si mesmo: deixe desligada a opção de receber as mensagens enviadas pelo próprio número, ou filtre
from_meno n8n. - Grupos: marque "Ignorar mensagens de grupos" nos filtros se o fluxo só atende conversa privada.
- Segurança: confira o cabeçalho
Iz-Signaturenum nó Code, com o segredo da instância (veja a documentação). - Sem disparo frio: o WhatsApp pode banir o número que manda mensagem em massa pra quem não pediu.
Perguntas frequentes
Leia as dúvidas mais comuns de quem liga o WhatsApp no n8n.
Precisa da API oficial do WhatsApp pra usar o n8n?
Não. Com a API da Certu o número conecta pelo QR code, sem aprovação da Meta. Para disparo em massa, o caminho seguro é a API oficial.
Quanto custa?
O n8n tem plano gratuito quando você hospeda. A conexão do WhatsApp pela Certu custa R$ 48,50 por número por mês, sem cobrança por mensagem. Veja a comparação de preços.
Funciona com Make e Typebot?
Funciona do mesmo jeito: qualquer ferramenta que recebe webhook e faz requisição HTTP serve.