Skip to main content

​
Configuração do Webhook

Receba eventos do WhatsApp em tempo real configurando um webhook na criação da instância.

​
Configurando

Ao criar uma instância, inclua o objeto webhook: 
curl -X POST https://grwthy.com/v1/instances \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: SUA_API_KEY" \
  -d '{
    "instanceName": "minha-loja",
    "phoneNumberId": "123456789012345",
    "accessToken": "EAAx...",
    "webhook": {
      "url": "https://meusite.com/webhook",
      "enabled": true,
      "events": ["messages.upsert", "messages.update"]
    }
  }'

​
Campos do Webhook

CampoTipoDescrição
urlstringURL que receberá os eventos via POST
enabledbooleanAtivar/desativar o webhook
eventsstring[]Eventos a receber (veja Eventos)
headersobjectHeaders customizados enviados em cada requisição

​
Fluxo de Processamento

Evento recebido do WhatsApp
         ↓
Verificação de assinatura (appSecret)
         ↓
   ┌─────┴─────┐
   ↓           ↓
Mensagem    Atualização
Recebida    de Status
   ↓           ↓
Registrada  Status atualizado
   ↓           ↓
Webhook     Webhook
disparado   disparado