ConextBotConextBot Docs

WhatsApp Oficial (Meta Cloud API)

A conexão homologada diretamente pela Meta. Sem QR Code, sem risco de bloqueio por automação — seu número roda dentro da infraestrutura oficial do WhatsApp Business Platform, com limites de disparo e selo de qualidade geridos pela própria Meta.

Esta é a segunda forma de conectar um número de WhatsApp ao seu bot. Para a conexão rápida via QR Code (WuzAPI), veja WhatsApp (Uzapi) no menu ao lado. Use a Meta Cloud API quando o cliente já possui (ou quer) um número comercial verificado, com maior volume de disparo e sem depender de um celular físico ligado 24h.

Conexão via Embedded Signup

1

Conectar com Facebook

Em Meus Bots > Conectar, escolha a aba "WhatsApp Oficial (Meta)" e clique em "Conectar com Facebook".

2

Escolha o número

Faça login com a conta do Gerenciador de Negócios (Business Manager) e selecione ou crie a WABA e o número comercial.

3

Pronto, sem QR Code

O sistema registra o número, gera o PIN de 2 fatores e assina o webhook automaticamente. Status muda para "Conectado".

Alternativa: Colar Credenciais Manualmente

Se preferir gerar o token diretamente no painel de desenvolvedor da Meta (ou já tiver um Token de Sistema permanente), use o formulário manual em vez do botão de login social.

Phone Number ID

ID do número no painel Meta for Developers.

WABA ID

Obrigatório: sem ele o sistema não consegue assinar o webhook e as mensagens recebidas não chegam.

Access Token

Token temporário ou permanente (Usuário de Sistema) gerado no app da Meta.

Verificações necessárias na Meta

Antes de enviar mensagens para números reais fora do modo de teste, a conta de negócios (Business Manager) precisa concluir as verificações da Meta. São etapas separadas, cada uma com seu próprio prazo:

Verificação de Negócio (Business Verification)

Confirma a identidade legal da empresa dona do Business Manager (CNPJ e documentos). Necessária para destravar limites maiores de envio.

Verificação de Acesso (Tech Provider)

Necessária quando o app é usado para conectar contas de clientes (uso como provedor de tecnologia). Libera o modo Live para as WABAs sob o seu Business Manager.

App Review (Advanced Access)

Só é exigido quando o app vai operar em produção com números de clientes de terceiros em escala (uso como Solution/Tech Provider para múltiplas agências). Exige vídeo de demonstração do fluxo funcionando — por isso deve ser solicitado depois das verificações acima, nunca antes.

Recebimento (Inbound)

A Meta envia a mensagem via Webhook (HTTPS) diretamente para o Conext Bot, sem depender de nenhum celular ligado ou sessão de navegador ativa.

Resposta (Outbound)

O sistema chama a Graph API da Meta para enviar texto, áudio ou mídia de volta, respeitando os limites de mensageria da sua camada (Tier) de qualidade.

Recomendado para agências que atendem clientes com alto volume de mensagens ou que exigem número comercial verificado com selo oficial no WhatsApp.