Skip to main content

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

  1. Abra Ajustes → Canais. Na linha WhatsApp Oficial, clique em Adicionar.

Tela Ajustes → Canais com o botão Adicionar do card WhatsApp Oficial em destaque
Tela Ajustes → Canais com o botão Adicionar do card WhatsApp Oficial em destaque
  1. 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
Janela Conectar WhatsApp (API Oficial Meta) com as opções Cloud API e Coexistência e o botão Conectar com a Meta
  1. Clique em Conectar com a Meta. Uma janela da Meta abre por cima.
  2. 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.
  3. Ao terminar, a janela fecha e o AtendeBot confirma a conexão.

Resultado esperado

O canal aparece na lista de Canais 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: 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: na linha do canal em Ajustes → Canais, 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.

Artigos relacionados