# Ver erros do webhook da instância

`GET /webhook/errors`

Pasta: **Webhooks e SSE**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Ver erros do webhook da instância

Lista falhas recentes de entrega dos webhooks desta instância. Use para diagnosticar endpoint fora do ar, timeouts e respostas inválidas.

## Endpoint

`GET {{baseUrl}}/webhook/errors`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Parâmetros

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `limit` | integer | Não | Máximo de registros (padrão `100`, teto `500`). |

## Exemplo de Requisição

```bash
curl --request GET '{{baseUrl}}/webhook/errors?limit=100' \
  --header 'token: {{token}}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "errors": [
    {
      "id": "uuid-erro",
      "webhook_id": "uuid-webhook",
      "instance_id": "uuid-instancia",
      "category": "messages",
      "attempt": 2,
      "error": "timeout",
      "url": "https://seu-servidor.com/webhook"
    }
  ]
}
```

## Erros comuns

- `401 Unauthorized`: header `token` ausente ou inválido.
- `500 Internal Server Error`: falha ao consultar erros.

## Query

- `limit` = `100`

## cURL

```bash
curl -X GET "{{baseUrl}}/webhook/errors" \
  -H "token: {{token}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=webhooks-e-sse/ver-erros-do-webhook-da-instancia)