O que é WhatsApp Business Platform da Meta?

É o nome oficial da Cloud API da Meta para WhatsApp Business. Permite empresa enviar e receber mensagens via API, com painel multi-atendente, templates HSM aprovados e métricas reais. Substitui o WhatsApp Business app (de celular) quando você precisa de operação séria com time.

O que preciso ter na Meta antes de conectar?

Conta Meta Business verificada, WABA (WhatsApp Business Account) ativa, número de telefone aprovado pela Meta, display name aprovado, forma de pagamento ativa (sai do tier de teste) e webhook configurado com verify token e evento messages assinado.

Quanto tempo leva a integração com a MercaBot?

Pelo Embedded Signup oficial Meta (popup integrado na MercaBot), 3 minutos. Manualmente (caso o cliente queira controlar todos os passos no Business Manager), 30-60 minutos seguindo o checklist desta página.

Posso usar o número que já tenho no WhatsApp Business app?

Sim, mas precisa desconectar do app primeiro. Um número WhatsApp pode estar OU no app Business (celular) OU na Cloud API — não nos dois ao mesmo tempo. A migração é simples e mantém o histórico.

O que é Phone number ID e Permanent access token?

Phone number ID: identificador numérico do número WhatsApp dentro da Cloud API (não confundir com o telefone). Permanent access token: chave de acesso da MercaBot ao seu canal — gerada via System User no Business Manager, não expira em 60 dias como o token temporário.

Guia operacional

Integração do WhatsApp Business Platform

Este é o fluxo que a MercaBot já espera no produto. Quando você terminar a configuração na Meta, basta colar no painel o número oficial, o Phone number ID e o Permanent access token para o canal começar a fluir no runtime do bot.

Estado atual e decisão operacional

Resolvido do lado da MercaBot

Webhook pronto, painel preparado para salvar canal, validação rígida de número oficial, Phone number ID e token, além de runtime pronto para receber messages e responder pela Graph API.

Decisão canônica na Meta

Use apenas a WABA MercaBot com identificação 942391361725741. Não use a WABA de teste nem a outra WABA duplicada enquanto a operação oficial não estiver concluída.

Checklist obrigatório na Meta

App criadoUse o app MercaBot com o caso de uso “Conectar-se com clientes pelo WhatsApp”.

Webhook validadoCadastre a URL abaixo na configuração do app e use o mesmo verify token salvo no Worker.

Campo messages assinadoDepois de salvar o webhook, assine o evento messages. Os outros campos não são necessários para o fluxo inicial.

Número real adicionadoCadastre o número oficial da empresa e conclua a verificação na conta do WhatsApp Business.

Forma de pagamento ativaAdicione forma de pagamento na Meta para sair do ambiente de teste e operar o número comercial real.

Valores exatos usados pela MercaBot

Callback URLhttps://api.mercabot.com.br/whatsapp/webhook

Verify tokenmercabot-whatsapp-verify-2026

Display name recomendadoMercaBot

Número comercial realUse o número oficial já aprovado para a operação comercial da MercaBot.

Abrir Meta Developers Voltar para salvar o canal

O que colar no painel quando a Meta terminar

Número oficial da empresaO mesmo número exibido ao cliente. A MercaBot salva esse valor mesmo antes da conexão final para deixar a conta em estado pendente.

Phone number IDValor numérico exibido na configuração da API do WhatsApp. Sem ele o MercaBot não envia mensagens pela Graph API.

Permanent access tokenUse o token permanente do canal real. O token temporário do ambiente de teste não serve para produção.

Campos do Login do Facebook para Empresas

URL de solicitação de exclusão de dadoshttps://mercabot.com.br/privacidade/

Desautorizar URL de retorno de chamadahttps://mercabot.com.br/privacidade/

URIs de redirecionamento OAuth válidoshttps://mercabot.com.br/painel-cliente/app/ https://mercabot.com.br/acesso/

Domínios permitidos para o SDK do JavaScriptmercabot.com.br www.mercabot.com.br

Checklist operacional em 3 fases

Fechar a conta oficial na MetaEntrar na WABA 942391361725741, abrir Phone Numbers, adicionar o número oficial real e concluir a verificação. Se a Meta disser que o número já está em uso, migrar ou usar um número limpo para destravar a implantação.

Fechar webhook e eventosConfigurar a Callback URL, usar o mesmo Verify token do Worker e assinar o evento messages. Sem isso, a Meta não entrega as mensagens ao MercaBot.

Salvar o canal e validar ponta a pontaColar número oficial, Phone number ID e Permanent access token no painel do cliente, rodar o autoteste e enviar uma mensagem real de outro número para confirmar entrada no webhook e resposta da Anthropic.

Se o número aparecer como em uso

Cenário A: número definitivoFaça a migração ou desconexão da conta atual onde esse número está preso. Só depois volte para a WABA oficial e tente novamente.

Cenário B: destravar implantação rápidoUse um número novo, limpo, que ainda não esteja vinculado a nenhum WhatsApp ou WABA. Isso acelera a integração ponta a ponta e a próxima auditoria.

Regra operacionalNão misture a WABA oficial com a Test WhatsApp Business Account. O canal de produção precisa ficar inteiro dentro da WABA canônica.

Check final antes da próxima auditoria

✓

Do nosso ladoWebhook pronto, painel pronto, validações de canal prontas e runtime preparado para Meta + Anthropic.

□

Ainda falta na MetaAdicionar e verificar o número oficial na WABA 942391361725741, ativar forma de pagamento e concluir a assinatura de messages.

□

Ainda falta no teste finalSalvar o canal no painel, rodar o autoteste e enviar mensagem real de outro número para confirmar o fluxo completo: Meta → webhook → Anthropic → resposta.