ChatSense
Canais whatsapp cloud api meta webhook

Conectar WhatsApp via Cloud API: Phone Number ID, Token e Webhook

CANAIS WhatsApp Cloud API Instagram DM Telegram Chat Widget CONFIGURAÇÃO — WhatsApp Cloud API Phone Number ID 1234567890 Access Token EAABs•••••••••••• Webhook URL (copie para o Meta) https://api.chatsense.app/webhook/wa/...
Configuração do canal WhatsApp Cloud API

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

  1. Acesse developers.facebook.com → seu app → WhatsApp → Configuração.
  2. 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.
  1. Acesse business.facebook.com → Configurações do Business → Usuários do Sistema.
  2. Crie um usuário do sistema com papel Admin.
  3. Clique em Gerar token, selecione seu app e as permissões:
PermissãoNecessária para
whatsapp_business_messagingEnviar e receber mensagens
whatsapp_business_managementGerenciar templates e números

Passo 4 — Configurar no ChatSense

  1. Vá em Admin → Canais → Adicionar → WhatsApp Cloud API.
  2. Preencha: Phone Number ID, Business Account ID e Access Token.
  3. Clique em Salvar. O ChatSense exibirá a Webhook URL e o Verify Token.

Passo 5 — Configurar Webhook no Meta

  1. No painel Meta Developer, vá em WhatsApp → Configuração → Webhooks.
  2. Cole a Webhook URL e o Verify Token copiados do ChatSense.
  3. Clique em Verificar e Salvar.
  4. 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.