Μηνύματα SMS

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

Επισκόπηση

Το SMS (Υπηρεσία σύντομων μηνυμάτων) είναι ιδανικό για:

Ειδοποιήσεις κρίσιμες για το χρόνο
Εναλλακτικά για μηνύματα Viber/RCS
Προσέγγιση χρηστών χωρίς smartphone
Καθολική συμβατότητα σε όλα τα δίκτυα κινητής τηλεφωνίας
Υψηλά ποσοστά παράδοσης (95%+)

Βασικό μήνυμα SMS

Αίτημα

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Παράμετροι

Παράμετρος	Τύπος	Απαιτείται	Περιγραφή
«από»	χορδή	Ναι	Αλφαριθμητικό αναγνωριστικό αποστολέα (έως 11 χαρακτήρες)
«προς»	χορδή	Ναι	Αριθμός τηλεφώνου παραλήπτη σε μορφή E.164
«τύπος»	χορδή	Ναι	Ορισμός σε `"sms"`
`κείμενο`	χορδή	Ναι	Περιεχόμενο μηνύματος
`customerMessageId`	χορδή	Όχι	Το εσωτερικό σας αναγνωριστικό παρακολούθησης
`ttl`	ακέραιος	Όχι	Χρόνος ζωής σε δευτερόλεπτα

Παραδείγματα

Απλά SMS

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

SMS με αναγνωριστικό πελάτη

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

SMS με TTL

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

Κωδικοποίηση χαρακτήρων

Κωδικοποίηση GSM 7-bit

Τυπικό αλφάβητο GSM (160 χαρακτήρες ανά SMS):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Εκτεταμένοι χαρακτήρες GSM

Αυτοί οι χαρακτήρες μετρούν ως 2 χαρακτήρες:

| ^ € { } [ ] ~ \

Κωδικοποίηση Unicode (UCS-2).

Τα μηνύματα με ειδικούς χαρακτήρες χρησιμοποιούν κωδικοποίηση Unicode (70 χαρακτήρες ανά SMS):

Emoji: 😀 🎉 ❤️
Κυριλλικό: А Б В Г Д Е Ж
Ειδικά σύμβολα: ✓ ✗ ★ ♥

Μήκος μηνύματος

Μονό SMS

GSM 7-bit: 160 χαρακτήρες
Unicode: 70 χαρακτήρες

SMS πολλαπλών τμημάτων

Όταν το μήνυμά σας υπερβαίνει το όριο, χωρίζεται σε πολλά μέρη:

GSM 7-bit: 153 χαρακτήρες ανά τμήμα
Unicode: 67 χαρακτήρες ανά μέρος

Παράδειγμα

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

Αυτό το μήνυμα (201 χαρακτήρες) θα χωριστεί σε 2 μέρη.

Απάντηση

Απόκριση επιτυχίας

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

Πεδία απόκρισης

Πεδίο	Περιγραφή
`MessageId`	Μοναδικό αναγνωριστικό για παρακολούθηση
«κατάσταση»	Κατάσταση μηνύματος («αποδεκτό», «απορρίφθηκε»)
«εξαρτήματα»	Αριθμός ανταλλακτικών SMS
«προς»	Αριθμός τηλεφώνου παραλήπτη

Αναγνωριστικό αποστολέα

Αλφαριθμητικός αποστολέας

Χρησιμοποιήστε το όνομα της επωνυμίας σας ως αποστολέα (έως 11 χαρακτήρες):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

Περιορισμοί:

Έως 11 χαρακτήρες
Μόνο γράμματα και αριθμοί
Χωρίς κενά ή ειδικούς χαρακτήρες
Ο παραλήπτης δεν μπορεί να απαντήσει σε αλφαριθμητικούς αποστολείς

Αριθμητικός αποστολέας

Χρησιμοποιήστε έναν αριθμό τηλεφώνου ως αποστολέα (για αμφίδρομα SMS):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Περιπτώσεις χρήσης

Επαλήθευση OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Ειδοποιήσεις παραγγελιών

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Υπενθυμίσεις ραντεβού

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

Επιβεβαιώσεις πληρωμής

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

Βέλτιστες πρακτικές

Περιεχόμενο μηνύματος

✅ Διατηρήστε τα μηνύματα συνοπτικά και σαφή
✅ Συμπεριλάβετε την ταυτότητα του αποστολέα
✅ Προσθέστε παρότρυνση για δράση εάν χρειάζεται
✅ Χρησιμοποιήστε σωστή γραμματική και ορθογραφία
❌ Αποφύγετε τα υπερβολικά σημεία στίξης!!!
❌ Μη χρησιμοποιείτε όλα τα ΚΕΦΑΛΑΙΑ
❌ Αποφύγετε τα συντομευτικά URL που φαίνονται ύποπτα

Χρήση χαρακτήρων

Ελέγξτε τον αριθμό χαρακτήρων πριν την αποστολή
Να γνωρίζετε τους εκτεταμένους χαρακτήρες GSM (μετρήστε ως 2)
Δοκιμή με ειδικούς χαρακτήρες πριν από τη μαζική αποστολή
Εξετάστε το ενδεχόμενο να χρησιμοποιήσετε την κωδικοποίηση GSM για μεγαλύτερα μηνύματα

Αριθμοί τηλεφώνου

Να χρησιμοποιείτε πάντα τη μορφή E.164: +380XXXXXXXXX
Επικυρώστε τους αριθμούς τηλεφώνου πριν από την αποστολή
Καταργήστε τους μη έγκυρους αριθμούς από τη λίστα σας
Διατηρήστε τη λίστα επαφών σας ενημερωμένη

Χρονοδιάγραμμα

Σεβαστείτε τις τοπικές ζώνες ώρας
Αποφύγετε την αποστολή τη νύχτα (10 μ.μ. - 8 π.μ.)
Λάβετε υπόψη τις ώρες λειτουργίας για εμπορικά μηνύματα
Ορίστε κατάλληλο TTL για μηνύματα ευαίσθητα στον χρόνο

Συμμόρφωση

Λάβετε συγκατάθεση πριν στείλετε μηνύματα μάρκετινγκ
Συμπεριλάβετε οδηγίες εξαίρεσης για διαφημιστικά SMS
Ακολουθήστε τους τοπικούς κανονισμούς (GDPR, κ.λπ.)
Σεβαστείτε τις λίστες "Μην ενοχλείτε".

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

Συνήθη σφάλματα

Σφάλμα	Αιτία	Λύση
"ΜΗ ΕΓΚΥΡΟΣ_ΠΑΡΑΔΕΚΤΗΣ"	Λάθος μορφή τηλεφώνου	Χρησιμοποιήστε τη μορφή E.164
"INVALID_SENDER"	Μη έγκυρο αναγνωριστικό αποστολέα	Ελέγξτε τους κανόνες ταυτότητας αποστολέα
"ΜΗΝΥΜΑ_TOO_LONG"	Υπερβαίνει το μέγιστο μήκος	Διαχωρίστε ή συντομεύστε το μήνυμα
`INVALID_ENCODING`	Μη υποστηριζόμενοι χαρακτήρες	Χρησιμοποιήστε GSM ή Unicode

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

Μείωση τμημάτων μηνυμάτων

Διατηρήστε τα μηνύματα κάτω από 160 χαρακτήρες (GSM) ή 70 (Unicode)
Αποφύγετε τους ειδικούς χαρακτήρες που ενεργοποιούν το Unicode
Χρησιμοποιήστε συντομογραφίες όταν χρειάζεται
Αφαιρέστε τα περιττά κενά

Παράδειγμα βελτιστοποίησης

❌ Πριν (171 χαρακτήρες, 2 SMS):

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ Μετά (156 χαρακτήρες, 1 SMS):

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

Μαζική αποστολή

Στείλτε πολλά μηνύματα σε ένα αίτημα:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

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

Viber Messages - Μηνύματα εμπλουτισμένων μέσων
Μηνύματα RCS - Πλούσιες υπηρεσίες επικοινωνίας
Έλεγχος κατάστασης - Παρακολούθηση της κατάστασης παράδοσης
Στρατηγικές εναλλακτικών - Διαμόρφωση εναλλακτικών