Help Center SMSBAT ChatHub API

SMSBAT ChatHub API

Το ChatHub REST API διαχειρίζεται επαγγελματικές συνομιλίες Viber, συνομιλίες πελατών και ροές εργασίας αυτοματισμού υποστήριξης πελατών.

Βασική διεύθυνση URL

https://chatapi.smsbat.com

Τεκμηρίωση Swagger

Η διαδραστική τεκμηρίωση API είναι διαθέσιμη στη διεύθυνση:

https://chatapi.smsbat.com/index.html

Έλεγχος ταυτότητας

Το ChatHub χρησιμοποιεί ένα σύστημα ελέγχου ταυτότητας που βασίζεται σε διακριτικά Bearer με μάρκες JWT. Τα διακριτικά μπορούν να περάσουν με δύο τρόπους:

Μέθοδος 1: Κεφαλίδα εξουσιοδότησης

curl -X GET https://chatapi.smsbat.com/api/company/organization \
  -H "Authorization: Bearer your-jwt-token"

Μέθοδος 2: X-Authorization-Key Header

curl -X GET https://chatapi.smsbat.com/api/company/organization \
  -H "X-Authorization-Key: your-jwt-token"

Ροή ελέγχου ταυτότητας

Το ChatHub χρησιμοποιεί ένα σύστημα διακριτικών δύο επιπέδων:

  1. Company Token - Token πρόσβασης σε επίπεδο οργανισμού
  2. Operator Token - Μεμονωμένο διακριτικό πρόσβασης χειριστή

Ροή εργασιών

graph LR
    A[Get Company Token] --> B[List Organizations]
    B --> C[List/Add Operators]
    C --> D[Get Operator Token]
    D --> E[Integrate Widget]

Κύρια τελικά σημεία

ΜέθοδοςΤελικό σημείοΠεριγραφή
ΑΝΑΡΤΗΣΗ/api/company/get-tokenΛάβετε διακριτικό εξουσιοδότησης εταιρείας
ΠΑΡΕ«/api/εταιρεία/οργανισμός»Ανάκτηση λίστας οργανισμών
ΠΑΡΕ/api/operatorΚατάλογος χειριστών ανά οργανισμό
ΑΝΑΡΤΗΣΗ/api/operator/synchronizeΠροσθήκη νέων χειριστών
ΑΝΑΡΤΗΣΗ«/api/operator/status»Αλλαγή κατάστασης χειριστή
ΑΝΑΡΤΗΣΗ/api/operator/get-tokenΔημιουργία κουπονιών χειριστή (μέγιστη λήξη 24 ωρών)
ΑΝΑΡΤΗΣΗ/api/operator/validate-tokenΕπαλήθευση εγκυρότητας διακριτικού

Βασικά χαρακτηριστικά

Διαχείριση διακριτικών της εταιρείας

Αποκτήστε και διαχειριστείτε διακριτικά σε επίπεδο οργανισμού για πρόσβαση στο API.

Διοίκηση Οργανισμού

  • Καταγράψτε όλους τους οργανισμούς
  • Ανάκτηση στοιχείων οργάνωσης
  • Διαχειριστείτε τις ρυθμίσεις του οργανισμού

Διαχείριση χειριστή

  • Κατάλογος χειριστών ανά οργανισμό
  • Προσθήκη νέων τελεστών
  • Αλλαγή κατάστασης χειριστή (Ενεργός/Ανενεργός/Διαγραμμένος)
  • Δημιουργήστε διακριτικά ειδικά για χειριστή (μέγιστο 24 ώρες)
  • Επικύρωση διακριτικών χειριστή

Ενσωμάτωση γραφικών στοιχείων

Ενσωματώστε το γραφικό στοιχείο ChatHub σε εφαρμογές web για υποστήριξη πελατών σε πραγματικό χρόνο.

Γρήγορη εκκίνηση

  1. Έλεγχος ταυτότητας - Λάβετε τα διακριτικά της εταιρείας και του χειριστή σας
  2. Οργανισμοί - Διαχείριση οργανισμών
  3. Χειριστές - Προσθήκη και διαχείριση τελεστών
  4. Ενσωμάτωση γραφικών στοιχείων - Ενσωμάτωση γραφικού στοιχείου συνομιλίας

Μορφή αιτήματος

Όλα τα αιτήματα χρησιμοποιούν μορφή JSON:

{
  "login": "your-login",
  "password": "your-password"
}

Μορφή απόκρισης

Επιστροφή επιτυχών απαντήσεων:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiration": "2025-01-24T12:00:00Z"
}

Χειρισμός σφαλμάτων

Κωδικοί κατάστασης HTTP:

  • 200 OK - Το αίτημα επιτυχής
  • 400 Bad Request - Μη έγκυρη μορφή αιτήματος
  • 401 Μη εξουσιοδοτημένο - Ο έλεγχος ταυτότητας απέτυχε
  • 403 Απαγορευμένο - Ανεπαρκή δικαιώματα
  • 404 Δεν βρέθηκε - Ο πόρος δεν βρέθηκε
  • 500 Εσωτερικό Σφάλμα διακομιστή - Σφάλμα διακομιστή

Λήξη διακριτικού

Τα token έχουν χρόνο λήξης. Όταν λήξει ένα διακριτικό:

  1. Το API θα επιστρέψει το “401 Unauthorized”.
  2. Ζητήστε ένα νέο διακριτικό χρησιμοποιώντας το τελικό σημείο ελέγχου ταυτότητας
  3. Ενημερώστε την αίτησή σας με το νέο διακριτικό

Επόμενα βήματα