Saltar al contenido
Verificada

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

POST/cpi/ticket_api_list
user

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.

curl -s https://xuda.ai/cpi/ticket_api_list \
  -H 'content-type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "status": "open",
    "sort": "last_activity_ts",
    "dir": "desc",
    "limit": 25
  }'
const res = await fetch('https://xuda.ai/cpi/ticket_api_list', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    status: 'open',
    sort: 'last_activity_ts',
    dir: 'desc',
    limit: 25,
  }),
});
const { code, data, bookmark } = await res.json();
if (code > 0) for (const t of data) console.log(t.ticket_no, t.status, t.subject);
import requests

res = requests.post(
    'https://xuda.ai/cpi/ticket_api_list',
    json={
        'api_key': 'YOUR_API_KEY',
        'status': 'open',
        'sort': 'last_activity_ts',
        'dir': 'desc',
        'limit': 25,
    },
)
body = res.json()
if body['code'] > 0:
    for t in body['data']:
        print(t['ticket_no'], t['status'], t['subject'])

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).

curl -s https://xuda.ai/cpi/ticket_api_list \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","status":"open","limit":25,"bookmark":"g1AAAABweJzLYWBg..."}'
const res = await fetch('https://xuda.ai/cpi/ticket_api_list', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', status: 'open', limit: 25, bookmark: previousBookmark }),
});
import requests

res = requests.post(
    'https://xuda.ai/cpi/ticket_api_list',
    json={'api_key': 'YOUR_API_KEY', 'status': 'open', 'limit': 25, 'bookmark': previous_bookmark},
)

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:

json
{
  "code": 1,
  "data": [
    {
      "ticket_no": "TK-1042",
      "id": "tkt_3b7a10982341",
      "status": "open",
      "status_stage": "new",
      "subject": "Cannot export invoices",
      "requester": { "name": "Priya Shah", "email": "[email protected]", "phone": "", "company": "" },
      "priority": 2,
      "last_activity_ts": 1737042311422
    }
  ],
  "bookmark": "g1AAAABweJzLYWBg..."
}

Un array data vacío es una respuesta real y correcta para un servicio sin nada que coincida con el filtro, no un error.

Errores

Siguiente