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.

Tela Ajustes → Canais com o botão Adicionar do cartão WhatsApp Oficial em destaque

Em Como deseja conectar?, selecione Cloud API ou Coexistência.

Janela Conectar WhatsApp (API Oficial Meta) com as opções Cloud API e Coexistência e o botão Conectar com a Meta

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.