Ativando a API oficial da Meta (Cloud API): guia completo

A Cloud API é o canal oficial do WhatsApp Business, direto com a Meta. Não existe celular, não existe QR, não existe sessão que cai: o número vive na infraestrutura da Meta e o Autopilot conversa com ela por API. Em troca, você joga pelas regras da Meta — templates aprovados para iniciar conversa e a janela de 24 horas (explicados em outro artigo desta categoria). É o canal certo para volume alto e operação que não pode depender de um aparelho ligado.

O que você precisa reunir antes

• Uma conta no Business Manager da Meta com um WhatsApp Business Account (WABA) criado.
• O WABA ID — obrigatório. Sem ele o Autopilot não consegue vincular sua conta ao aplicativo na Meta, e você conseguiria enviar mas nunca receberia resposta.
• O Phone Number ID do número que vai operar.
• Um token de acesso válido, gerado no Business Manager.
• O número já registrado na Cloud API — o registro é feito na Meta com um PIN de 6 dígitos. Se o número ainda não foi registrado, a ativação vai barrar e avisar.

Passo a passo da ativação

• 1. Na tela de conexão, escolha o canal oficial (Cloud API) e informe Phone Number ID, WABA ID e o token.
• 2. O Autopilot valida o token ao vivo na Graph API da Meta. Token errado ou expirado falha aqui, na hora — não no seu primeiro envio de campanha.
• 3. O sistema confere se o número está registrado na Cloud API. Se não estiver, conclua o registro no Business Manager (PIN de 6 dígitos) e tente de novo.
• 4. O Autopilot vincula sua WABA ao aplicativo — é esse passo que faz as mensagens recebidas chegarem até você. Se esse vínculo falhar, a ativação inteira falha, de propósito: nada de conexão meio-quebrada que envia mas não recebe.
• 5. O token é criptografado e guardado, e seus templates aprovados na Meta são sincronizados automaticamente. Se a Meta demorar nessa parte, a ativação conclui mesmo assim e você sincroniza os templates depois, manualmente.

Um ponto importante: o canal de uma conexão é definitivo. Uma conexão que já opera via QR nunca vira Cloud API, e vice-versa — isso protege seu histórico e evita estragos irreversíveis no número. A Cloud API só é ativada em uma conexão nova ou na reconexão de uma conexão Cloud que perdeu o token (por exemplo, token revogado na Meta: basta colar um token novo na mesma conexão).

Dica de operador: guarde o WABA ID e o Phone Number ID num lugar seguro junto com as credenciais da empresa. Na hora de reconectar depois de um token revogado, ter isso à mão transforma um incidente em dois minutos de trabalho.

Problemas comuns

• "Não foi possível validar na Meta": token errado, expirado ou sem permissão para esse número. Gere um token novo no Business Manager e confira se ele pertence à WABA certa.
• "Número ainda não registrado na Cloud API": falta concluir o registro do número na Meta com o PIN de 6 dígitos. Isso é feito no Business Manager, não no Autopilot.
• Templates não apareceram após ativar: a sincronização é feita da melhor forma possível na ativação, mas a Meta às vezes demora. Use a sincronização manual de templates e eles aparecem.