Listar tickets de soporte
Trae la cola del servicio a tu propio producto, filtrada, ordenada y paginada.
ticket_api_list es la misma lectura filtrada, ordenada y paginada que usa el propio gestor del servicio, limitada al servicio de tu propia clave de API y sin incluir nunca los tickets de otro inquilino. Todos los campos son opcionales; una petición vacía lista todo, con la actividad más reciente primero.
Método
API: List Tickets
External service: lists tickets on the desk owned by the API key, with the same filters as the manager.
Paso a paso
Lista, con filtros
Combina status, topic_id, reference_id y el texto libre search como necesite tu pantalla; sort es uno de date_created_ts, last_activity_ts, status_ts o priority, y dir es asc o desc.
2. Pasa de página
Devuelve el bookmark de la respuesta anterior como bookmark para continuar más allá de limit (hasta 500 por llamada, el tope declarado del propio campo).
La respuesta
data es un array de la misma vista de ticket acotada que devuelve abrir un ticket de soporte (aquí sin interactions, esto es la lista, no la lectura de detalle), y bookmark va a su lado, en el nivel superior, no dentro de data:
Un array data vacío es una respuesta real y correcta para un servicio sin nada que coincida con el filtro, no un error.