Beta privada · apertura 23 de diciembre
Abre un ticket de soporte
POST /v1/soporte/tickets
Reporta un problema o propone una mejora. Basta una clave válida, así que un agente puede reportar lo que le falla; incluye el request_id. Te respondemos en el ticket. Nunca pegues claves, contraseñas ni certificados.
| Dato | Valor |
|---|---|
| Permiso | clave_valida |
| Cobro | No cobra. |
Idempotency-Key |
Opcional |
| Herramienta MCP | ticket_crear (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
Idempotency-Key |
header | No | 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. |
application/json, obligatorio. Los campos anidados van con punto y los de listas con []. No se aceptan campos desconocidos.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
asunto |
string | Sí | Qué pasa, en una línea. |
texto |
string | Sí | Detalle: qué hiciste, qué esperabas y qué pasó, con el request_id si lo tienes. Nunca pegues claves ni contraseñas. |
categoria |
“soporte” | “mejora” | “facturacion” | “seguridad” | No | Si no la envías, soporte. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl -X POST "https://api-sandbox.opennexum.com/v1/soporte/tickets" \ -H "Authorization: Bearer onx_test_…" \ -H "Content-Type: application/json" \ -d '{ "asunto": "texto", "texto": "texto"}'Respuestas
Sección titulada «Respuestas»Ticket abierto.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
id |
string | Sí | Identificador que empieza con tkt_. |
asunto |
string | Sí | |
categoria |
“soporte” | “mejora” | “facturacion” | “seguridad” | Sí | soporte: algo no funciona · mejora: una idea · facturacion: saldo o facturas · seguridad: un riesgo. |
estado |
“abierto” | “en_revision” | “respondido” | “escalado” | “cerrado” | Sí | abierto espera respuesta; respondido espera la tuya; cerrado ya no recibe mensajes. |
creado_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
actualizado_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
cerrado_en |
string (date-time) | null | Sí | |
mensajes |
object[] | Sí | Del más antiguo al más nuevo. |
mensajes[].id |
string | Sí | Identificador que empieza con tkm_. |
mensajes[].autor |
“cliente” | “soporte” | “claude” | Sí | cliente: tú; soporte: una persona de OpenNexum; claude: el asistente de soporte. |
mensajes[].texto |
string | Sí | |
mensajes[].creado_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 409
idempotencia_en_conflicto - 409
solicitud_en_curso - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible