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.