Help Center Συνομιλίες και μηνύματα

Συνομιλίες και μηνύματα

Μέθοδοι API για τη λήψη μεταδεδομένων συνομιλίας ChatHub, τη διαχείριση καταστάσεων και τον έλεγχο ιστορικών αλυσίδων μηνυμάτων.

URL: https://chatapi.smsbat.com

1. Λήψη όλων των συνομιλιών

Λάβετε μια λίστα συνομιλιών με δυναμικό φιλτράρισμα και σελιδοποίηση.

αίτημα

  • **Μέθοδος: ** GET
  • URL: /api/chat/chats
  • Εξουσιοδότηση: Bearer Token (Απαιτείται)

Παράμετροι ερωτήματος

ΠαράμετροςΤύποςΠεριγραφή
σελίδα«ακέραιος»Αριθμός σελίδας. Προεπιλογή: 1
”ανά_σελίδα”«ακέραιος»Στοιχεία ανά σελίδα. Προεπιλογή: 20
αναζήτησηχορδήΑναζήτηση κειμένου (π.χ. όνομα, τηλέφωνο)
«πηγή»«ακέραιος»Αριθμός πηγής συνομιλίας (π.χ. “1” για Viber Bot, “2” για Telegram)
«ημερομηνία»«ημερομηνία»Ανακτά συνομιλίες μεταξύ δύο ημερομηνιών (απαιτούνται δύο πανομοιότυπα κλειδιά παραμέτρων στη διεύθυνση URL). Π.χ.: ?date=2026-01-28&date=2026-01-29
tg_user_id«ακέραιος»Αναγνωριστικό χρήστη Telegram
«τηλέφωνο»χορδήΑριθμός τηλεφώνου
«κατάσταση»«ακέραιος»0 = Νέο, 1 = Άνοιγμα, 2 = Αναμονή, 3 = Σε Παύση, 4 = Κλειστό
organizationIdακέραιοςΠεριορισμός κατά οργανισμό
”αναγνωριστικό χειριστή”ακέραιοςΠεριορισμός από τον εκχωρημένο τελεστή

Απάντηση (200 ΟΚ)

{
  "total": 124,
  "items": [
    {
       "id": 123,
       "theme": "Support Ticket #491",
       "operator": {
           "id": 21,
           "name": "Jane",
           "photo": "url_to_photo.png"
       },
       "chatStatus": 1,
       "countUnread": 3
    }
  ]
}

2. Αλλαγή κατάστασης συνομιλίας

Ενημερώνει την εκχωρημένη κατάσταση μιας συγκεκριμένης συνεδρίας συνομιλίας.

αίτημα

  • Μέθοδος: PUT
  • URL: /api/chat/status
  • Εξουσιοδότηση: Bearer Token
  • Κεφαλίδες: Τύπος περιεχομένου: εφαρμογή/json

Σώμα:

{
  "id": 123,
  "status": 1
}

Αριθμός τιμών κατάστασης:

  • 0: Νέο (νέα δημιουργία)
  • 1: Ανοιχτό (τον χειρίζεται ενεργά ο χειριστής)
  • 2: Αναμονή (Αναμονή απάντησης χρήστη)
  • 3: Σε παύση (κατάσταση σε παύση)
  • 4: Κλειστό (Αρχειοθετημένο)

3. Διαγράψτε μια συνομιλία

Διαγράφει οριστικά μια συνομιλία μέσω του μοναδικού αναγνωριστικού της.

αίτημα

  • Μέθοδος: ΔΙΑΓΡΑΦΗ
  • URL: /api/chat/chats/{id}
  • Εξουσιοδότηση: Bearer Token

Απάντηση (200 ΟΚ) Επιστρέφει ένα HTTP 200 για επιβεβαίωση της επιτυχούς διαγραφής. Το σώμα είναι συνήθως κενό ή αυστηρά “ΟΚ"".

4. Ανάκτηση μηνυμάτων συνομιλίας

Καταργεί όλα τα ιστορικά μηνύματα που στάλθηκαν και ελήφθησαν σε μια συγκεκριμένη συνομιλία.

αίτημα

  • **Μέθοδος: ** GET
  • URL: /api/chat/chats/{chatId}/messages
  • Εξουσιοδότηση: Bearer Token

Απάντηση (200 ΟΚ)

[
  {
        "id": 1,
        "chatId": 123,
        "message": "Hello, how can I help?",
        "phone": "380936670003",
        "author": 0,
        "status": 3,
        "date": "2025-04-01T09:46:24.687Z",
        "operator": {
          "id": 21,
          "name": "Jane"
        },
        "messageType": 0
  }
]

Συγγραφείς:

  • 0: Χειριστής
  • 1: Πελάτης
  • 2: System Bot
  • 3: Επαγγελματικός λογαριασμός Viber

Τύποι μηνυμάτων:

  • 0: Κείμενο
  • 1: Φωτογραφία
  • 2: Αρχείο

5. Ενημέρωση κατάστασης μηνυμάτων

Επισημαίνει ένα μήνυμα (ή πολλά μηνύματα) μέσα σε μια ενεργή συνομιλία με νέες καταστάσεις παράδοσης.

αίτημα

  • Μέθοδος: PUT
  • URL: /api/chat/messages/status
  • Εξουσιοδότηση: Bearer Token
  • Κεφαλίδες: Τύπος περιεχομένου: εφαρμογή/json

Σώμα:

{
  "status": 3,
  "messageIds": [1, 2, 3]
}

(Κατάσταση 3 επισημαίνει τα αναγνωριστικά των απεσταλμένων μηνυμάτων ως “Αναγνωσμένα”)