Tickets
Un ticket es un caso abierto sobre un contacto (contact_id), con título, descripción, fecha límite (deadline) y un usuario del equipo responsable (user_id).
Un ticket es un caso abierto sobre un contacto (contact_id), con título, descripción, fecha límite (deadline) y un usuario del equipo responsable (user_id). Se puede crear, editar, reasignar, cerrar y reabrir, y listar por estado o por usuario. Si tu sistema detecta un reclamo, empezá por Crear un ticket; los IDs de usuario salen de Listar agentes.
Endpoints
Listar tickets
GET /api/v1/tickets · Sirve para listar los tickets de la cuenta filtrando por estado o por usuario asignado, por ejemplo para armar una vista de casos pendientes.
Crear un ticket
POST /api/v1/tickets · Usalo para abrir un ticket sobre un contacto (título y descripción) y asignárselo a un usuario del equipo, por ejemplo cuando tu sistema detecta un reclamo.
Ver un ticket
GET /api/v1/tickets/{id} · Sirve para ver un ticket con su contacto, su responsable, la descripción y la fecha límite.
Actualizar un ticket
PUT /api/v1/tickets/{id} · Usalo para corregir o ampliar el título y la descripción de un ticket.
Asignar tickets
POST /api/v1/tickets/assign · Sirve para reasignar un ticket a otro usuario del equipo.
Cerrar un ticket
POST /api/v1/tickets/{id}/close · Usalo para cerrar un ticket cuando el caso quedó resuelto.
Reabrir un ticket
POST /api/v1/tickets/{id}/reopen · Sirve para reabrir un ticket cerrado si el caso vuelve a necesitar atención.