Μετάβαση στο περιεχόμενο

Cascade API

Το Cascade API επιτρέπει την αποστολή μηνυμάτων σε πολλές πλατφόρμες με ένα μόνο αίτημα, με αυτόματη δρομολόγηση σε Telegram Bot, Viber Bot, Viber Business Messages, RCS και SMS.

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

https://restapi.smsbat.com

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

Το Cascade API χρησιμοποιεί έλεγχο ταυτότητας βάσει κεφαλίδων με τρεις πιθανές κεφαλίδες ελέγχου ταυτότητας:

Μέθοδος 1: Κλειδί SMSBAT API

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Authorization-Key: your-smsbat-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Μέθοδος 2: Viber Bot Token

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Viber-Auth-Token: your-viber-bot-token" \
  -H "Content-Type: application/json" \
  -d @request.json

Μέθοδος 3: Κλειδί Bot Telegram

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Tg-Bot-Key: your-telegram-bot-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Διαθέσιμα τελικά σημεία

Μέθοδος Τελικό σημείο Περιγραφή
ΑΝΑΡΤΗΣΗ /api/CascadeMessage/send_message/async Γενική αποστολή μηνυμάτων καταρράκτη
ΑΝΑΡΤΗΣΗ /api/CascadeMessage/send_message/tg-viber/async Καταρράκτης με προτεραιότητα στο Telegram

Πώς λειτουργεί

Με ένα μόνο αίτημα API, το Cascade παραδίδει αυτόματα το μήνυμά σας σε πολλά κανάλια:

Telegram Bot → Viber Bot → Viber Business → RCS → SMS

Το μήνυμα παραδίδεται μέσω του πρώτου διαθέσιμου καναλιού, με αυτόματη επιστροφή στο επόμενο κανάλι, εάν η παράδοση αποτύχει.

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

Πολυκαναλική Παράδοση

Στείλτε ένα μήνυμα, προσεγγίστε χρήστες σε οποιαδήποτε πλατφόρμα:

  • Telegram Bot
  • Viber Bot
  • Viber Business Messages
  • RCS (Rich Communication Services)
  • SMS

Αντικατάσταση μεταβλητής

Χρησιμοποιήστε δυναμικό περιεχόμενο με μεταβλητά σύμβολα κράτησης θέσης:

  • %name=id% - Μεταβλητές κειμένου
  • %url=id% - Μεταβλητές URL
  • %short_url=id% - Συντομευμένες μεταβλητές URL

Προγραμματισμός μηνυμάτων

Προγραμματίστε μηνύματα για μελλοντική παράδοση:

{
  "scheduledTime": "2025-01-24T12:00:00Z"
}

Χρόνος ζωής (TTL)

Ορισμός χρόνου λήξης για τα μηνύματα:

{
  "ttl": 3600
}

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

Το Cascade API υποστηρίζει:

  • Συναλλακτική - Επιβεβαιώσεις παραγγελιών, ειδοποιήσεις
  • Προώθηση - Μήνυμα μάρκετινγκ και προώθησης
  • Viber Surveys - Διαδραστικές έρευνες
  • Κλήσεις Flash - Επαλήθευση τηλεφώνου

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

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

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - GUID για αναγνώριση μηνυμάτων
  • trackinId - Συμβολοσειρά για παρακολούθηση της κατάστασης παράδοσης

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

  1. Αποστολή μηνυμάτων - Ξεκινήστε να στέλνετε αλληλοδιαδοχικά μηνύματα
  2. Message Variables - Χρησιμοποιήστε δυναμικό περιεχόμενο
  3. Τύποι μηνυμάτων - Εξερευνήστε τους τύπους μηνυμάτων

Παράδειγμα αιτήματος

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "text": "Hello %name=1%, your order #%url=2% is ready!",
      "variables": [
        {
          "id": 1,
          "value": "John"
        },
        {
          "id": 2,
          "value": "12345"
        }
      ]
    }
  ]
}

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

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

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

Οφέλη

Ενιαία ένταξη

Μία ενσωμάτωση API για όλα τα κανάλια ανταλλαγής μηνυμάτων - δεν χρειάζεται να ενσωματωθεί με κάθε πλατφόρμα ξεχωριστά.

Αυτόματη δρομολόγηση

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

Βελτιστοποίηση κόστους

Το Cascade δοκιμάζει πρώτα φθηνότερα κανάλια, επιστρέφοντας αυτόματα σε πιο ακριβές επιλογές μόνο όταν χρειάζεται.

Υψηλότερες τιμές παράδοσης

Τα πολλαπλά εναλλακτικά κανάλια διασφαλίζουν ότι το μήνυμά σας φτάνει στον παραλήπτη, ακόμη και αν το κύριο κανάλι αποτύχει.

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