Entregas de webhooks

Muestra el historial de entregas de los webhooks de Developer, de la más reciente a la más antigua: el evento, si el servidor respondió bien, el código HTTP, el número de intento y el error. Es lo primero que se revisa cuando un sistema externo "no recibe los eventos".

bash

01plazbot webhooks deliveries [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Webhook	`--webhook <id>`	No	Solo las entregas de un webhook (`whe_...`).
Fallidas	`--failed`	No	Solo las entregas fallidas.
Evento	`--event <type>`	No	Solo un tipo de evento.
Últimas horas	`--since-hours <n>`	No	Solo las últimas N horas (máximo `720`, 30 días).
Límite	`--limit <n>`	No	Máximo de entregas (máximo `100`). Por defecto `50`.
Cursor	`--cursor <timestamp>`	No	Solo entregas anteriores a esta fecha: el `nextCursor` de la llamada anterior.
Workspace	`-w, --workspace <id>`	No	Workspace donde se ejecuta. Por defecto, el activo.
Zona	`-z, --zone <zone>`	No	`LA` o `EU`. Por defecto, la zona de la sesión.
JSON	`--json`	No	Imprime el resultado como JSON.

Con --json la salida es { "data": [...], "nextCursor": "..." | null }. Aquí nextCursor es la fecha de la última entrega devuelta; pásala a --cursor para traer las anteriores. Más detalles en Scripting y agentes de IA.

Ejemplos

bash

01# Entregas fallidas de las últimas 24 horas
02plazbot webhooks deliveries --failed --since-hours 24
03 
04# Entregas de un webhook, en JSON
05plazbot webhooks deliveries --webhook whe_AbcDef123 --json
06 
07# Página siguiente
08plazbot webhooks deliveries --cursor "2026-10-08 09:59:40"

Resultado

text

01  Deliveries (2)
02  ────────────────────────────────────────
03┌─────────────────────┬───────────────┬──────────────────┬────────────┬─────────┬──────────────────┐
04│ Date (UTC)          │ Webhook       │ Event            │ Result     │ Attempt │ Error            │
05├─────────────────────┼───────────────┼──────────────────┼────────────┼─────────┼──────────────────┤
06│ 2026-10-08 10:02:11 │ whe_AbcDef123 │ message.received │ ok 200     │ 1       │ —                │
07├─────────────────────┼───────────────┼──────────────────┼────────────┼─────────┼──────────────────┤
08│ 2026-10-08 09:59:40 │ whe_AbcDef123 │ contact.created  │ failed 500 │ 2       │ Internal Server… │
09└─────────────────────┴───────────────┴──────────────────┴────────────┴─────────┴──────────────────┘

Salida JSON

json

01{
02  "data": [
03    {
04      "timestamp": "2026-10-08 09:59:40",
05      "endpoint_id": "whe_AbcDef123",
06      "event_id": "evt_AbcDef123",
07      "delivery_id": "dlv_AbcDef123",
08      "event_type": "contact.created",
09      "attempt": 2,
10      "is_resend": 0,
11      "success": 0,
12      "status_code": 500,
13      "duration_ms": 1240,
14      "error": "Internal Server Error",
15      "message_id": null
16    }
17  ],
18  "nextCursor": "2026-10-08 09:59:40"
19}

Errores comunes

Mensaje	Causa	Solución
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot login`.
`Destino inválido.`	El ID de `--webhook` no tiene un formato válido.	Usa el ID de `plazbot webhooks list`.
`Cursor inválido.`	`--cursor` no es una fecha válida.	Usa el `nextCursor` de la llamada anterior tal cual.
`No se pudo consultar el historial de entregas.`	El servicio de historial no respondió.	Intenta de nuevo en unos minutos.