Help Center Συμβατότητα TurboSMS API

Συμβατότητα TurboSMS API

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

Υποστηρίζουμε την αποστολή μηνυμάτων SMS και Viber (συμπεριλαμβανομένων προηγμένων λειτουργιών όπως καρουζέλ και έρευνες), λήψη καταστάσεων και λήψη λεπτομερειών μηνυμάτων χρησιμοποιώντας τις ίδιες ακριβώς δομές σώματος αιτήματος που γνωρίζετε ήδη.

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

Η μόνη διαφορά από το εγγενές TurboSMS API είναι ο μηχανισμός ελέγχου ταυτότητας. Ενώ το TurboSMS χρησιμοποιεί μια προσαρμοσμένη παράμετρο ερωτήματος «token» ή μια συγκεκριμένη κεφαλίδα ελέγχου ταυτότητας, το SMSBAT απαιτεί ένα τυπικό Bearer Token.

Πρέπει να συμπεριλάβετε το διακριτικό SMSBAT API στην κεφαλίδα «Authorization» για όλα τα αιτήματα:

Authorization: Bearer YOUR_SMSBAT_TOKEN

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

Όλα τα τελικά σημεία θα πρέπει να κατευθύνονται στη βασική διεύθυνση URL του SMSBAT API:

https://restapi.smsbat.com

Αποστολή μεμονωμένου μηνύματος

Τελικό σημείο: POST /api/tsms/message/send

Επιτρέπει την αποστολή μηνυμάτων SMS και Viber με υποστήριξη για υβριδική παράδοση (Viber με εναλλακτικό SMS). Επεξεργάζεται ένα μόνο αίτημα αποστολής και επιστρέφει τα αποτελέσματα παράδοσης για κάθε παραλήπτη.

Βασικές Δυνατότητες

  • Ευέλικτες παράμετροι: Οι καθολικές παράμετροι μπορούν να παρακαμφθούν από συγκεκριμένες παραμέτρους SMS/Viber.
  • Περιεχόμενο: Υποστηρίζει καρουζέλ Viber, έρευνες, συνημμένα αρχεία και διαδραστικά κουμπιά.
  • Χειρισμός σφαλμάτων: Επιστρέφει το HTTP 200 ακόμη και για σφάλματα (αποκρίσεις δομημένων σφαλμάτων). «κωδικός_απόκρισης: 999» με κατάσταση «FATAL_ERROR» για σφάλματα συστήματος.
  • Σφάλματα παραλήπτη: Τα συγκεκριμένα σφάλματα παραλήπτη επιστρέφονται στον πίνακα response_result. Οι αποτυχημένοι παραλήπτες έχουν “αναγνωριστικό_μηνύματος: null” και συγκεκριμένους κωδικούς σφάλματος.

Παράδειγμα αιτήματος (Υβριδικό μήνυμα)

{
  "sender": "GlobalSender",
  "text": "Test message",
  "recipients": ["380951111111", "380952222222"],
  "start_time": "2025-09-29T10:00:00Z",
  "sequence_id": "seq_12345",
  "sms": {
    "sender": "SMSSender",
    "text": "SMS version of message",
    "is_flash": false
  },
  "viber": {
    "sender": "ViberSender",
    "text": "Viber version of message",
    "ttl": 3600,
    "image_url": "https://example.com/image.png",
    "caption": "Button text",
    "action": "https://google.com",
    "count_clicks": true,
    "is_transactional": false
  }
}

{
  "sender": "GlobalSender",
  "text": "Check out our products",
  "recipients": ["380951111111"],
  "viber": {
    "sender": "ViberSender",
    "text": "Check out our products",
    "is_transactional": false,
    "carousel": [
      {
        "title": "Product 1",
        "image_url": "https://example.com/product1.jpg",
        "button_caption": "Buy Now",
        "button_url": "https://example.com/buy/product1",
        "link_caption": "Learn More",
        "link_url": "https://example.com/product1"
      },
      {
        "title": "Product 2",
        "image_url": "https://example.com/product2.jpg",
        "button_caption": "Buy Now",
        "button_url": "https://example.com/buy/product2",
        "link_caption": "Learn More",
        "link_url": "https://example.com/product2"
      }
    ]
  }
}

Παράδειγμα αιτήματος (Viber Survey)

{
  "sender": "GlobalSender",
  "text": "Please rate our service",
  "recipients": ["380951111111"],
  "viber": {
    "sender": "ViberSender",
    "text": "Please rate our service",
    "is_transactional": true,
    "survey": [
      "Excellent",
      "Good",
      "Average",
      "Poor"
    ]
  }
}

Αποστολή πολλαπλών μηνυμάτων (ομαδική)

Τελικό σημείο: POST /api/tsms/message/sendmulti

Αυτή η μέθοδος σάς επιτρέπει να στέλνετε πολλαπλά αιτήματα «αποστολής» σε ένα μόνο αίτημα HTTP, εξοικονομώντας έξοδα σύνδεσης. Η κλήση «sendmulti» με δεδομένα για 100 αιτήματα θα είναι ταχύτερη από την εκτέλεση 100 μεμονωμένων αιτημάτων «send».

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

{
  "batch_1": {
    "sender": "GlobalSender",
    "text": "Test message",
    "recipients": ["380982462128", "380501111111"],    
    "sms": {
        "sender": "SMSSender",
        "text": "SMS version of message"
    }
  },
  "batch_2": {
    "sender": "GlobalSender",
    "text": "Second message",
    "recipients": ["380501111111"],
    "viber": {
      "sender": "ViberSender",
      "text": "Viber message",
      "is_transactional": true
    }
  }
}

Παράδειγμα απόκρισης

{
    "response_code": 0,
    "response_status": "OK",
    "response_result": {
        "batch_1": {
            "response_code": 800,
            "response_status": "SUCCESS_MESSAGE_ACCEPTED",
            "response_result": [
                {
                    "phone": "380982462128",
                    "response_code": 0,
                    "message_id": "f1640579-ea75-4bc1-b708-1c3858bf222d",
                    "response_status": "OK"
                }
            ]
        },
        "batch_2": { ... }
    }
}

Λήψη κατάστασης μηνύματος

Τελικό σημείο: POST /api/tsms/message/status

Ανακτήστε τις καταστάσεις παράδοσης των απεσταλμένων μηνυμάτων παρέχοντας το message_id τους.

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

{
  "messages": [
      "573dcb46-7851-4e16-bb1f-721c13ef5f38", 
      "6b7f9ff5-28c8-4f38-913b-31af6021fbea"
  ]
}

Λήψη λεπτομερειών μηνύματος

Τελικό σημείο: POST /api/tsms/message/details

Σας επιτρέπει να ανακτάτε λεπτομερείς πληροφορίες σχετικά με τα μηνύματα που έχουν δημιουργηθεί, συμπεριλαμβανομένων λεπτομερειών πλήρους ωφέλιμου φορτίου για κανάλια SMS και Viber, τιμές και ακριβείς χρονικές σημάνσεις.

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

{
  "messages": [
      "573dcb46-7851-4e16-bb1f-721c13ef5f38", 
      "f1640579-ea75-4bc1-b708-1c3858bf222d"
  ]
}

Παράδειγμα απόκρισης

{
    "response_code": 0,
    "response_status": "OK",
    "response_result": [
        {
            "message_id": "573dcb46-7851-4e16-bb1f-721c13ef5f38",
            "sms": null,
            "viber": {
                "added": "2025-09-29T14:17:02.577Z",
                "start": "2025-09-29T10:00:00Z",
                "sent": "2025-09-29T14:17:02.577Z",
                "updated": "2025-09-29T14:17:02.577Z",
                "sender": "ViberSender",
                "text": "Viber version of message",
                "recipient": "380982462128",
                "message_type": "promotional",
                "status": "Queued",
                "price": 0,
                "ttl": 3600,
                "caption": "Button text",
                "action": "https://google.com"
            },
            "response_code": 0,
            "response_status": "OK"
        }
    ]
}