Naar de inhoud springen
Geverifieerd

Supporttickets opvragen

Haal de wachtrij van de helpdesk naar je eigen product, gefilterd, gesorteerd en in pagina's.

ticket_api_list is dezelfde gefilterde, gesorteerde en gepagineerde leesaanroep die de helpdeskbeheerder zelf gebruikt, beperkt tot de eigen helpdesk van je API-sleutel en nooit met tickets van een andere tenant. Elk veld is optioneel; een leeg verzoek toont alles, met de nieuwste activiteit eerst.

Methode

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.

Stappenplan

Opvragen, gefilterd

Combineer status, topic_id, reference_id en vrije tekst search zoals je scherm ze nodig heeft; sort is een van date_created_ts, last_activity_ts, status_ts of priority, dir is asc of 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. Ga naar de volgende pagina

Geef de bookmark van het vorige antwoord terug als bookmark om voorbij limit door te gaan (tot 500 per aanroep, het eigen gedeclareerde plafond van het veld).

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},
)

Het antwoord

data is een array met dezelfde smalle ticketweergave die open een supportticket teruggeeft (hier geen interactions, dit is de lijst en niet de detailaanroep), en bookmark staat ernaast, op het hoogste niveau en niet binnen 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..."
}

Een lege array data is een echt, geslaagd antwoord voor een helpdesk waar niets aan het filter voldoet, geen fout.

Fouten

Volgende stap