> ## 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

> Configure webhooks para receber eventos do WhatsApp em tempo real

# 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](/api-reference/instances#criar-instância), inclua o objeto `webhook`:

```bash theme={null}
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

| Campo     | Tipo       | Descrição                                            |
| --------- | ---------- | ---------------------------------------------------- |
| `url`     | `string`   | URL que receberá os eventos via POST                 |
| `enabled` | `boolean`  | Ativar/desativar o webhook                           |
| `events`  | `string[]` | Eventos a receber (veja [Eventos](/webhooks/events)) |
| `headers` | `object`   | Headers 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
```