# Ver erros do webhook global

`GET /globalwebhook/errors`

Pasta: **Administração**

## Autenticação

```http
admintoken: {{adminToken}}
```

## Descrição

# Ver erros do webhook global

Lista as falhas recentes de entrega dos webhooks globais. Use para diagnosticar URLs fora do ar, timeouts e respostas HTTP inválidas.

## Endpoint

`GET {{baseUrl}}/globalwebhook/errors`

## Autenticação

Envie o token de administrador no header `admintoken: {{adminToken}}`.

## 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}}/globalwebhook/errors?limit=100' \
  --header 'admintoken: {{adminToken}}'
```

## Resposta de Sucesso

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

## Erros comuns

- `401 Unauthorized`: `admintoken` ausente ou inválido.
- `500 Internal Server Error`: falha ao consultar o banco de erros.

## Query

- `limit` = `100`

## cURL

```bash
curl -X GET "{{baseUrl}}/globalwebhook/errors" \
  -H "admintoken: {{adminToken}}"
```

---

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