Integração WhatsApp

Conecte um agente a um número WhatsApp Business via Meta Cloud API oficial.

Sim, a integração está disponível e funcional.

Toda mensagem recebida no número vira uma conversa persistente do agente. O agente responde automaticamente dentro da janela de 24h da Meta (fora dessa janela, a Meta exige templates aprovados).

1

Habilitar o plugin

Vá em Plugins e ative Canal WhatsApp. Isso libera a aba Canais na configuração de cada agente.

2

Criar App na Meta for Developers

  1. Acesse developers.facebook.com/apps e crie um novo App do tipo Business.
  2. No painel do App, adicione o produto WhatsApp.
  3. Vincule (ou crie) uma Meta Business Account ao App.
3

Obter Phone Number ID e Business Account ID

No App Meta → WhatsApp → API Setup, você verá:

  • Phone number ID — o identificador do número (não é o telefone em si).
  • WhatsApp Business Account ID — logo abaixo, identifica a conta WABA.

Para produção, adicione seu próprio número de telefone em WhatsApp → Phone Numbers. O número de teste da Meta só envia mensagens a destinatários pré-cadastrados.

4

Gerar um Access Token permanente (System User)

  1. Em Business Settings → Users → System Users, crie um System User com papel de Admin.
  2. Atribua o App e a WABA a esse System User com permissão Full control.
  3. Clique em Generate new token, selecione o App e marque os escopos whatsapp_business_messaging e whatsapp_business_management. Escolha token never expire.
  4. Guarde o token gerado — ele só é mostrado uma vez.

Tokens de usuário curtos (24h) também funcionam para testar, mas expiram — use System User em produção.

5

Preencher os campos no AgentMembers

Vá em Agentes → (seu agente) → Canais → WhatsApp e preencha:

  • Access Token — o token permanente do passo 4.
  • Phone Number ID e Business Account ID — do passo 3.
  • Verify Token — qualquer string secreta que você inventa (ex.: meuAgente-abc123). Será usada no próximo passo.

Clique em Salvar. O AgentMembers valida o token chamando a Meta e mostra o número verificado.

6

Configurar o Webhook na Meta

  1. Copie a URL do Callback exibida no card do canal (após salvar).
  2. Na Meta, vá em WhatsApp → Configuration → Webhook → Edit.
  3. Cole a URL em Callback URL e o mesmo Verify Token do passo 5.
  4. Clique em Verify and save. A Meta bate um GET na URL e valida o handshake.
  5. Em Webhook fields, inscreva-se em messages.
7

Testar

Envie uma mensagem para o número do WhatsApp Business. Em segundos o agente responde e a conversa aparece em Conversas. Erros de envio (token inválido, fora da janela de 24h) aparecem no card do canal em last_error.

Limitações da Meta

  • Janela de 24h: respostas livres só saem se o usuário mandou algo nas últimas 24h. Fora disso, apenas templates aprovados pela Meta.
  • Números de teste: só falam com destinatários pré-cadastrados no App.
  • Somente texto: por ora o agente recebe e responde texto. Mídia (imagem/áudio/documento) é ignorada silenciosamente.