← Volver al índice de esquemas
WebhookDelivery
Recurso JSON:API de una entrega de webhook, con receptor, intento, respuesta y estado.
ExtiendeJsonApiResourceBase
Propiedades
| Campo | Tipo | Descripción |
|---|---|---|
type* | string | Tipo de recurso JSON:API. Siempre `webhook_delivery`. |
id* | string | Identificador autoincremental de la entrega. |
attributes* | object | Datos de la entrega webhook (endpoint receptor, intento, respuesta y estado). |
endpoint_id* | string (uuid) | Identificador único del endpoint webhook (UUID v4) que originó esta entrega. |
endpoint_url | string | URL receptora del webhook (endpoint). Solo presente en el listado global (`GET /v1/webhooks/deliveries`). |
event_type* | string | Tipo de evento que originó la entrega. Determina la forma del cuerpo firmado con HMAC que recibe el receptor. Las entregas sintéticas (envío de prueba) se marcan como `test`. |
validation_id* | string | null | Identificador único de la validación (UUID v4) asociada cuando el evento es `validation.*`. `null` cuando el evento es otro. |
response_status* | integer | null | Código de estado HTTP con el que respondió el endpoint webhook receptor. `null` cuando la entrega no llegó a establecer respuesta (tiempo de espera agotado o bloqueo). |
response_body* | string | null | Cuerpo de la respuesta del endpoint webhook receptor, truncado a 500 caracteres. |
response_time_ms* | integer | null | Duración de la petición de entrega (en milisegundos). |
attempt* | integer | Número del intento. `1` es el primer envío; los mayores, reintentos. |
status* | string | Estado actual de la entrega — `pending`: Aún sin entregar; `retrying`: Se pospuso por el límite de salida y Messenger la reintentará; `success`: Entregada; `failed`: El último intento falló; Messenger puede programar otro si el fallo es recuperable. |
next_retry_at* | TimestampUTC | null | Fecha y hora del próximo reintento persistido, en ISO 8601 UTC. `null` cuando no hay una fecha almacenada; los reintentos que programa Messenger no persisten esta fecha en la entrega. |
error_message* | string | null | Detalle de error del transporte o del bloqueo de la entrega. `null` cuando no hay un detalle de error, incluso si el receptor respondió con un estado fuera de `2xx`. |
created_at* | string (date-time) | Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo, `"2026-05-01T05:14:38Z"`. Los campos `*_at`, `*_end`, `*_start` y `*_date` adoptan esta forma. `meta.datetime` describe el mismo contrato en la respuesta. |
Usado en operaciones
GET /v1/webhooks/{id}/deliveriesGET /v1/webhooks/deliveries