Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Άνοιγμα αιτήματος υποστήριξης

Υποβάλετε ένα αίτημα στο γραφείο του πλάνου σας από εξωτερικό κώδικα, και ελέγχετε περιοδικά μέχρι να απαντήσει κάποιος.

Το ticket_api_submit ανοίγει ένα αίτημα στο γραφείο που κατέχει το πλάνο του κλειδιού API σας, το ίδιο γραφείο που διαχειρίζεται η οθόνη Ticketing του πίνακα ελέγχου. Το ticket_api_get διαβάζει ένα πίσω, μαζί με τις δημόσιες απαντήσεις, δηλαδή όλα όσα χρειάζεστε για να χτίσετε μια φόρμα «επικοινωνήστε μαζί μας» που στηρίζεται σε πραγματικό γραφείο αντί για γραμματοκιβώτιο.

Μέθοδοι

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.

Οδηγός βήμα προς βήμα

Υποβάλετε το αίτημα

Τα name, email και details είναι υποχρεωτικά. Το email λειτουργεί και ως αναζήτηση στο βιβλίο επαφών: η νέα υποβολή από την ίδια διεύθυνση συνδέεται με την ίδια επαφή, όπως κάνει η προσθήκη επαφής.

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. Ελέγξτε περιοδικά για απάντηση

Αποθηκεύστε το data.id από την κλήση υποβολής και διαβάστε το πίσω με το ticket_api_get όποτε θέλετε να δείτε αν υπάρχει κίνηση: το interactions φέρει μόνο το δημόσιο νήμα, οι εσωτερικές σημειώσεις του γραφείου φιλτράρονται πριν απαντήσει αυτή η μέθοδος.

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']))

Η απάντηση

Και οι δύο μέθοδοι απαντούν με την ίδια στενή, ασφαλή για εξωτερική χρήση προβολή του αιτήματος, χωρίς αναγνωριστικά ιδιοκτήτη, χωρίς εσωτερική κατάσταση:

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

Το ticket_api_get προσθέτει ένα ακόμη κλειδί, το interactions, έναν πίνακα με στοιχεία { direction, from, channel, body, ts } με τη σειρά του νήματος, κενό μέχρι να απαντήσει κάποιος από το γραφείο (ή αυτός που ζητά, μέσω άλλου καναλιού).

Σφάλματα

Επόμενο