Do número à
primeira conversa.

1. Abra as Configurações da empresa. Confira o nome no seletor de portfólios; não avance no portfólio de outro cliente.
2. Selecione o portfólio existente ou crie um para a empresa, com seus dados reais. Evite duplicar uma estrutura que ela já usa.
3. Em Pessoas / People, confira quem tem controle administrativo. Convide o implementador com o acesso necessário, usando a própria conta dele. O dono não precisa compartilhar sua senha.
4. Em Informações da empresa / Business info, registre o ID do portfólio. Confira pendências na Central de Segurança ou no início do suporte empresarial.

1. Abra Meus apps. Se for a primeira vez, conclua o cadastro de desenvolvedor.
2. Clique em Criar app / Create App. Informe um nome reconhecível, como “Integração WhatsApp — Empresa”, e um e-mail de contato monitorado.
3. Selecione Conectar-se com clientes pelo WhatsApp / Connect with customers through WhatsApp. Vincule o portfólio da etapa 1.
4. Revise os requisitos mostrados, conclua a criação e abra Personalizar caso de uso / Customize use case. Anote o App ID.

1. Em Configuração da API / API Setup, selecione ou crie a conta WhatsApp Business da empresa. Confira se ela pertence ao portfólio correto.
2. Anote o WhatsApp Business Account ID / WABA ID. Ele é diferente do ID do app e do ID do número.
3. Opcionalmente, faça o teste oferecido pelo painel: gere o token temporário, selecione o número de teste em From, adicione e verifique seu telefone em To e envie a mensagem de exemplo.
4. Responda pelo seu celular. Esse teste ajuda a conhecer a API; as próximas etapas devem usar a WABA e o número reais de produção.

1. Escolha Adicionar número / Add phone number. Preencha o perfil comercial, a categoria e o nome de exibição coerentes com o negócio e seu site.
2. Informe país, DDD e número. Se ele já está no Business app ou em outro provedor, retorne ao fluxo correspondente antes de alterá-lo.
3. Escolha SMS ou Ligação / Voice call. O responsável recebe o código e o informa na Meta. Em linha fixa com URA, prepare o atendimento da ligação e confira bloqueios.
4. Após a validação, selecione o número real no painel e anote seu Phone Number ID, além do telefone com DDI. Confira também o estado do nome de exibição.

1. Crie um usuário do sistema dedicado à integração, com nome reconhecível. Em Atribuir ativos / Assign assets, selecione o app e a conta WhatsApp da empresa.
2. Conceda as capacidades necessárias nesses ativos. O guia geral da Meta usa Manage app e Manage WhatsApp Business accounts; restrinja a seleção aos ativos desta integração. Permissão no token e acesso ao ativo precisam existir juntos.
3. Clique em Gerar token / Generate token, selecione o app correto e, para uma credencial persistente de servidor, escolha Nunca / Never se essa opção estiver disponível. Se houver expiração, registre a data e programe a renovação.
4. Selecione whatsapp_business_messaging e whatsapp_business_management. Acrescente business_management somente se o fluxo realmente precisar acessar ou administrar o portfólio pela API.
5. Salve o token diretamente no cofre e nas variáveis secretas do servidor. Valide app, permissões, validade e acesso ao número com uma consulta autenticada. Não coloque tokens em prints, chats, GitHub ou código do navegador.

1. Localize a Chave secreta do app / App Secret. A Meta pode pedir nova autenticação. Guarde-a no cofre; o backend a usa para verificar a origem dos eventos.
2. Gere um Verify Token aleatório para a validação inicial do webhook. Este valor é definido por você e deve ser idêntico na Meta e no servidor.
3. Configure o backend com o token de acesso, App Secret, Verify Token, WABA ID e Phone Number ID corretos. Os nomes das variáveis dependem da implementação.
4. Publique o endpoint HTTPS de produção, acessível à Meta, com tratamento de GET e POST. Na Vercel, aplique os segredos ao ambiente de produção e faça uma nova implantação após alterar variáveis que dependam dela.
5. Verifique também banco, fila, serviço de IA e autenticação entre componentes. Um webhook não é apenas uma URL: ele precisa conseguir processar a mensagem e enviar a resposta.

1. Com a posse do número já verificada, use a API de registro para o Phone Number ID real.
2. Defina um PIN de verificação em duas etapas com 6 dígitos e armazene-o no cofre. Se o número já tiver um PIN, utilize o existente ou siga a recuperação oficial. Esse PIN não é o código recebido por SMS.
3. Após o registro, consulte o status ou abra WhatsApp Manager → Account tools → Phone numbers. O resultado esperado para operar é CONNECTED / Conectado.

POST https://graph.facebook.com/v26.0/PHONE_NUMBER_ID/register
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "pin": "PIN_DE_6_DIGITOS"
}

GET https://graph.facebook.com/v26.0/PHONE_NUMBER_ID?fields=status
Authorization: Bearer ACCESS_TOKEN

Resultado esperado: "status": "CONNECTED"

1. Em Webhook, informe a Callback URL do backend de produção e o Verify Token configurado no servidor. Clique em Verify and save / Verificar e salvar.
2. A Meta faz um GET. O servidor deve conferir o token e devolver o valor de hub.challenge com status 200. Uma página HTML ou JSON contendo o desafio não substitui a resposta esperada.
3. Na lista de campos, assine messages. Esse campo entrega mensagens recebidas e atualizações de status das mensagens enviadas.
4. Confirme que o app também está inscrito na WABA real. A URL validada e a seleção de campos não substituem a inscrição do app na conta WhatsApp. No onboarding de clientes, faça isso para cada WABA.
5. Envie um teste pelo painel e confira o recebimento. Depois faça o teste real do passo 10: a simulação do painel não comprova todo o fluxo do número.

POST https://graph.facebook.com/v26.0/WABA_ID/subscribed_apps
Authorization: Bearer ACCESS_TOKEN

GET https://graph.facebook.com/v26.0/WABA_ID/subscribed_apps
Authorization: Bearer ACCESS_TOKEN

1. No WhatsApp Manager ou na seção de pagamento do API Setup, confira a WABA e configure o método de pagamento aplicável. Combine quem paga Meta, hospedagem, IA e eventual provedor.
2. Confira o status do nome de exibição, os limites da conta e as pendências de verificação empresarial. Envie documentos da própria empresa quando solicitados.
3. No app, conclua os requisitos de publicação que o painel mostrar e configure Live / Ao vivo para produção. Verificação empresarial, análise de nome, publicação do app e App Review são processos distintos.
4. Se o app acessará ativos de outras empresas, conclua o App Review e obtenha acesso avançado às permissões necessárias. Apenas mudar o app para Live não concede esse acesso. Use o fluxo de plataforma.
5. Prepare modelos aprovados quando houver mensagens iniciadas pela empresa ou fora da janela de atendimento. Defina como obter consentimento, respeitar pedidos para parar o contato e oferecer acesso claro a atendimento humano. Confira a política de mensagens.

Verificar a empresa não é contratar Meta Verified nem obter o selo de Conta Comercial Oficial. Não prometa selo ou aprovação imediata ao cliente.

1. De outro telefone com WhatsApp, envie uma mensagem nova ao número real da empresa, por exemplo: “Olá, teste de ativação”. Para uma Eve privada, cadastre esse remetente antes do teste.
2. Confirme no backend a entrada com o Phone Number ID e remetente corretos. Verifique que fila, armazenamento e agente processaram o evento.
3. Confira o envio da resposta pela Graph API e acompanhe seu status. A API aceitar o envio não prova que a mensagem foi entregue.
4. Peça ao responsável para confirmar visualmente o recebimento no WhatsApp. Envie uma segunda pergunta e verifique a continuidade da conversa.
5. Teste as regras da solução: remetente sem acesso, encaminhamento ao negócio correto, intervenção humana e ausência de respostas duplicadas. Para automações proativas, teste também um modelo aprovado com consentimento.