WhatsApp API oficial no seu n8n
Sem gambiarra de WhatsApp Web e sem montar a conta da Meta do zero: o Picchat entrega a API oficial pronta, e o n8n chama por HTTP. Mande mensagens e templates, receba eventos por webhook ou só jogue o contato numa automação que já está pronta no painel.
— [ como funciona ]
Dois jeitos de usar o WhatsApp no n8n
Muito fluxo de n8n com WhatsApp usa API não oficial, que pilota o WhatsApp Web e pode ter o número bloqueado. Com o Picchat, o número fica na API oficial da Meta e o n8n conversa com ele por chamadas HTTP comuns — não precisa de node especial.
Jeito 1, para quem usa a plataforma do Picchat: o n8n cria ou atualiza o contato e inscreve numa automação que você montou no painel. A automação cuida do template, do intervalo entre envios e do horário; as respostas caem na caixa de entrada da equipe ou num agente de IA.
Jeito 2, para desenvolvedores (conta Infra): o n8n manda mensagens e templates direto pela API, no formato da Cloud API da Meta, e recebe as mensagens e os status de entrega num node Webhook, com assinatura HMAC para conferir que o evento veio do Picchat.
— [ o que dá para fazer ]
Fluxos comuns no n8n
Lead do formulário no WhatsApp
Formulário, planilha ou CRM dispara o fluxo, o n8n inscreve o contato na automação de boas-vindas e a equipe atende quem responder.
Agente de IA no n8n
Na conta Infra, o node Webhook recebe a mensagem, o seu agente (OpenAI, Claude ou outro) decide a resposta e o HTTP Request manda pelo número oficial.
Aviso de pedido e cobrança
O sistema avisa o n8n que o pedido mudou de status, e o template de Utility sai na hora pelo WhatsApp.
Status de entrega de volta no seu sistema
Eventos de entregue, lido e falhou chegam por webhook e o n8n atualiza o CRM ou a planilha.
Relatórios
Os endpoints de leitura (tíquetes, contatos, campanhas, automações) alimentam planilhas e painéis pelo n8n.
Entregas que não se perdem
Se o seu n8n estiver fora do ar, o Picchat tenta de novo até 7 vezes em 24 horas, e dá para reenviar uma entrega pela API.
— [ passo a passo ]
Do zero ao primeiro fluxo
- 1
Crie a conta e conecte o número
Pelo cadastro oficial da Meta, dentro do Picchat. Para desenvolvedor, a conta Grátis da API não tem mensalidade.
- 2
Gere o token
Em Configurações → Integrações, crie um aplicativo e copie o token.
- 3
Monte o node HTTP Request
Método POST, URL do endpoint, header Authorization: Bearer com o token e o corpo em JSON.
- 4
Receba os eventos (Infra)
Crie um node Webhook no n8n e cadastre a URL dele como endpoint de webhook no Picchat.
— [ exemplos ]
As chamadas que o n8n faz
Configure um node HTTP Request com o método, a URL e o header Authorization com o seu token. O corpo vai em JSON.
POST https://api.picchat.com.br/automations/enrollments
Authorization: Bearer SEU_TOKEN
Content-Type: application/json
{
"automation_id": "ID_DA_AUTOMACAO",
"contacts": [
{ "mobilephone": "5511999999999", "first_name": "Ana" }
]
}POST https://api.picchat.com.br/infra/messages
Authorization: Bearer SEU_TOKEN
Content-Type: application/json
{
"channel_id": "ID_DO_CANAL",
"message": {
"to": "5511999999999",
"type": "template",
"template": {
"name": "confirmacao_pedido",
"language": { "code": "pt_BR" },
"components": [{ "type": "body", "parameters": [{ "type": "text", "text": "1234" }] }]
}
}
}Eventos: message.received · message.status · message.echo · template.status_update
Headers de cada entrega:
X-Picchat-Event: message.received
X-Picchat-Delivery: <id para deduplicar>
X-Picchat-Signature: sha256=<HMAC-SHA256 do corpo com o secret do endpoint>Perguntas frequentes
Existe um node do Picchat no n8n?
Não. A integração usa os nodes nativos HTTP Request e Webhook do n8n, chamando a API REST do Picchat. Nada extra para instalar.
É API oficial do WhatsApp?
É. O número fica na API oficial da Meta (Cloud API), com templates aprovados. Sem WhatsApp Web e sem celular ligado.
Qual a diferença entre a conta da plataforma e a conta Infra?
Na plataforma, o n8n inscreve contatos em automações e lê os dados da conta, e a equipe atende no painel. Na conta Infra, feita para desenvolvedores, o n8n também envia mensagens e templates direto e recebe os eventos por webhook.
Quanto custa usar o WhatsApp no n8n com o Picchat?
Para desenvolvedores, há plano sem mensalidade a R$ 0,04 por disparo, com 1.000 créditos de teste. A plataforma completa começa em R$ 125 por mês. A tarifa da Meta é cobrada à parte nos dois.
Como confiro que o webhook veio mesmo do Picchat?
Cada entrega traz o header X-Picchat-Signature com o HMAC-SHA256 do corpo, calculado com o secret do endpoint. Calcule o mesmo HMAC no n8n e compare.
Funciona com Make e Zapier?
Funciona do mesmo jeito: qualquer ferramenta que faça chamadas HTTP com header de autorização e receba webhooks conversa com a API do Picchat.
Para aprofundar
Ponha o WhatsApp oficial no seu n8n hoje
Crie a conta, conecte o número e faça a primeira chamada em minutos.