Conecte a API oficial do WhatsApp ao n8n

O n8n oferece dois componentes para a API oficial do WhatsApp: WhatsApp Business Cloud executa ações de envio e mídia. O WhatsApp Trigger inicia workflows quando recebe eventos. Os dois usam recursos configurados em um aplicativo da Meta, com métodos de autenticação diferentes.

Prepare os recursos da Meta

A documentação exige acesso de desenvolvedor Meta, um portfólio empresarial e um aplicativo empresarial configurado com WhatsApp. A credencial para WhatsApp Business Cloud usa Access Token e Business Account ID.

No painel da Meta, abra o aplicativo e acesse WhatsApp > API Setup para obter esses valores. Copie o identificador empresarial correto. O identificador do telefone é outro recurso e não substitui esse campo.

Para WhatsApp Trigger, a credencial usa OAuth2 com Client ID e Client Secret. A documentação orienta obter os valores em App settings > Basic no mesmo aplicativo Meta.

Envie mensagens e arquivos

No Node WhatsApp Business Cloud, selecione a credencial e a ação desejada. O recurso de mensagens oferece Send, Send Template e envio com espera por resposta. O recurso de mídia permite upload, download e exclusão.

Use um destinatário autorizado para o teste e confira os parâmetros exigidos pela ação escolhida. A configuração das credenciais não substitui as etapas de verificação e lançamento do aplicativo exigidas pela Meta. Consulte a documentação vinculada pelo n8n antes de ampliar o uso.

Receba mensagens pelo trigger

Adicione WhatsApp Trigger, configure OAuth2 e selecione o evento Messages. Publique o workflow para receber eventos pela URL de produção.

O WhatsApp permite registrar um único webhook por aplicativo. Alternar entre a URL de teste e a de produção substitui o endereço registrado. Durante uma conferência, observe qual URL está ativa antes de concluir que o trigger falhou.

A documentação também alerta que registrar a URL não inscreve automaticamente o aplicativo no recurso empresarial WABA. Se testes do painel Meta chegam, mas mensagens do telefone não iniciam execuções, confira essa assinatura pelo procedimento oficial do trigger.

API oficial e outras integrações

Os componentes descritos usam a WhatsApp Business Platform Cloud API, conforme a documentação oficial do n8n. Um pacote comunitário ou serviço intermediário exige conferência própria de autenticação, API utilizada e suporte. O nome WhatsApp no componente não comprova que ele usa a mesma conexão oficial.