Skip to main content

​
Configuração do Webhook

Configure sua Meta App para enviar eventos do WhatsApp (mensagens recebidas e status de entrega) ao Grwthy.

​
1. Definir a URL do Webhook

No Painel da Meta App, navegue até: WhatsApp > Configuração > Webhook Defina a URL de callback para: 
https://grwthy.com/whatsapp/webhook

​
2. Definir o Token de Verificação

Use o webhookVerifyToken que você definiu ao criar a conta. A Meta enviará uma requisição de verificação para confirmar a propriedade: 
GET https://grwthy.com/whatsapp/webhook?hub.mode=subscribe&hub.verify_token=SEU_TOKEN&hub.challenge=STRING_DESAFIO
A API retorna o valor de hub.challenge para completar a verificação.

​
3. Assinar Eventos

Assine os seguintes campos do webhook:
CampoDescrição
messagesMensagens recebidas e atualizações de status de entrega

​
4. Verificar a Configuração

Envie uma mensagem de teste para o seu número WhatsApp. Você deverá ver:
  1. A mensagem recebida entregue ao seu webhook
  2. A mensagem disponível no histórico via GET /whatsapp/accounts/:id/messages

​
Como os Eventos São Processados

Meta Cloud API
      ↓
POST https://grwthy.com/whatsapp/webhook
      ↓
Verificação de assinatura (HMAC-SHA256)
      ↓
┌─────┴─────┐
↓           ↓
Mensagem    Atualização
Recebida    de Status
↓           ↓
Registrada  Status atualizado
e entregue  e entregue
  • Mensagens recebidas são verificadas, registradas e entregues para processamento
  • Atualizações de status (sent, delivered, read, failed) atualizam o registro correspondente da mensagem
  • Entregas com falha são retentadas automaticamente