Conectar pela API Oficial da Meta

Antes de começar: o que muda na sua vida

Este é o caminho que a gente indica. Ele tem risco menor — não zero: a Meta também restringe e bane número por violação de política. O que você ganha é regra publicada e aviso antes da queda. Em troca, paga dois preços que não são em dinheiro:

1. O número sai do aplicativo comum do WhatsApp. Ninguém mais abre aquele número no celular pra responder. Use chip novo ou número dedicado ao atendimento. Nunca migre o número que a empresa já usa no dia a dia sem entender isso.
2. Você não puxa assunto livremente. A Meta só deixa a empresa iniciar conversa com um template aprovado. Depois que o cliente responde, abrem 24 horas de conversa livre.

Se isso te assusta, o caminho da Z-API é legítimo — só entenda que o risco de perder o número é maior por lá. O comparativo completo está em WhatsApp: API Oficial ou Z-API?.

Visão geral

O guia completo fica em /settings/whatsapp/guia-meta (o formulário de conexão Meta linka pra ele no box "Onde encontro essas informações?"). Leva uns 25 minutos e não exige conhecimento técnico.

Você vai gerar 3 credenciais no painel da Meta (Token de acesso, Phone Number ID, WABA ID), configurar pagamento, webhook e template, e colar tudo no CRM.

Pré-requisitos: conta Facebook/Meta (a pessoal serve, ela só administra), perfil admin na Conta Comercial (Meta Business), número dedicado com acesso a SMS ou ligação, e cartão de crédito internacional (a Meta cobra em dólar).

Os 7 passos

1. Criar o app: developers.facebook.com/apps → Criar aplicativo → caso de uso "Conectar-se com clientes pelo WhatsApp". O caminho-chave do painel: Casos de uso → Personalizar → Etapa 2 · Configuração de produção — é onde ficam número, pagamento e webhook.
2. Phone Number ID e WABA ID: business.facebook.com → Configurações do Negócio → Contas → Contas do WhatsApp (o WABA ID fica em "Identificação"). Depois, Gerenciador do WhatsApp → Números de telefone → clique no número (aparece o Phone Number ID). São identificadores, não senhas.
3. Token permanente: Configurações do Negócio → Usuários → Usuários do Sistema → Adicionar (função Administrador) → Atribuir ativos: o APP (Gerenciar app) E a CONTA DO WHATSAPP (Acesso total). Quem esquece a conta gera um token que não envia mensagem. Gere o token com validade Nunca e permissões whatsapp_business_messaging + whatsapp_business_management. O token aparece uma única vez (começa com EAAG...) — copie na hora.
4. Pagamento: business.facebook.com → Cobrança e pagamentos → Contas do WhatsApp Business → Adicionar forma de pagamento (cartão em dólar). Sem isso as mensagens não saem depois do teste. É o que mais trava gente aqui.
5. Webhook (a ordem importa):

• PRIMEIRO crie e salve o canal no CRM (Conectar novo número → Meta Cloud API), definindo o Webhook Verify Token — é uma senha qualquer, com 8 caracteres ou mais, que você inventa.
• Depois, na Meta (Casos de uso → Personalizar → Etapa 2 → Configurar webhooks): URL de callback = https://crmdojordao.com.br/api/webhooks/whatsapp/meta · Verificar token = o MESMO que você digitou no canal do CRM → Verificar e salvar.
• Ative o campo messages na lista do webhook (é o único necessário).
• A verificação falha se o canal ainda não foi salvo no CRM, ou se URL/token foram colados com espaço ou diferentes.

1. Template de abertura: Gerenciador do WhatsApp → Modelos de mensagem → Criar modelo. Nome em minúsculas_com_underscore, Português BR, categoria Marketing ou Utilidade, use {{1}} pra personalizar.
2. Colar no CRM: telefone em formato E.164 + Phone Number ID + WABA ID + Access Token + Webhook Verify Token → salvar → mande uma mensagem de teste pro seu próprio número.

Erros comuns

• Webhook não verifica (sem check verde): o canal não foi salvo no CRM antes, ou a URL/token foram colados com espaço ou diferentes.
• "Token inválido" ou mensagens pararam: você usou o token temporário, que expira em 24h. Refaça o passo 3 com Usuário do Sistema e validade Nunca.
• Não consegue iniciar conversa: a primeira mensagem precisa ser um template aprovado (passo 6).
• Mensagens não saem mesmo com tudo certo: quase sempre é pagamento (passo 4) — cartão não vinculado ou recusado.
• Códigos da Meta: 131049 e 131056 (limite/volume de marketing — use categoria Utilidade e reduza a frequência), 130472 ("experimento" da Meta — use template de Utilidade ou aguarde o cliente iniciar), 131042 (falha no pagamento), 131026 (o destino não tem WhatsApp).

Etapas complementares (quando a Meta pedir)

• Verificação do negócio: Configurações do Negócio → Centro de Segurança → Começar verificação (CNPJ + comprovante de endereço, até 48h úteis). Libera limites maiores de envio.
• Nome de exibição: Gerenciador do WhatsApp → Números de telefone → engrenagem → Perfil → Nome de exibição. Passa por aprovação da Meta e precisa ser coerente com a marca.
• Nota de qualidade (Verde/Amarelo/Vermelho) no Gerenciador: sobe quando as pessoas respondem, cai com bloqueios e denúncias. Nota alta significa mais mensagens liberadas por dia.

Repare nessa última: a Meta te premia por conversar bem e te pune por incomodar. É o mesmo critério que eu uso pra ensinar vendas.