Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.grwthy.com/llms.txt

Use this file to discover all available pages before exploring further.

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