Ir al contenido

Beta privada · apertura 23 de diciembre

Rota el secreto de un webhook

POST /v1/conecta/webhooks/{id}/rotar-secreto

Genera un secreto nuevo. Durante 24 horas firmamos con los dos (dos v1 en la cabecera) para que cambies el tuyo sin perder eventos.

Dato Valor
Permiso webhooks:administrar
Cobro No cobra.
Idempotency-Key Obligatoria
Herramienta MCP No se ofrece a agentes.
Nombre En Requerido Tipo Descripción
id path Sí string Identificador que empieza con whk_.
Idempotency-Key header Sí string Identifica una operación para que repetirla no la duplique. Si repites la petición con la misma clave y el mismo cuerpo, recibes la misma respuesta; con otro cuerpo, idempotencia_en_conflicto. Se guarda 24 horas.
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 -X POST "https://api-sandbox.opennexum.com/v1/conecta/webhooks/whk_8f2c1a7d9e/rotar-secreto" \
-H "Authorization: Bearer onx_test_…" \
-H "Idempotency-Key: $(uuidgen)"

Secreto nuevo; guárdalo ahora.

Campo Tipo Requerido Descripción
webhook object Sí Webhook de tu sistema.
webhook.id string Sí Identificador que empieza con whk_.
webhook.url string (uri) Sí URL pública con https (sin IP literal, localhost, dominios internos ni usuario y clave).
webhook.eventos “mensaje.recibido” | “mensaje.estado” | “conexion.estado” | “plantilla.estado”[] Sí
webhook.descripcion string | null Sí
webhook.estado “activo” | “pausado” Sí Se pausa solo si tu endpoint falla muchas veces seguidas.
webhook.creado_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
webhook.secreto_rotado_en string (date-time) | null Sí
secreto string Sí Secreto para verificar X-Nexum-Signature. Se muestra solo esta vez.
secreto_anterior_vence_en string (date-time) Sí Hasta entonces firmamos con los dos secretos.

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