Conectar WhatsApp Oficial (API da Meta)

Conecte um número de WhatsApp pela API oficial do Meta Business. É o caminho recomendado para empresas que querem um número verificado, com suporte a modelos de mensagem aprovados. A conexão é feita autorizando pela Meta — você não digita tokens.
Objetivo
Ligar um número de WhatsApp ao AtendeBot pela API oficial da Meta, escolhendo entre Cloud API e Coexistência.
Pré-requisitos
Perfil Administrador.
Uma conta no Meta Business e acesso de administrador a ela.
Um número de telefone para o WhatsApp (novo ou já usado no app WhatsApp Business, dependendo do modo escolhido).
Estar logado no Facebook no mesmo navegador.
Tempo estimado
10 minutos.
Caminho de acesso
Ajustes → Contas
Cloud API ou Coexistência?
No diálogo, em Como deseja conectar?, você escolhe entre dois modos:
Cloud API — O número passa a ser gerido pela API. Recomendado para um número novo ou que ainda não usa o app WhatsApp Business.
Coexistência — Mantém o número no app WhatsApp Business no celular e usa a API ao mesmo tempo. Requer o app WhatsApp Business atualizado (versão ≥ 2.24.17) no aparelho.
Escolha Coexistência se você quer continuar usando o app no celular; escolha Cloud API para um número dedicado à plataforma.
Passo a passo
Abra Ajustes → Contas. Na linha WhatsApp Oficial, clique em Adicionar.
🖼️ PRINT — Tela Ajustes → Contas com o card WhatsApp Oficial e o botão Adicionar destacado.
Em Como deseja conectar?, selecione Cloud API ou Coexistência.
🖼️ PRINT — Diálogo Conectar WhatsApp (API Oficial Meta) com as duas opções de modo.
Clique em Conectar com a Meta. Uma janela da Meta abre por cima.
Nessa janela, siga o cadastro (Embedded Signup) até o final: escolha ou cadastre o número, confirme o código de verificação e conclua todas as etapas.
Ao terminar, a janela fecha e o AtendeBot confirma a conexão.
Resultado esperado
O canal aparece na lista de Contas como WhatsApp Oficial, com o ponto verde e o texto Conectado. Você pode definir a Equipe que vai atender esse canal e usar a estrela Padrão para torná-lo o canal padrão de envio.
Erros comuns
Sintoma: "Não recebemos os dados do número. Tente de novo e conclua o cadastro até o final no popup." Solução: reabra o fluxo e vá até a última etapa da janela da Meta sem fechá-la antes de concluir.
Sintoma: conectou, mas há aviso de que a inscrição automática de webhook falhou. Solução: o canal foi conectado; verifique a assinatura de webhooks no painel da Meta ou fale com o suporte.
Sintoma: na Coexistência, o número não conecta. Solução: atualize o app WhatsApp Business no celular para a versão ≥ 2.24.17 e tente de novo.
Artigos relacionados
Conectar WhatsApp via QR Code
Conectar Instagram e Messenger (Meta)
Enviar um modelo de mensagem (WhatsApp Oficial)
Definir a equipe padrão por canal