Conectar WhatsApp Cloud API ao ChatSense
A integração via WhatsApp Cloud API é a forma recomendada: mais estável, sem risco de ban, com suporte a templates e métricas oficiais da Meta.
Pré-requisitos
- Conta Meta Business Suite verificada
- Aplicativo criado em
developers.facebook.com
- Número de telefone adicionado ao WhatsApp Business Platform (pode ser novo ou migrado)
Passo 1 — Obter o Phone Number ID
- Acesse
developers.facebook.com → seu app → WhatsApp → Configuração.
- Em Números de telefone, copie o ID do número de telefone (ex.:
123456789012345).
Passo 2 — Obter o Business Account ID (WABA ID)
Na mesma tela, copie o ID da conta do WhatsApp Business.
Passo 3 — Gerar Access Token permanente
⚠️ Importante: NÃO use o token temporário de teste. Gere um token permanente via Usuário do Sistema no Business Manager.
- Acesse
business.facebook.com → Configurações do Business → Usuários do Sistema.
- Crie um usuário do sistema com papel Admin.
- Clique em Gerar token, selecione seu app e as permissões:
| Permissão | Necessária para |
whatsapp_business_messaging | Enviar e receber mensagens |
whatsapp_business_management | Gerenciar templates e números |
Passo 4 — Configurar no ChatSense
- Vá em Admin → Canais → Adicionar → WhatsApp Cloud API.
- Preencha: Phone Number ID, Business Account ID e Access Token.
- Clique em Salvar. O ChatSense exibirá a Webhook URL e o Verify Token.
Passo 5 — Configurar Webhook no Meta
- No painel Meta Developer, vá em WhatsApp → Configuração → Webhooks.
- Cole a Webhook URL e o Verify Token copiados do ChatSense.
- Clique em Verificar e Salvar.
- Inscreva-se nos eventos:
messages, message_deliveries, message_reads.
Passo 6 — Testar
Envie uma mensagem para o número. Ela deve aparecer no inbox do ChatSense em até 5 segundos.