Pular para o conteúdo principal

Conectar WhatsApp Business (Meta)

Resumo: Você clica em "Conectar via Meta", faz login com sua conta do Facebook que administra o WhatsApp Business, escolhe o número e o app é autorizado. Não precisa colar tokens manualmente.

Quando usar isso​

Use este fluxo quando seu número já está cadastrado no Meta Business como WhatsApp Business Cloud API — ou quando você está criando esse cadastro pela primeira vez e quer fazer tudo pela tela.

Esse é o método recomendado para:

  • Clínicas, escritórios e empresas que precisam de selo verde verificado.
  • Quem vai enviar mensagens proativas (lembretes, cobranças, marketing).
  • Quem precisa de estabilidade (a conexão WABA não cai como o Baileys).

ℹ️ Saiba mais: "Embedded Signup" é o nome oficial Meta para esse fluxo. Ele substitui a antiga necessidade de copiar/colar phoneNumberId, accessToken e businessAccountId manualmente — a Meta gerencia tudo via OAuth.

Pré-requisitos​

  • Uma conta no Facebook (pessoal) que administra a conta business da sua empresa.
  • Um número de telefone disponível para se tornar WhatsApp Business. Importante: esse número NÃO pode estar ativo no WhatsApp comum. Se estiver, você precisa apagar a conta do WhatsApp comum desse número antes (no celular: Configurações → Conta → Apagar minha conta).
  • Conseguir receber um SMS ou ligação no número para confirmação inicial (a Meta envia um código).

Passo a passo​

  1. Acesse Canais → Adicionar canal no painel da sua plataforma.
  2. Escolha a aba WhatsApp Business (Meta).
  3. Clique em Conectar via Meta. Uma janela popup do Facebook vai abrir.
  4. Faça login com a conta Facebook que administra sua empresa (se já estiver logado, pula essa etapa).
  5. A Meta vai mostrar uma sequência de telas:
    • Selecione sua empresa (Business Manager). Se você ainda não tem, a Meta permite criar na hora.
    • Selecione ou crie a WhatsApp Business Account (WABA).
    • Adicione o número de telefone que vai virar WhatsApp Business. Confirme o código que chegar via SMS ou ligação.
    • Configure o nome de exibição (o que aparece para o cliente no chat).
    • Autorize as permissões que o app pede.
  6. Após terminar, a janela fecha sozinha. A plataforma confirma com "Conectado como +55...".

A partir desse momento, o canal aparece como CONNECTED na lista, e você pode começar a enviar e receber mensagens.

⚠️ Atenção: Para enviar a primeira mensagem para um cliente (que ainda não te mandou nada), você precisa de um template aprovado. Veja Quando preciso usar template vs mensagem livre.

Alternativa: conexão manual com credenciais​

Se você já tem um app na Meta e prefere colar as credenciais manualmente (sem OAuth), use a aba WhatsApp Business (manual). Você vai precisar de:

CampoOnde encontrar
Phone Number IDMeta Business Suite → WhatsApp → API Setup
WhatsApp Business Account IDMesma tela, geralmente acima do Phone Number ID
Access TokenUse um System User token permanente, não o temporário de 24 horas

⚠️ Atenção: O token temporário de 24h que aparece na primeira tela do "API Setup" expira rápido. Você precisa criar um System User em Business Settings → Users → System Users e gerar um token permanente com permissão whatsapp_business_messaging.

Dúvidas comuns​

Apareceu erro "Meta não retornou phone_number_id". Isso acontece quando o seu app Meta ainda está em modo Development ou não tem permissão whatsapp_business_messaging. Acesse o app no Meta for Developers, mude para Live e confirme as permissões.

Já tinha o número no WhatsApp comum. O que acontece? Se você usar o mesmo número, a Meta vai pedir para apagar a conta do WhatsApp comum primeiro. Depois disso, o número some do aplicativo comum e passa a operar só via WABA — o controle é via API/dashboard, não pelo app no celular.

Preciso pagar para usar? Sim, há duas camadas de custo:

  1. A Meta cobra por conversa iniciada (varia conforme categoria e país).
  2. O gateway cobra pelo volume processado e canais ativos (depende do seu plano). A primeira conversa de cada mês com cada contato pode ser gratuita conforme a categoria. Detalhes em Entendendo a fatura mensal.

Posso desconectar? Sim, remova o canal pela lista. O número continua existindo na Meta, mas para de ser controlado pelo gateway.

Artigos relacionados​