Help Center Αποστολή μηνύματος

Αποστολή μηνύματος

Στείλτε μηνύματα μέσω του SMSBAT API χρησιμοποιώντας το τελικό σημείο /bat/messagelist.

Τελικό σημείο

POST /bat/messagelist

Δομή αιτήματος

Το σώμα του αιτήματος είναι ένας πίνακας JSON αντικειμένων μηνύματος:

{
  "messages": [
    {
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Your message text",
      "customerMessageId": "your-internal-id",
      "ttl": 3600
    }
  ]
}

Παράμετροι

Απαιτούμενες παράμετροι

Παράμετρος	Τύπος	Περιγραφή
«από»	χορδή	Αλφαριθμητικό αναγνωριστικό αποστολέα
«προς»	χορδή	Αριθμός τηλεφώνου παραλήπτη σε μορφή E.164 (π.χ. +380XXXXXXXXX)
«τύπος»	χορδή	Τύπος μηνύματος: `sms`, `viber_promo`, `viber_trans`, `viber_carousel`, `viber_survey`, `viber_otp`, `rcs`, `flashcall`
`κείμενο`	χορδή	Περιεχόμενο μηνύματος (απαιτείται για τους περισσότερους τύπους, προαιρετικό για ορισμένους)

Προαιρετικές παράμετροι

Παράμετρος	Τύπος	Περιγραφή
`customerMessageId`	χορδή	Το εσωτερικό σας αναγνωριστικό για παρακολούθηση
`ttl`	ακέραιος	Χρόνος ζωής σε δευτερόλεπτα
`MessageData`	αντικείμενο	Διαμόρφωση για συγκεκριμένο τύπο (διαφέρει ανάλογα με τον τύπο μηνύματος)

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

Επιλέξτε μία από τις τρεις μεθόδους ελέγχου ταυτότητας:

=== “Κεφαλίδα κλειδιού API”

```bash
curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'
```

=== “HTTP Basic Auth”

```bash
curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'
```

=== “Κλειδί API ως κωδικός πρόσβασης”

```bash
curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'
```

Απάντηση

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

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 1,
      "customerMessageId": "your-internal-id",
      "to": "+380XXXXXXXXX"
    }
  ]
}

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

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

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

SMS

Απλά μηνύματα κειμένου:

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

Προωθητικά μηνύματα με εμπλουτισμένα μέσα:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Check out our new product!",
  "messageData": {
    "image": "https://example.com/image.jpg",
    "button": {
      "text": "View Product",
      "url": "https://example.com/product"
    }
  }
}

Viber Transactional

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

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed"
}

Viber OTP

Εφάπαξ ειδοποιήσεις κωδικού πρόσβασης:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "code": "123456",
    "validity": 300
  }
}

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

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

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

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

{
  "error": {
    "code": "INVALID_RECIPIENT",
    "message": "Invalid phone number format"
  }
}

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

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

Να χρησιμοποιείτε πάντα τη μορφή E.164 για αριθμούς τηλεφώνου:

✅ Σωστό: +380XXXXXXXXX
❌ Λάθος: 380XXXXXXXXX, 0XXXXXXXXX

Κείμενο μηνύματος

Διατηρήστε SMS κάτω από 160 χαρακτήρες για να αποφύγετε πολλαπλά μέρη
Χρησιμοποιήστε κωδικοποίηση UTF-8 για διεθνείς χαρακτήρες
Δοκιμάστε ειδικούς χαρακτήρες πριν από τη μαζική αποστολή

TTL (Time-to-Live)

Ορίστε κατάλληλο TTL για μηνύματα ευαίσθητα στον χρόνο
Μηνύματα OTP: 300-600 δευτερόλεπτα (5-10 λεπτά)
Προωθητικά μηνύματα: 3600-86400 δευτερόλεπτα (1-24 ώρες)

Αναγνωριστικό μηνύματος πελάτη

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

Όρια ποσοστών

Επικοινωνήστε με τον διαχειριστή του λογαριασμού σας για πληροφορίες σχετικά με:

Μηνύματα ανά δευτερόλεπτο
Μηνύματα ανά ημέρα
Ταυτόχρονες συνδέσεις

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

Viber Messages - Εξερευνήστε τους τύπους μηνυμάτων Viber
Μηνύματα SMS - Μάθετε περισσότερα για τα SMS
Έλεγχος κατάστασης - Παρακολούθηση παράδοσης μηνύματος

Search Results