Conectando o WhatsApp API Oficial (Meta): cadastro rápido e webhook
Como conectar a API Oficial do WhatsApp pelo cadastro rápido da Meta ou pela configuração manual do webhook, e como os modelos de mensagem se organizam por conta.
A API Oficial da Meta é uma das duas formas de conectar o WhatsApp ao Contrate 360. A outra é a conexão via QR Code (API não oficial), que não tem custo por mensagem e não exige cadastro na Meta. Na API Oficial, a Meta cobra pelos templates enviados; o Contrate 360 não cobra por mensagem em nenhum dos dois casos. Para comparar as duas opções, veja o artigo "WhatsApp: conectar via QR Code ou API Oficial? Diferenças e custos de envio".
Duas formas de conectar
Para receber e enviar mensagens pela API Oficial do WhatsApp, a plataforma precisa estar ligada à sua conta na Meta. Existem dois caminhos: o Cadastro Incorporado, que faz tudo automaticamente, e a configuração manual, para quem prefere informar as credenciais por conta própria.

Cadastro Incorporado (recomendado)
É a forma mais simples e a que evita a maior parte dos erros de configuração. Você autoriza o acesso direto na tela da Meta e o sistema descobre sozinho o número, a conta do WhatsApp, o token e o webhook — sem precisar copiar e colar nada.
- Acesse Configurações → Canais e clique em Nova conexão.
- Escolha a opção de conectar pela API Oficial com o cadastro rápido da Meta.
- Faça login com a conta do Facebook que administra o WhatsApp Business e siga os passos exibidos pela própria Meta.
- Se a sua conta tiver mais de um número disponível, o sistema mostrará a lista para você escolher qual deseja conectar.
- Ao final, a conexão já aparece pronta para enviar e receber mensagens.
Observação: se essa opção não aparecer para você, significa que ela ainda não foi liberada no seu ambiente. Nesse caso, use a configuração manual abaixo ou fale com o suporte.
Configuração manual
Nesse caminho, você mesmo informa as credenciais e cadastra o webhook no painel da Meta.
Onde encontrar as informações no sistema
- Acesse Configurações → Canais → (conexão) → Configurações.
- Clique na aba Conexão / API.
- Você encontrará a Callback URL e o Verify Token.
Configurando no Meta for Developers
- Acesse developers.facebook.com e abra seu app.
- Vá em WhatsApp → Configuration.
- Na seção Webhook, cole a Callback URL copiada do sistema.
- Cole o Verify Token exibido no sistema.
- Em Webhook Fields, assine o campo
messages. - Salve as configurações no painel da Meta.
Credenciais necessárias
- Access Token — Token permanente gerado em Meta Business Suite → System Users.
- Phone Number ID — Em WhatsApp → API Setup no painel do app Meta.
- WABA ID — WhatsApp Business Account ID. Encontrado em: Meta Business Suite → Configurações → Contas → Contas do WhatsApp.
Modelos de mensagem e múltiplas contas
Os modelos de mensagem aprovados pertencem à conta do WhatsApp (WABA), e não à plataforma. Por isso, se você tem mais de uma conexão oficial, cada canal exibe e sincroniza apenas os seus próprios modelos. Ao enviar um modelo, escolha sempre o canal correspondente à conta onde ele foi aprovado — caso contrário a Meta recusa o envio.
Para atualizar a lista, use o botão de sincronizar na tela de modelos, que permite sincronizar um canal específico ou todos de uma vez.
Botões com link nos modelos
Em um modelo com botão de link dinâmico, a variável precisa ficar no final do endereço. Se o botão vai receber um link completo do sistema, como o de um contrato, fatura ou proposta, use apenas o endereço do seu domínio seguido da variável, por exemplo https://seudominio.com.br/{{1}}.
Nunca cole o link de um contrato ou fatura específico no botão. A Meta junta o link inteiro ao final desse endereço e o cliente recebe um link duplicado.
A tela de criação de modelos já sugere o endereço correto. A tela de mapeamento exibe um alerta quando um modelo aprovado tem esse problema: nesse caso, recrie o modelo com o endereço sugerido. Links de assinatura de contrato que já foram enviados com o endereço duplicado continuam abrindo a página certa.
Dicas e problemas comuns
- Mensagens não chegam ao chat: confira se o campo
messagesestá assinado nos Webhook Fields do painel da Meta. Esse é o motivo mais comum. - A Callback URL funciona para vários números no mesmo App Meta — o sistema identifica automaticamente qual número recebeu cada mensagem.
- Conexões marcadas como "Incompleta" indicam um cadastro que foi interrompido no meio. É seguro removê-las e iniciar novamente.
- Fora da janela de 24 horas desde a última mensagem do cliente, só é possível enviar modelos aprovados pela Meta.