Crear y seguir casos por API
Las peticiones para crear un caso, agregar respuestas, consultar su estado, descargar adjuntos y contestar la encuesta desde tu sistema.
En esta página
Con la URL para crear casos de un canal, tu servidor crea y sigue casos en la mesa. Todas las peticiones van firmadas: lee Firmar las peticiones.
En esta página, {URL} es la URL del canal, por ejemplo https://api-itsm.argunis.com/api/public/cases/v1/AbC….
Crear un caso
POST {URL}/cases con este cuerpo JSON:
{
"externalId": "7c1e0b9a-4f1d-4a51-9a3e-2d5b8f0c1a22",
"subject": "No puedo exportar el reporte mensual",
"description": "Al presionar Exportar aparece un error.",
"kind": "incident",
"urgency": 2,
"impact": 2,
"category": "Reportes",
"requester": { "email": "ana@cliente.cl", "name": "Ana Pérez", "phone": "+56 9 1234 5678" },
"company": { "name": "Cliente SpA", "taxId": "76.123.456-7" },
"context": { "pantalla": "/reportes/mensual", "version": "4.2.1", "navegador": "Chrome 141" },
"attachments": [{ "filename": "error.png", "contentType": "image/png", "dataBase64": "iVBORw0KGgo…" }]
}Campo | Obligatorio | Uso |
|---|---|---|
| sí | El identificador del caso en tu sistema (hasta 100 caracteres: letras, números y |
| sí | Asunto, de 3 a 200 caracteres. |
| no | Detalle, hasta 20.000 caracteres. |
| no |
|
| no | 1 alta, 2 media, 3 baja. Si faltan, los del canal. |
| no | Nombre de una categoría de la mesa. Si no calza, la del canal. |
| sí | Correo y nombre de quien pide ayuda. El teléfono es opcional. |
| no | Empresa del solicitante: nombre y RUT. |
| no | Hasta 20 datos de texto que ayudan al equipo (pantalla, versión, navegador). Se agregan al final de la descripción. |
| no | Hasta 5 archivos de 5 MB cada uno, en base64. Se aceptan los mismos tipos que en los tickets. |
Respuestas:
Código | Significado |
|---|---|
201 | Caso creado. Trae |
200 | Ya existía un caso con ese |
400 | Algún campo no es válido; |
403 | El solicitante no está permitido por el canal. |
Genera el externalId antes de enviar y guárdalo. Si la red falla, reintenta con el mismo externalId y un webhook-id nuevo: nunca se duplica el caso.
El caso que responde Elion ITSM
{
"case": {
"number": "INC-000123",
"externalId": "7c1e0b9a-4f1d-4a51-9a3e-2d5b8f0c1a22",
"subject": "No puedo exportar el reporte mensual",
"state": "in_progress",
"stateLabel": "En revisión",
"waitingOn": "team",
"priority": "P3",
"createdAt": "2026-10-13T14:02:11.000Z",
"updatedAt": "2026-10-13T14:20:45.000Z",
"resolvedAt": null,
"closedAt": null,
"resolution": null,
"assignee": { "name": "Carla Soto" },
"csatPending": false,
"publicMessages": [
{ "id": "981", "side": "agent", "author": "Carla Soto", "body": "Hola Ana, ¿qué formato elegiste?", "at": "2026-10-13T14:20:45.000Z", "attachments": [] }
]
}
}stateLabelya está escrito para el solicitante: Recibida, En revisión, Esperando tu respuesta, Resuelta, Cerrada, Cancelada.waitingOndice quién tiene que actuar:team(el equipo),requester(el solicitante) onullsi terminó.publicMessagestrae solo la conversación con el solicitante, los últimos 200 mensajes. Nunca las notas internas del equipo.bodyes texto plano: muéstralo como texto, no como HTML.
Consultar un caso
GET {URL}/cases/{ref}, donde {ref} es el número (INC-000123) o tu externalId. Responde { "case": … }. Solo encuentra casos creados por ese canal.
Responder
POST {URL}/cases/{ref}/replies:
{ "body": "Elegí PDF.", "author": { "email": "ana@cliente.cl", "name": "Ana Pérez" }, "attachments": [] }Cuenta como una respuesta del solicitante: si el equipo lo tenía en espera de su respuesta, el caso vuelve a En curso, y si estaba Resuelto, se reabre. Un caso Cerrado responde 409: hay que crear uno nuevo.
Descargar un adjunto
GET {URL}/cases/{ref}/attachments/{id}, con el id que viene en publicMessages. Solo entrega adjuntos de la conversación pública del caso.
Contestar la encuesta
Cuando csatPending es true, POST {URL}/cases/{ref}/csat:
{ "score": 5, "comment": "Rápido y claro." }score va de 1 a 5. Si no hay una encuesta pendiente, responde 409.