Evento de prueba (webhook.test)
Disparado bajo demanda vía POST /api/v1/webhook-endpoints/{id}/test — no es suscribible y no aparece en el catálogo de suscripción. La entrega recorre el pipeline real (cola, firma HMAC, captura de request/response, reintento) y se envía solo al endpoint objetivo, independientemente de la lista de eventos suscritos.
Úsalo para validar el consumidor de punta a punta antes del primer evento de negocio: firma, autenticación del request, parseo del envelope y el 2xx rápido.
webhook.test
{
"event": "webhook.test",
"timestamp": "2026-07-23T12:00:00.000Z",
"organizationId": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
"data": {
"test": true,
"endpointId": "9e1f3a5b-7d2c-4e6a-8b0f-5c7e9a1d3f5b",
"url": "https://example.com/webhooks/kobana",
"triggeredAt": "2026-07-23T12:00:00.000Z"
}
}
La respuesta del disparo (202 Accepted) trae eventId y deliveryId — sigue la entrega en GET /api/v1/webhook-endpoints/{id}/deliveries o en la pantalla de entregas. Si el endpoint está inactivo, el disparo falla con 409 ENDPOINT_INACTIVE.
Checklist de qué validar de tu lado:
- La firma
t=,v1=coincide y eltestá dentro de la tolerancia (Seguridad). - El consumidor responde
2xxen menos de 10 segundos. data.test === truese maneja sin efectos secundarios en tu sistema (no crees registros de negocio a partir de él).