Ugrás a tartalomhoz
Ellenőrizve

Támogatási jegy megnyitása

Küldjön be jegyet a csomagjához tartozó ügyfélszolgálati pultnál kívülről, kódból, és kérdezze le, amíg valaki válaszol.

A ticket_api_submit jegyet nyit azon a pulton, amelyet az API-kulcsa csomagja birtokol, ugyanazon, amelyet az irányítópult Jegykezelés képernyője kezel. A ticket_api_get visszaolvas egyet, a nyilvános válaszokkal együtt, mindent, ami egy „lépjen kapcsolatba velünk" űrlap felépítéséhez kell, amelyet postafiók helyett valódi pult támogat.

Metódusok

POST/cpi/ticket_api_submit
user

API: Submit Ticket

External service: opens a ticket on the desk owned by the API key. Requires a plan with full API access.

POST/cpi/ticket_api_get
user

API: Get Ticket

External service: one ticket with its public interactions. Internal notes are never returned.

Végigvezető

A jegy beküldése

A name, az email és a details kötelező. Az e-mail egyben a névjegyzék-keresés is: ugyanarról a címről újra beküldve ugyanahhoz a kapcsolathoz kapcsolódik, ahogyan a kapcsolat hozzáadása is teszi.

curl -s https://xuda.ai/cpi/ticket_api_submit \
  -H 'content-type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "name": "Priya Shah",
    "email": "[email protected]",
    "subject": "Cannot export invoices",
    "details": "The export button on the invoices page does nothing.",
    "priority": 2
  }'
const res = await fetch('https://xuda.ai/cpi/ticket_api_submit', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    name: 'Priya Shah',
    email: '[email protected]',
    subject: 'Cannot export invoices',
    details: 'The export button on the invoices page does nothing.',
    priority: 2,
  }),
});
const { code, data } = await res.json();
if (code > 0) console.log(data.ticket_no, data.id);
import requests

res = requests.post(
    'https://xuda.ai/cpi/ticket_api_submit',
    json={
        'api_key': 'YOUR_API_KEY',
        'name': 'Priya Shah',
        'email': '[email protected]',
        'subject': 'Cannot export invoices',
        'details': 'The export button on the invoices page does nothing.',
        'priority': 2,
    },
)
body = res.json()
if body['code'] > 0:
    print(body['data']['ticket_no'], body['data']['id'])

2. Válasz lekérdezése

Mentse el a beküldő hívás data.id értékét, és olvassa vissza a ticket_api_get hívással, amikor csak mozgást szeretne ellenőrizni; az interactions mindig csak a nyilvános szálat hordozza, a pult belső jegyzetei kiszűrődnek, mielőtt ez a metódus válaszolna.

curl -s https://xuda.ai/cpi/ticket_api_get \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","ticket_id":"tkt_3b7a10982341"}'
const res = await fetch('https://xuda.ai/cpi/ticket_api_get', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', ticket_id: 'tkt_3b7a10982341' }),
});
const { code, data } = await res.json();
if (code > 0) console.log(data.status, data.interactions.length);
import requests

res = requests.post(
    'https://xuda.ai/cpi/ticket_api_get',
    json={'api_key': 'YOUR_API_KEY', 'ticket_id': 'tkt_3b7a10982341'},
)
body = res.json()
if body['code'] > 0:
    print(body['data']['status'], len(body['data']['interactions']))

A válasz

Mindkét metódus ugyanazt a szűk, külső használatra biztonságos jegynézetet adja vissza, tulajdonosazonosítók és belső állapot nélkül:

json
{
  "code": 1,
  "data": {
    "ticket_no": "TK-1042",
    "id": "tkt_3b7a10982341",
    "source": "api",
    "channel": "api",
    "status": "open",
    "status_stage": "new",
    "subject": "Cannot export invoices",
    "details": "The export button on the invoices page does nothing.",
    "topic": null,
    "subtopic": null,
    "requester": {
      "name": "Priya Shah",
      "email": "[email protected]",
      "phone": "",
      "company": ""
    },
    "reference_id": null,
    "priority": 2,
    "due_ts": null,
    "date_created_ts": 1737042311422,
    "last_activity_ts": 1737042311422,
    "status_ts": 1737042311422
  }
}

A ticket_api_get még egy kulcsot ad hozzá, az interactions tömböt { direction, from, channel, body, ts } elemekkel, szálsorrendben, üresen, amíg a pult valamelyik munkatársa (vagy a kérelmező, másik csatornán) nem válaszol.

Hibák

Következő