DocumentaciónAyuda

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

externalId

sí

El identificador del caso en tu sistema (hasta 100 caracteres: letras, números y . _ : -). Si repites un externalId, Elion ITSM responde con el caso que ya existe en vez de crear otro.

subject

sí

Asunto, de 3 a 200 caracteres.

description

no

Detalle, hasta 20.000 caracteres.

kind

no

incident (algo no funciona) o request (una consulta o pedido). Si falta, el del canal.

urgency, impact

no

1 alta, 2 media, 3 baja. Si faltan, los del canal.

category

no

Nombre de una categoría de la mesa. Si no calza, la del canal.

requester

sí

Correo y nombre de quien pide ayuda. El teléfono es opcional.

company

no

Empresa del solicitante: nombre y RUT.

context

no

Hasta 20 datos de texto que ayudan al equipo (pantalla, versión, navegador). Se agregan al final de la descripción.

attachments

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 { "case": … }.

200

Ya existía un caso con ese externalId; trae ese caso.

400

Algún campo no es válido; error.details dice cuál.

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": [] }
    ]
  }
}
  • stateLabel ya está escrito para el solicitante: Recibida, En revisión, Esperando tu respuesta, Resuelta, Cerrada, Cancelada.

  • waitingOn dice quién tiene que actuar: team (el equipo), requester (el solicitante) o null si terminó.

  • publicMessages trae solo la conversación con el solicitante, los últimos 200 mensajes. Nunca las notas internas del equipo.

  • body es 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.

Relacionado

Buscar en Elion ITSM

Escribe al menos 2 letras para buscar en Elion ITSM.

↑↓ moverse · Enter abrir · Esc cerrar