> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Logs de Entrega de Webhook

> Recuperar tentativas de entrega e respostas para um webhook do agente

# Listar Logs de Entrega de Webhook

Recupera uma lista paginada de tentativas de entrega para um webhook específico, incluindo status HTTP, corpo da resposta, número da tentativa e tempo. Use estes logs para depurar problemas de entrega de webhook.

## Endpoint

```
GET /api/v1/agents/{agent_id}/webhooks/{webhook_id}/logs
```

## Parâmetros de caminho

<ParamField path="agent_id" type="string" required>UUID do agente.</ParamField>
<ParamField path="webhook_id" type="string" required>UUID do webhook.</ParamField>

## Parâmetros de consulta

<ParamField query="per_page" type="integer">Itens por página. Faixa: `1`–`100`. Padrão: `25`.</ParamField>
<ParamField query="page" type="integer">Número da página. Padrão: `1`.</ParamField>

## Cabeçalhos da requisição

<ParamField header="Authorization" type="string" required>
  Token Bearer. Formato: `Bearer talq_your_environment_token_here`
</ParamField>

## Exemplos

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/agents/agent-uuid/webhooks/webhook-uuid/logs?per_page=50" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```
</RequestExample>

## Resposta

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "log-uuid-1",
        "webhook_id": "webhook-uuid",
        "event": "event_phone_call_ended",
        "attempt": 1,
        "status": "success",
        "http_status": 200,
        "request_payload": {"call_id": "call-uuid", "duration": 45},
        "response_body": "{\"received\":true}",
        "response_headers": {"content-type": "application/json"},
        "duration_ms": 142,
        "delivered_at": "2024-01-15T11:00:01Z",
        "created_at": "2024-01-15T11:00:00Z"
      },
      {
        "id": "log-uuid-2",
        "webhook_id": "webhook-uuid",
        "event": "event_phone_call_started",
        "attempt": 3,
        "status": "failed",
        "http_status": 500,
        "error": "Internal Server Error",
        "duration_ms": 8021,
        "created_at": "2024-01-15T10:55:00Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 50,
      "total": 247,
      "last_page": 5
    }
  }
  ```
</ResponseExample>

### Valores de Status do Log

* `pending` — enfileirado para entrega
* `success` — entregue, alvo respondeu com 2xx
* `failed` — entregue mas o alvo respondeu com não-2xx, ou conexão falhou
* `retrying` — falhou, será retentado de acordo com `max_retries`

## Observações

* Os logs são retidos por 30 dias.
* Entregas com falha podem ser retentadas manualmente via [Retentar Log de Webhook](/api-reference/endpoints/retry-webhook-log).
* Cada tentativa de retry cria uma nova entrada de log com `attempt` incrementado.