Configurando o webhook e o PIN de duas etapas

Salvar Phone Number ID, WABA ID e token deixa o Cerne Talk autenticado com a Meta — mas autenticado não é o mesmo que registrado para receber eventos. São duas coisas separadas, e a tela de conexão mostra as duas em banners distintos por esse motivo. É comum confiar só no banner verde de credenciais e não perceber que o número não está de fato recebendo nada.

Configurando o webhook

O webhook é o endereço que a Meta chama sempre que algo acontece no número (mensagem recebida, status de entrega, etc.). Em Configurações → Conexão do WhatsApp, copie a URL de callback do webhook exibida na tela — ela é gerada automaticamente a partir do seu domínio, no formato https://seu-dominio/api/whatsapp/webhook.

No painel da Meta, em WhatsApp → Configuração:

1. Clique em Editar na seção de Webhook.
2. Cole a URL de callback copiada.
3. No campo Verify Token, use exatamente o mesmo valor que você digitou no campo Token de verificação do webhook dentro do Cerne Talk — os dois precisam bater, é essa string que a Meta usa para confirmar que o endpoint é seu.
4. Inscreva-se no campo de webhook “messages”.

O PIN de duas etapas

Esse é o passo que mais gente pula e que causa o sintoma “conectou, mas nada chega”. O PIN existe porque, sem ele, a Meta roteia os eventos inbound para qualquer app que tenha reivindicado o número por último — o que aparece com frequência quando o mesmo WABA tem mais de um número e mais de um app reivindicando cada um.

Para gerar o PIN: Meta Business Manager → Contas do WhatsApp → Números de telefone → Verificação em duas etapas. Copie o código de 6 dígitos e cole no campo PIN de verificação em duas etapas do Cerne Talk antes de salvar.

Duas exceções onde o PIN não é necessário:

• Números de teste da Meta não têm PIN e já vêm pré-registrados — deixe o campo em branco.
• Se você só está trocando o token (rotação de credencial) e o registro já está ativo, deixar o PIN em branco mantém o registro existente intacto em vez de tentar re-registrar.

Lendo o status de registro

Depois de salvar, um segundo banner mostra:

• Registrado — a Meta vai entregar eventos ao Cerne Talk, com a data da inscrição;
• Não registrado — a Meta não vai entregar eventos, com o motivo da última tentativa quando houver.

Use o botão Verificar com a Meta a qualquer momento para rodar um diagnóstico ao vivo e ver exatamente qual etapa falhou, em vez de adivinhar pelo texto do erro.