Εξουσιοδότηση χειριστή και Σύνδεσμοι σε βάθος

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

URL βάσης API: https://chatapi.smsbat.com/ Swagger: https://chatapi.smsbat.com/index.html

Σημείωση: Μπορείτε να χρησιμοποιήσετε την κεφαλίδα "X-Authorization-Key" με το διακριτικό σας (διατίθεται στο προφίλ σας στον πίνακα ελέγχου) αντί για την εξουσιοδότηση "Φορέας" για αιτήματα σε επίπεδο εταιρείας.

1. Λήψη εταιρικού διακριτικού

Για να λάβετε το εταιρικό διακριτικό, στείλτε ένα αίτημα HTTP POST στο /api/company/get-token που περιέχει τα διαπιστευτήρια σύνδεσης της εταιρείας.

αίτημα - Μέθοδος: ΑΝΑΡΤΗΣΗ - URL: https://chatapi.smsbat.com/api/company/get-token - Κεφαλίδες: Τύπος περιεχομένου: εφαρμογή/json

Σώμα:

{
  "login": "string",
  "password": "string"
}

Απάντηση - Κωδικός κατάστασης: 200 (ΟΚ) - Σώμα: Διακριτικό συμβολοσειράς ("your_token_string")

Σημείωση: Αποθηκεύστε το ληφθέν διακριτικό για επόμενα αιτήματα.

2. Ανακτήστε τη λίστα οργανισμών

Στείλτε ένα αίτημα GET στο /api/company/organization χρησιμοποιώντας το διακριτικό της εταιρείας για τη λίστα των οργανισμών σας.

αίτημα - Μέθοδος: ** GET - URL: https://chatapi.smsbat.com/api/company/organization - Κεφαλίδες:** - Authorization: Bearer {token} - «Αποδοχή: κείμενο/απλό».

Απάντηση - Κωδικός κατάστασης: 200 (ΟΚ) - Σώμα:

[
  {
    "id": 6,
    "name": "string"
  }
]

3. Ανάκτηση χειριστών ανά οργανισμό

Στείλτε ένα αίτημα GET στο «/api/operator» χρησιμοποιώντας την παράμετρο «organizationId».

αίτημα - Μέθοδος: ** GET - URL: https://chatapi.smsbat.com/api/operator?organizationId={id} - Κεφαλίδες:** - Authorization: Bearer {token} - «Αποδοχή: κείμενο/απλό».

Απάντηση - Κωδικός κατάστασης: 200 (ΟΚ) - Σώμα:

[
  {
    "id": 21,
    "name": "string",
    "status": 1,
    "organization": {
      "id": 24,
      "name": "test_costs"
    }
  }
]

4. Προσθήκη χειριστή στο σύστημα

Χρησιμοποιήστε το διακριτικό της εταιρείας για να αποκτήσετε πρόσβαση σε αυτό το τελικό σημείο και να συγχρονίσετε τους χειριστές με το σύστημα.

αίτημα - Μέθοδος: ΑΝΑΡΤΗΣΗ - URL: https://chatapi.smsbat.com/api/operator/synchronize - Κεφαλίδες: - Authorization: Bearer {token} - Τύπος περιεχομένου: εφαρμογή/json

Σώμα:

[
  {
    "organizationId": 24,
    "name": "string"
  }
]

Απάντηση - Κωδικός κατάστασης: 200 (ΟΚ) - Σώμα:

[
  {
    "id": 21,
    "status": 0,
    "name": "string"
  }
]

Πιθανές καταστάσεις χειριστή: - Ενεργό: 0 - Ανενεργό: 1 - Διαγράφηκε: 2

5. Αποκτήστε το Token χειριστή

Εξουσιοδοτήστε με το εταιρικό διακριτικό για να αποκτήσετε ένα διακριτικό για έναν συγκεκριμένο χειριστή.

αίτημα - Μέθοδος: ΑΝΑΡΤΗΣΗ - URL: https://chatapi.smsbat.com/api/operator/get-token - Κεφαλίδες: - Authorization: Bearer {token} - Τύπος περιεχομένου: εφαρμογή/json

Σώμα:

{
  "id": 0,
  "expiresAt": "2025-01-20T14:33:34.147Z"
}

Το expiresAt απαιτείται και καθορίζει τη διάρκεια της περιόδου λειτουργίας του χειριστή (μέγιστο +24 ώρες).

Απάντηση - Κωδικός κατάστασης: 200 (ΟΚ) - Σώμα: Διακριτικό συμβολοσειράς

6. Επικύρωση διακριτικού χειριστή

Επαληθεύστε την εγκυρότητα του διακριτικού ενός χειριστή.

αίτημα - Μέθοδος: ΑΝΑΡΤΗΣΗ - URL: https://chatapi.smsbat.com/api/operator/validate-token - Κεφαλίδες: - Authorization: Bearer {token} - Τύπος περιεχομένου: εφαρμογή/json

Σώμα: "operator_token_string"

Έγκυρη απόκριση (200 ΟΚ):

{
  "isValid": true,
  "operatorId": 0,
  "clientId": 0,
  "expiresAt": "2024-12-28T14:04:15.861Z",
  "error": null
}

7. Βαθιά σύνδεση με τον πίνακα συνομιλίας χειριστή

Τα εξωτερικά συστήματα (CRM, ERP, εσωτερικοί ιστότοποι) μπορούν να ανοίξουν απευθείας τον πίνακα συνομιλίας αξιοποιώντας τους συνδέσμους σε βάθος περνώντας ως παράμετρο το διακριτικό χειριστή JWT. Εάν το διακριτικό δεν είναι έγκυρο ή έχει λήξει, ο χρήστης θα ανακατευθυνθεί στη διεπαφή σύνδεσης.

Μορφή 1: Με Αναγνωριστικό συνομιλίας

https://chat.smsbat.com/?chat_raw_id=<chat_id>&token=<jwt_token>

Μορφή 2: Με αριθμό τηλεφώνου

https://chat.smsbat.com/?phone=<phone_number>&token=<jwt_token>

Ο αριθμός τηλεφώνου πρέπει να είναι σε διεθνή μορφή E.164.

Μορφή 3: Με όνομα & τηλέφωνο Alpha

https://chat.smsbat.com/?from=<bm_id>&phone=<phone_number>&token=<jwt_token>

Μορφή 4: Πλήρεις λεπτομέρειες στόχου

Καθορίστε ακριβώς από ποια πηγή θα υποκλαπούν μηνύματα:

https://chat.smsbat.com/?source=<sourceId>&from=<bm_id>&phone=<phone_number>&token=<jwt_token>

Πηγές συνομιλίας: - 0 - Viber - 1 - ViberBot - 2 - TelegramBot - 3 - Whatsapp - 4 - Γραφικό στοιχείο - 5 - Ροζέτκα - 6 - Facebook - 7 - Instagram