Ir al contenido

Beta privada · apertura 23 de diciembre

Lista tus webhooks

GET /v1/conecta/webhooks

Webhooks registrados, sus eventos y su estado. Nunca devuelve el secreto.

Dato Valor
Permiso conecta:leer
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP webhook_listar (Próximamente)
Nombre En Requerido Tipo Descripción
cursor query No string Cursor opaco que devolvió la página anterior en siguiente_cursor.
limite query No integer Cuántos elementos traer (1 a 100; por defecto 20).
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl "https://api-sandbox.opennexum.com/v1/conecta/webhooks" \
-H "Authorization: Bearer onx_test_…"

Página de webhooks.

Campo Tipo Requerido Descripción
elementos object[] Sí
elementos[].id string Sí Identificador que empieza con whk_.
elementos[].url string (uri) Sí URL pública con https (sin IP literal, localhost, dominios internos ni usuario y clave).
elementos[].eventos “mensaje.recibido” | “mensaje.estado” | “conexion.estado” | “plantilla.estado”[] Sí
elementos[].descripcion string | null Sí
elementos[].estado “activo” | “pausado” Sí Se pausa solo si tu endpoint falla muchas veces seguidas.
elementos[].creado_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
elementos[].secreto_rotado_en string (date-time) | null Sí
siguiente_cursor string | null Sí Pásalo como cursor para la página siguiente; null si ya no hay más.

Cada código tiene su explicación en Errores.