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 → Canais
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 → Canais. No bloco Adicionar canal, no cartão WhatsApp Oficial, clique em Adicionar.
- Em Como deseja conectar?, selecione Cloud API ou Coexistência.
- 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 da Meta fecha e abre a janela WhatsApp Oficial conectado. Escolha a Equipe que recebe os atendimentos, use Definir como padrão se quiser e clique em Concluir. Se o registro do número na API oficial ainda estiver pendente, um aviso no topo da janela oferece o registro ali mesmo.
Resultado esperado
O canal aparece em Seus canais como WhatsApp Oficial, com o status Conectado em verde. Para mudar a equipe ou o canal padrão depois, clique em Configurar na linha do canal. Se a conta ainda não tem modelos de mensagem, o AtendeBot sugere criar o primeiro: eles são necessários para iniciar conversas fora da janela de 24 horas.
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: conectou, mas o registro do número na API oficial falhou (aviso na conexão), ou o envio de mensagens passa a falhar com o erro 133010. Solução: em Ajustes → Canais, abra o menu ⋯ (Mais ações) da linha do canal e clique em Registrar número. Se a Meta pedir um PIN, informe o PIN de 6 dígitos cadastrado no WhatsApp Manager e clique em Confirmar PIN.
- 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.