A estrutura da API do WhatsApp fica mais clara quando você separa o número usado pelo cliente, a conta que representa esse número e a conta usada para modelos de mensagem e cobrança. Na estrutura descrita pela Meta, a conta do WhatsApp reúne a identidade do número comercial, enquanto a conta de mensagens reúne modelos e dados de cobrança. O identificador conhecido como WABA ID não deve ser tratado, sem conferência, como o identificador do número que aparece para o cliente.
Este guia é para a empresa brasileira que precisa conferir uma integração existente ou preparar a conexão de um número à API oficial. Ele não substitui um inventário dos contatos divulgados: aquele registro responde quem administra cada canal; o mapa abaixo responde qual recurso técnico a integração está usando. O método é comparar a documentação atual da Meta com os campos e permissões da configuração real. Se o painel da sua conta apresentar nomes antigos, confira os identificadores antes de alterar um fluxo.
Separe as peças da integração
Comece pelo que o cliente vê: um número comercial associado à conversa. Depois identifique a conta do WhatsApp que representa essa presença, a conta de mensagens associada aos modelos e à cobrança e o aplicativo usado pela integração. Um número público, um ID de número e um ID de conta têm funções diferentes; copiar o valor de um campo para outro porque ambos aparecem no mesmo painel é uma fonte evitável de erro.
Um número comercial corresponde a uma conta do WhatsApp, e contas podem ser agrupadas para administração. Esse agrupamento não significa que as conversas de números distintos se tornem uma conversa única. Para uma empresa com canais de vendas e suporte, a consequência prática é manter a correspondência de cada linha separada, mesmo quando uma equipe ou um parceiro administra vários canais.
| Peça | Pergunta operacional | O que conferir no cadastro técnico |
|---|---|---|
| Número comercial | Qual contato o cliente usa? | Número exibido, finalidade e ID técnico do número. |
| Conta do WhatsApp | Qual presença empresarial contém essa linha? | Vínculo com o número e acesso concedido a parceiros. |
| Conta de mensagens | Onde ficam os modelos e a cobrança? | Conta selecionada pela integração e acesso autorizado. |
| Aplicativo de integração | Qual sistema faz a solicitação? | Permissões, ambiente e responsável pela manutenção. |
A tabela é um mapa editorial de conferência, não uma tela reproduzida da Meta. Não coloque tokens de acesso, códigos de verificação ou dados de clientes nesse documento compartilhado. Registre apenas a correspondência entre recursos e o responsável autorizado a verificar cada um no painel apropriado.
Entenda o WABA ID
O nome WABA continua aparecendo em integrações e documentação anterior à separação das contas. Isso torna arriscado deduzir sua função apenas pela sigla. Segundo a documentação atual da Meta, o WABA ID existente identifica a conta de mensagens e conserva seu valor e o nome do campo. Portanto, antes de concluir que uma integração aponta para a linha errada, veja qual recurso o campo realmente representa e qual ID a operação espera.
O cuidado vale especialmente quando a empresa trabalha com um parceiro de atendimento e outro sistema próprio. A conta ligada à presença comercial não substitui automaticamente a conta que guarda modelos e cobrança. A documentação da Meta descreve o compartilhamento desses acessos separadamente; a equipe deve confirmar quais recursos cada parceiro recebeu, sem tomar a simples presença do nome do fornecedor no painel como prova de que o envio está configurado.
Para uma revisão sem mudanças arriscadas, peça ao responsável técnico que apresente o número exibido ao cliente, o ID técnico desse número, a conta do WhatsApp correspondente e a conta de mensagens usada no fluxo. Compare essa relação com um atendimento de teste autorizado. Se os nomes e IDs apresentados pelo seu painel diferirem do guia, registre a divergência e consulte a documentação aplicável à integração antes de editar acessos. Não remova um parceiro nem substitua identificadores em produção como primeiro teste.
Confira o número antes do envio
Ter um número listado no painel não prova, por si só, que ele já pode enviar mensagens pela Cloud API. A Meta distingue adicionar e verificar a propriedade do número de concluir seu registro para uso na Cloud API. Ao diagnosticar um canal que não envia, confira a etapa de registro e o estado do número antes de atribuir o problema ao texto da mensagem ou à fila de atendimento.
Monte um roteiro de conferência com o responsável pela conta: identifique o contato público correto; confirme sua associação à conta empresarial; verifique se a etapa de registro exigida para o uso pretendido foi concluída; confira o estado no WhatsApp Manager; só então teste um envio permitido para um destinatário de teste. Cada verificação responde a uma dúvida diferente. Um teste feito com o número de teste da plataforma, por exemplo, não demonstra que a linha divulgada aos clientes já esteja pronta.
Se houver mais de um número, escolha conscientemente qual linha deve aparecer para o cliente em cada rotina. No varejo, um aviso de retirada deve sair do canal que a loja reconhece e acompanha, não de uma linha escolhida por engano no fluxo. O conteúdo e o momento desse aviso são tratados no guia de pedido pronto para retirada; aqui, o objetivo é conferir a identidade técnica do remetente.
Faça o teste sem confundir ferramentas
Uma ferramenta de automação pode simplificar o desenho do fluxo, mas sua lista de operações não comprova que a conta empresarial está conectada ou que o número comercial está pronto. O conector WhatsApp Business Cloud do n8n documenta operações para enviar mensagens e modelos, além de operações com mídia. Isso descreve o que o conector oferece; a equipe ainda precisa conferir credenciais, recursos selecionados e resultados observados no próprio ambiente.
Como exemplo de procedimento próprio, uma loja pode criar um registro de teste com o número remetente esperado, o tipo de mensagem autorizado e o responsável por avaliar o resultado. A pessoa responsável acompanha a solicitação no sistema e distingue o retorno da integração dos eventos posteriores de entrega. Se o teste falhar, registre qual recurso e qual etapa falharam; não troque IDs sucessivamente nem repita envios para clientes reais até encontrar uma combinação que pareça funcionar.
Esse recorte também impede uma conclusão excessiva: organizar contas e identificadores não resolve, sozinho, atribuição de conversas entre atendentes. A distribuição exige regras próprias de fila, responsáveis e acompanhamento. Da mesma forma, um conector disponível não torna gratuita a operação de mensagens ou elimina exigências aplicáveis aos envios. Para custos e condições comerciais, consulte as páginas oficiais vigentes e o contrato do fornecedor no momento da decisão; este artigo não apresenta tarifas.
Guarde um mapa verificável
Ao terminar a revisão, deixe um mapa pequeno e utilizável: finalidade da linha, número público, ID técnico, conta do WhatsApp, conta de mensagens, aplicativo autorizado e pessoa que revisou a correspondência. Marque separadamente o que foi visto no painel e o que foi confirmado por teste. Assim, uma troca de prestador ou uma falha de envio não obriga a equipe a reconstruir a integração com base em capturas de tela sem contexto.
O limite desse mapa é deliberado. Ele não comprova consentimento para contato, entrega de mensagens, conformidade de um modelo ou qualidade do atendimento. Cada uma dessas tarefas precisa de sua própria verificação. O ganho prático aqui é saber exatamente qual identidade e qual conta investigar antes de mudar uma configuração que afeta o canal usado pelos clientes.