Skip to main content
Conecte um número WhatsApp Business ao seu agente pela API oficial da Meta. O Zenda cuida do OAuth, do registro do número e dos webhooks — você só precisa concluir o fluxo no popup da Meta.
Pré-requisitos: conta no Zenda, um agente criado, chip/número que não esteja ativo no WhatsApp pessoal ou no app WhatsApp Business no celular, e acesso de administrador ao Meta Business da sua empresa (ou permissão para criar/vincular uma WABA).

​
Passo a passo

​
1. Abra Publicar

No dashboard: Agentes → escolha o agente → Publicar.

​
2. Configure o WhatsApp

  1. No card WhatsApp (badge Meta · Oficial), clique em Gerenciar
  2. Clique em Conectar com Meta
  3. No popup da Meta:
    • Faça login (se pedido)
    • Escolha ou crie o portfólio empresarial
    • Escolha ou crie a conta WhatsApp Business (WABA)
    • Adicione o número e confirme o código SMS no celular
    • Defina o nome comercial (display name)
    • Conclua até o fim (Concluir / Finish)

​
3. Ative o canal

Volte ao Publicar. Você deve ver Número vinculado com o Phone ID e o toast WhatsApp Business conectado! Ligue o interruptor do card WhatsApp para Ativo.

​
4. Teste

Do seu celular, envie uma mensagem (ex.: «Olá») para o número Business. O agente de IA deve responder em alguns segundos. A conversa aparece em Activity.

​
O que o Zenda faz automaticamente

Após você concluir o popup Meta, o Zenda:
  • Obtém o token de acesso do cliente
  • Registra o número na API Cloud (se ainda estiver pendente)
  • Inscreve sua conta WhatsApp nos webhooks do app
  • Salva as credenciais no agente de forma segura
Você não precisa:
  • Colar Phone Number ID ou Access Token
  • Configurar URL de webhook no painel Meta
  • Gerar token permanente manualmente

​
Reconectar ou trocar número

  1. Publicar → WhatsApp → Gerenciar
  2. Conectar com Meta novamente
  3. Escolha outra WABA ou número no fluxo Meta
Se o número já estava ativo na Meta, o Zenda detecta e não altera o que já funciona.

​
Cartão de crédito na Meta

Para enviar e receber mensagens em produção, a Meta exige um método de pagamento na conta WhatsApp Business. Adicione em business.facebook.com → configurações da WABA → pagamentos. A cobrança de conversas é feita pela Meta, não pelo Zenda.

​
Assumir conversa (operador humano)

  1. Na conversa em Activity, clique Assumir conversa — a IA para de responder.
  2. Digite e envie — a mensagem chega no WhatsApp do cliente como Operador.
  3. Use Devolver para IA para retomar automação.
Veja também Activity.

​
Validar se está tudo certo

Se o número aparecer Pendente na Meta por mais de 10 minutos após conectar, tente Conectar com Meta de novo ou fale com o suporte.

​
Problemas comuns

O Embedded Signup ainda não está habilitado no ambiente. Entre em contato com o suporte Zenda.
Confira se o canal WhatsApp está Ativo no Publicar, se o número está Conectado no WhatsApp Manager e se o chip não está vinculado ao WhatsApp pessoal.
Verifique fontes/indexação do agente, cota de mensagens do plano e se o inbound chegou em Activity.
Política Zenda + Meta: o agente só responde quando o cliente envia mensagem primeiro. Não há disparos proativos nem campanhas de marketing pelo Zenda. Respeite as políticas do WhatsApp Business.
Dúvidas: suporte@zendachat.com ou chat no dashboard.