SMS შეტყობინებები

გაგზავნეთ სტანდარტული ტექსტური შეტყობინებები SMSBAT API-ს გამოყენებით. SMS არის ყველაზე უნივერსალური შეტყობინებების არხი მიწოდების ყველაზე მაღალი ტარიფით ყველა მობილურ მოწყობილობაზე.

მიმოხილვა

SMS (მოკლე შეტყობინებების სერვისი) იდეალურია:

• დროის კრიტიკული შეტყობინებები
• სარეზერვო Viber/RCS შეტყობინებებისთვის
• მიაღწიეთ მომხმარებლებს სმარტფონების გარეშე
• უნივერსალური თავსებადობა ყველა მობილურ ქსელში
• მაღალი მიწოდების ტარიფები (95%+)

ძირითადი SMS შეტყობინება

მოთხოვნა

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

პარამეტრები

პარამეტრი	ტიპი	საჭირო	აღწერა
დან	სიმებიანი	დიახ	ალფანუმერული გამგზავნის ID (11 სიმბოლომდე)
მდე	სიმებიანი	დიახ	მიმღების ტელეფონის ნომერი E.164 ფორმატში
ტიპი	სიმებიანი	დიახ	დააყენეთ "sms"
ტექსტი	სიმებიანი	დიახ	შეტყობინების შინაარსი
customerMessageId	სიმებიანი	არა	თქვენი შიდა თვალთვალის ID
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 კლიენტის ID-ით

{
  "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-ბიტიანი კოდირება

სტანდარტული GSM ანბანი (160 სიმბოლო თითო SMS):

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

გაფართოებული GSM სიმბოლოები

ეს სიმბოლოები ითვლება 2 სიმბოლოდ:

| ^ € { } [ ] ~ \

Unicode (UCS-2) კოდირება

სპეციალური სიმბოლოებით შეტყობინებები იყენებს უნიკოდის დაშიფვრას (70 სიმბოლო თითო SMS-ში):

• Emoji: 😀 🎉 ❤️
• კირილიცა: А Б В Г Д Е Ж
• სპეციალური სიმბოლოები: ✓ ✗ ★ ♥

შეტყობინების სიგრძე

ერთჯერადი SMS

• GSM 7-ბიტი: 160 სიმბოლო
• ** Unicode **: 70 სიმბოლო

მრავალნაწილიანი SMS

როდესაც თქვენი შეტყობინება აჭარბებს ლიმიტს, ის იყოფა რამდენიმე ნაწილად:

• GSM 7-ბიტი: 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 ნაწილების რაოდენობა
მდე	მიმღების ტელეფონის ნომერი

გამგზავნის ID

ალფანუმერული გამგზავნი

გამოიყენეთ თქვენი ბრენდის სახელი, როგორც გამგზავნი (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"
}

საუკეთესო პრაქტიკა

შეტყობინების შინაარსი

• ✅ შეინახეთ შეტყობინებები ლაკონური და მკაფიო
• ✅ ჩართეთ გამგზავნის იდენტიფიკაცია
• ✅ საჭიროების შემთხვევაში დაამატეთ ქმედების მოწოდება
• ✅ გამოიყენეთ სწორი გრამატიკა და მართლწერა
• ❌ მოერიდეთ ზედმეტ პუნქტუაციას!!!
• ❌ არ გამოიყენოთ ყველა CAPS
• ❌ მოერიდეთ URL-ის შემოკლებებს, რომლებიც საეჭვოდ გამოიყურება

სიმბოლოების გამოყენება

• გაგზავნამდე შეამოწმეთ სიმბოლოების რაოდენობა
• გაითვალისწინეთ გაფართოებული GSM სიმბოლოები (დაითვალეთ როგორც 2)
• ტესტირება სპეციალური სიმბოლოებით ნაყარი გაგზავნამდე
• განიხილეთ GSM კოდირების გამოყენება უფრო გრძელი შეტყობინებებისთვის

ტელეფონის ნომრები

• ყოველთვის გამოიყენეთ E.164 ფორმატი: +380XXXXXXXXX
• გადაამოწმეთ ტელეფონის ნომრები გაგზავნამდე
• ამოიღეთ არასწორი ნომრები თქვენი სიიდან
• განაახლეთ თქვენი კონტაქტების სია

დრო

• პატივი ეცით ადგილობრივი დროის ზონებს
• მოერიდეთ გაგზავნას ღამით (10 PM - 8 AM)
• განიხილეთ სამუშაო საათები კომერციული შეტყობინებებისთვის
• დააყენეთ შესაბამისი TTL დროზე მგრძნობიარე შეტყობინებებისთვის

შესაბამისობა

• მიიღეთ თანხმობა მარკეტინგული შეტყობინებების გაგზავნამდე
• ჩართეთ უარის თქმის ინსტრუქციები სარეკლამო SMS-ზე
• დაიცავით ადგილობრივი რეგულაციები (GDPR და ა.შ.)
• პატივი ეცით "არ შემაწუხოთ" სიებს

შეცდომის დამუშავება

საერთო შეცდომები

შეცდომა	მიზეზი	გამოსავალი
INVALID_RECIPIENT	არასწორი ტელეფონის ფორმატი	გამოიყენეთ E.164 ფორმატი
INVALID_SENDER	არასწორი გამგზავნის ID	შეამოწმეთ გამგზავნის ID წესები
MESSAGE_TOO_LONG	აღემატება მაქსიმალურ სიგრძეს	შეტყობინების გაყოფა ან შემოკლება
INVALID_ENCODING	მხარდაუჭერელი სიმბოლოები	გამოიყენეთ GSM ან Unicode

ხარჯების ოპტიმიზაცია

შეამცირეთ შეტყობინების ნაწილები

• შეინახეთ შეტყობინებები 160 სიმბოლოზე ნაკლები (GSM) ან 70 (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 Messages - მდიდარი საკომუნიკაციო სერვისები
• სტატუსის შემოწმება - აკონტროლეთ მიწოდების სტატუსი
• Fallback სტრატეგიები - ჩანაცვლების კონფიგურაცია