Se você quer enviar e receber mensagens de WhatsApp a partir de uma automação como o n8n mas não pode (ou não quer) usar a API oficial do WhatsApp Business, logo vai esbarrar nas APIs “não oficiais” de WhatsApp. São gateways que se conectam ao WhatsApp do mesmo jeito que o WhatsApp Web e expõem uma API HTTP simples que você pode chamar do n8n. Este guia cobre as oito opções mais populares de ponta a ponta: o que é cada uma, como configurar, o endpoint e o payload exatos para enviar uma mensagem, uma comparação lado a lado, e, crucialmente, os trade-offs que você deve entender antes de construir qualquer coisa.
O que “não oficial” realmente significa
O acesso oficial ao WhatsApp para empresas passa pela API do WhatsApp Business da Meta (a Cloud API), que exige verificação da empresa, usa modelos de mensagem pré-aprovados e cobra por conversa. As APIs não oficiais pulam tudo isso: rodam uma sessão de WhatsApp Web para um número normal (muitas se baseiam na biblioteca open-source Baileys ou em um navegador headless) e a envolvem em uma API REST.
Essa conveniência vem com uma ressalva real. Automatizar um número pessoal desse jeito não é sancionado pela Meta e pode violar os Termos de Serviço do WhatsApp. Números podem ser limitados ou banidos, na maioria das vezes quando usados para enviar mensagens em massa não solicitadas a pessoas que nunca deram opt-in. Trate as APIs não oficiais como ideais para projetos pessoais, ferramentas internas, notificações e conversa de mão dupla com quem espera notícias suas. Para alcance em conformidade e em grande escala, a API oficial via um provedor como a Wati é o caminho certo. E se você se qualifica para a API oficial mas prefere não auto-hospedar nada, ferramentas totalmente hospedadas como o Zapier ou o Make conectam o WhatsApp pela Cloud API oficial sem nenhum servidor para gerenciar. Veja nosso guia de automação para o quadro completo.
A receita que todo gateway segue
Depois de ver uma dessas APIs, você essencialmente viu todas. As diferenças estão na hospedagem, no preço e nos detalhes do payload, o fluxo é idêntico:
- Vincule um número. Você cria uma “instância”, “sessão” ou “canal” para um número de WhatsApp dedicado e escaneia um código QR em WhatsApp → Aparelhos conectados, exatamente como se estivesse entrando no WhatsApp Web.
- Obtenha uma credencial. O provedor lhe dá uma chave de API ou token que autentica cada requisição.
- Envie por HTTP. No n8n, um nó HTTP Request faz POST ao endpoint de envio do provedor com o destinatário e o texto. (Evolution API e Wassenger também oferecem nós dedicados de n8n se você prefere não montar requisições na mão.)
- Receba por webhook. Você aponta o webhook do provedor para um nó Webhook do n8n, de modo que cada mensagem recebida dispara um fluxo, a base de autoresponders e chatbots.
Os números dos destinatários vão sempre em formato internacional completo, só dígitos, o mesmo formato de um link click-to-chat. Alguns provedores envolvem o número em um ID de chat como 15551234567@c.us (individual) ou @g.us (grupo); as seções por provedor abaixo indicam quais.
Gateways auto-hospedados: Evolution API, WAHA, WPPConnect
Gateways auto-hospedados rodam no seu próprio servidor (com Docker é questão de um comando em qualquer VPS barato). Você não paga nada por mensagem nem assinatura (só o servidor) e seus dados de mensagens nunca passam por terceiros, o que importa se você lida com listas de contatos sensíveis. O preço é operá-los você mesmo: atualizações, backups e um ou outro re-escaneamento quando uma sessão cai.
Evolution API, o maior ecossistema n8n
A Evolution API é um gateway gratuito e open-source, e a escolha mais popular entre equipes técnicas. Ela envolve o Baileys para o protocolo do WhatsApp Web (e também pode fazer frente à Cloud API oficial), suporta múltiplas instâncias (cada uma ligada a um número) e tem tanto um nó comunitário dedicado (n8n-nodes-evolution-api) quanto um grande ecossistema de templates de n8n prontos.
Configuração: suba o contêiner Docker com uma chave de API global (por exemplo, a variável de ambiente AUTHENTICATION_API_KEY, o docker-compose do projeto mostra os nomes atuais), crie uma instância pela API ou pela interface do manager, então solicite o código QR da instância e escaneie. A documentação Swagger é servida na mesma porta para explorar os endpoints.
- Endpoint de envio: POST https://seu-servidor/message/sendText/sua-instancia
- Autenticação: apikey: sua-chave-de-api (cabeçalho)
- Corpo (JSON): { "number": "15551234567", "text": "Olá do n8n + Evolution API" }
WAHA, um contêiner, vários engines, ótimo com mídia
O WAHA (WhatsApp HTTP API) roda como uma única imagem Docker e organiza as conexões em sessões (a padrão se chama literalmente “default”). Seu diferencial é a escolha de engines, um engine WEBJS baseado em navegador e engines NOWEB/GOWS mais leves baseados em websocket, para equilibrar consumo de recursos e funcionalidades. O núcleo é gratuito para auto-hospedar; o WAHA Plus pago desbloqueia capacidades avançadas. É particularmente sólido com mídia (imagens, arquivos, notas de voz), o que combina com chatbots mais ricos.
Configuração: rode a imagem (API na porta 3000 por padrão, com documentação Swagger interativa), inicie uma sessão, busque o código QR dela e escaneie. Quando o status da sessão for “working”, você pode enviar. Se proteger a instância com uma chave de API, passe-a no cabeçalho que o WAHA espera (por exemplo, X-Api-Key).
- Endpoint de envio: POST http://seu-host-waha:3000/api/sendText
- Corpo (JSON): { "session": "default", "chatId": "[email protected]", "text": "Olá do n8n + WAHA" }
- Nota: o sufixo do chatId é @c.us para indivíduos e @g.us para grupos.
WPPConnect, open-source com token por sessão
O WPPConnect Server é o irmão comunitário dos outros dois: gratuito, open-source e auto-hospedado, geralmente na porta 21465 com documentação Swagger. Seu modelo de autenticação é um pouco diferente: você define uma SECRET_KEY no servidor, chama o endpoint de geração de token para cunhar um token Bearer para uma sessão nomeada, inicia a sessão e escaneia o QR dela. Ele expõe endpoints para mídia, arquivos, botões e grupos, além de texto puro.
- Endpoint de envio: POST http://seu-servidor:21465/api/sua-sessao/send-message
- Autenticação: Authorization: Bearer seu-token-de-sessao
- Corpo (JSON): { "phone": "14155550100", "message": "Olá do n8n + WPPConnect" }
Gateways em nuvem: Green API, UltraMsg, Wassenger, Whapi.cloud, Maytapi
Gateways em nuvem hospedam tudo para você: você se cadastra, vincula um número por QR e começa a chamar uma API, muitas vezes em menos de dez minutos, sem nada para manter. Em troca, você paga uma assinatura e seu tráfego passa pelos servidores do provedor. Os cinco abaixo seguem o mesmo padrão e diferem principalmente em preço, acabamento e um ou dois recursos de destaque.
Green API, o começo mais rápido, nível gratuito para desenvolvedores
A Green API dá a cada instância dois valores (um idInstance e um apiTokenInstance) que ficam embutidos diretamente na URL da requisição, então não há cabeçalhos para configurar. Tem um nível gratuito para testes, documentação clara e permite mensagens de texto bem longas. Mensagens recebidas chegam por webhook ou consultando a fila de notificações com ReceiveNotification; com o n8n, webhooks são a escolha mais limpa.
- Endpoint de envio: POST https://api.green-api.com/waInstance{idInstance}/sendMessage/{apiTokenInstance}
- Corpo (JSON): { "chatId": "[email protected]", "message": "Olá do n8n + Green API" }
UltraMsg, a opção mais simples e de baixo custo
O UltraMsg é o minimalista do grupo: você recebe um ID de instância (tipo instance12345) e um token, e envia mensagens com uma única requisição form-encoded, sem JSON, sem nó especial. Uma resposta de sucesso parece com { "sent": "true", "message": "ok", "id": 497 }. É uma escolha pragmática para notificações simples e chatbots pequenos onde custo e tempo de configuração importam mais.
- Endpoint de envio: POST https://api.ultramsg.com/instance12345/messages/chat
- Corpo (Form-Urlencoded): token = seu-token, to = 15551234567, body = Olá do n8n + UltraMsg
Wassenger, recursos de negócio e nó nativo de n8n
O Wassenger mira usuários de negócios: adiciona uma caixa de entrada compartilhada por cima da API e, notavelmente, traz uma integração nativa com o n8n, então você pode soltar um nó Wassenger em vez de configurar requisições HTTP. Você conecta um aparelho por QR, cria uma chave de API e a passa em um cabeçalho Token. Além de texto, envia mídia, documentos, localizações, enquetes e botões, e escreve para grupos.
- Endpoint de envio: POST https://api.wassenger.com/v1/messages
- Autenticação: Token: sua-chave-de-api (cabeçalho)
- Corpo (JSON): { "phone": "+14155550100", "message": "Olá do n8n + Wassenger" }
Whapi.cloud, REST limpo com tokens por canal
O Whapi.cloud trata cada número conectado como um “canal” com seu próprio token Bearer, um modelo organizado se você opera vários números para fins diferentes. Os endpoints REST são limpos e bem documentados, há um nível gratuito para protótipos, e o campo to aceita IDs de grupos e canais além de números individuais (só dígitos, sem sinal de mais).
- Endpoint de envio: POST https://gate.whapi.cloud/messages/text
- Autenticação: Authorization: Bearer seu-token-de-canal
- Corpo (JSON): { "to": "14155550100", "body": "Olá do n8n + Whapi.cloud" }
Maytapi, feita para gerenciar vários números
O destaque da Maytapi é o suporte a múltiplos telefones: uma conta (um “produto”) pode conter várias instâncias de telefone, cada uma endereçada pelo próprio phone ID na URL. Você se autentica com um token no cabeçalho x-maytapi-key, e o mesmo endpoint envia mídia, localizações e contatos mudando o campo type. Webhooks são configurados uma vez por produto.
- Endpoint de envio: POST https://api.maytapi.com/api/seu-product-id/seu-phone-id/sendMessage
- Autenticação: x-maytapi-key: seu-token (cabeçalho)
- Corpo (JSON): { "to_number": "14155550100", "type": "text", "message": "Olá do n8n + Maytapi" }
Tabela comparativa
As oito lado a lado. “Auto-hospedado” significa que você o roda (tipicamente com Docker) e paga só pelo servidor; “nuvem” significa que o provedor hospeda e você paga a ele. Não citamos preços fixos, sempre confira a tabela atual do provedor.
| Provedor | Hospedagem | n8n | Modelo de custo | Destaque |
|---|---|---|---|---|
| Evolution API | Auto-hospedado (Docker) | Nó comunitário + HTTP | Grátis para auto-hospedar | Maior ecossistema n8n; envolve o Baileys |
| WAHA | Auto-hospedado (Docker) | HTTP | Núcleo grátis + Plus pago | Vários engines, ótimo com mídia |
| WPPConnect | Auto-hospedado (Docker) | HTTP | Grátis para auto-hospedar | Open-source, controle total dos dados |
| Green API | Nuvem | HTTP | Nível grátis + pago | Começo rápido, boa documentação |
| UltraMsg | Nuvem | HTTP | Pago de baixo custo | Configuração mais simples |
| Wassenger | Nuvem | Nó nativo + HTTP | Pago | Caixa de equipe, nó nativo n8n |
| Whapi.cloud | Nuvem | HTTP | Nível grátis + pago | REST limpo, tokens por canal |
| Maytapi | Nuvem | HTTP | Pago | Suporte a múltiplos telefones |
Cola de endpoints
Para consulta rápida quando você estiver configurando o nó HTTP Request do n8n, a chamada de envio de texto de cada provedor, condensada:
| Provedor | Endpoint de envio (POST) | Autenticação | Campo do destinatário |
|---|---|---|---|
| Evolution API | /message/sendText/{instancia} | cabeçalho apikey | number (só dígitos) |
| WAHA | /api/sendText | cabeçalho X-Api-Key (se ativado) | chatId (…@c.us) |
| WPPConnect | /api/{sessao}/send-message | token Bearer | phone (só dígitos) |
| Green API | /waInstance{id}/sendMessage/{token} | na URL | chatId (…@c.us) |
| UltraMsg | /{instancia}/messages/chat | campo token do formulário | to (só dígitos) |
| Wassenger | /v1/messages | cabeçalho Token | phone (com prefixo +) |
| Whapi.cloud | /messages/text | token Bearer | to (só dígitos) |
| Maytapi | /api/{produto}/{telefone}/sendMessage | cabeçalho x-maytapi-key | to_number (só dígitos) |
Qual você deve escolher?
- Quer controle total e zero custo por mensagem, e pode operar um servidor? Auto-hospede Evolution API, WAHA ou WPPConnect.
- Quer zero infraestrutura e o começo mais rápido? Use um gateway em nuvem, Green API, UltraMsg, Whapi.cloud, Wassenger ou Maytapi.
- Quer um nó n8n de primeira em vez de HTTP puro? Evolution API (nó comunitário) ou Wassenger (integração nativa).
- Precisa gerenciar vários números de WhatsApp? A Maytapi foi feita para isso.
- Precisa do maior ecossistema de templates/comunidade n8n? Evolution API.
- Precisa de mensagens em conformidade e com opt-in em escala real? Suba para a API oficial com a Wati em vez de um gateway não oficial.
Recebendo mensagens e construindo um chatbot
Enviar é só metade da história. Todo provedor acima pode entregar as mensagens recebidas a uma URL que você escolher, aponte esse webhook para um nó Webhook do n8n e cada mensagem de WhatsApp recebida vira o gatilho de um fluxo. O padrão clássico de mão dupla é: mensagem recebida → procurar o remetente nos seus dados (uma planilha, um CRM, um banco de dados) → opcionalmente rodar uma etapa de IA para rascunhar a resposta → devolver a resposta pelo mesmo endpoint de envio. Isso é um autoresponder ou chatbot completo, construído inteiramente com nós do n8n. Construções comuns: um respondedor de FAQ que passa a um humano quando está em dúvida, notificações de pedidos ou consultas disparadas de uma planilha, e assistentes de IA que até transcrevem notas de voz recebidas (o tratamento de mídia do WAHA é particularmente bom para isso).
Fique seguro, seja qual for a escolha
- Use um número dedicado que você esteja disposto a perder, não sua linha pessoal principal.
- Aqueça o número, comece devagar e envie só a pessoas que esperam por você.
- Nunca dispare a frio mensagens em massa não solicitadas; é o caminho mais rápido para o banimento.
- Respeite os descadastramentos, mantenha volumes razoáveis e adicione atrasos com cara humana entre as mensagens.
Perguntas frequentes
As APIs não oficiais de WhatsApp são legais?
Elas são amplamente usadas, mas automatizar um número pessoal de WhatsApp desse jeito pode violar os Termos de Serviço do WhatsApp, e a Meta pode banir números, especialmente por mensagens em massa não solicitadas. Use-as para projetos pessoais e conversa de mão dupla com opt-in, e use a API oficial para marketing em grande escala.
Preciso programar para usá-las com o n8n?
Na prática, não. No n8n você chama qualquer uma delas com o nó HTTP Request, e Evolution API e Wassenger têm até nós dedicados. Você configura o endpoint e o token, sem programação tradicional.
Qual é a melhor para iniciantes?
Se você não quer operar um servidor, uma opção em nuvem como Green API ou UltraMsg é a mais rápida. Se você se vira com Docker e quer zero tarifas por mensagem, Evolution API ou WAHA dão mais controle.
O que é o formato de ID de chat @c.us que alguns provedores usam?
É o número do destinatário em formato internacional completo (só dígitos) seguido de @c.us para um chat individual (ex.: [email protected]) ou @g.us para um grupo. WAHA e Green API o usam; os demais aceitam um campo de número simples.
As opções auto-hospedadas são mesmo gratuitas?
Sim, Evolution API e WPPConnect são open-source e gratuitas para auto-hospedar, e o WAHA tem um núcleo gratuito (mais um nível Plus pago). Seus únicos custos são o servidor em que rodam e, se usar, um plano do n8n. Não há tarifas por mensagem porque elas usam uma sessão de WhatsApp Web em vez da API oficial paga.
Elas podem banir meu número?
Qualquer uma pode, se você enviar mensagens em massa não solicitadas, o gateway não importa, o comportamento sim. Use um número dedicado, envie só a quem espera por você, mantenha volumes modestos e considere a API oficial para campanhas grandes.
