Ir al contenido

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)
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.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
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"
}'

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).

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