Tickets

Crear casos con SLA desde tu propio sistema.

GET/v1/ticketstickets:read

Lista tickets ordenados por actualización.

Campo	Tipo	Descripción
`status`	"open" \| "in_progress" \| "waiting" \| "resolved"	Filtra por estado.

POST/v1/ticketstickets:write

Crea un ticket. El SLA se calcula según la prioridad.

Campo	Tipo	Descripción
`subject`requerido	string	De 3 a 200 caracteres.
`description`	string	Hasta 5000 caracteres.
`contact_id`requerido	string	Contacto del workspace. Devuelve 422 si no existe.
`priority`	"low" \| "normal" \| "high" \| "urgent"	Por defecto `normal`.
`conversation_id`	string	Vincula el ticket a una conversación.
`tags`	string[]	Etiquetas.

GET/v1/tickets/{id}tickets:read

Busca por id o por número (#1042).

GET/v1/tickets/{id}/notestickets:read

Notas internas del ticket. Nunca las ve el cliente.

POST/v1/tickets/{id}/notestickets:write

Agrega una nota interna, por ejemplo el resultado de un chequeo automático.

Campo	Tipo	Descripción
`body`requerido	string	Texto de la nota, hasta 5000 caracteres.
`author_id`	string	Miembro que figura como autor. Por defecto, la integración.

Crear un ticket

curl -X POST https://api.tinkay.app/v1/tickets \  -H "Authorization: Bearer dk_live_xxx" \  -H "Content-Type: application/json" \  -d '{    "subject": "Error 500 al exportar facturas",    "description": "El cliente reporta un 500 en /export desde las 14:20.",    "contact_id": "ct_8f2a91",    "priority": "high",    "tags": ["bug", "exportacion"]  }'

El SLA se define por prioridad: urgente 2 horas, alta 8 horas, normal y baja 24 horas.