Ana içeriğe geç

SMS Mesajı

SMSBAT API'sini kullanarak standart metin mesajları gönderin. SMS, tüm mobil cihazlarda en yüksek dağıtım oranlarına sahip en evrensel mesajlaşma kanalıdır.

Genel Bakış

SMS (Kısa Mesaj Servisi) aşağıdakiler için idealdir:

  • Zaman açısından kritik bildirimler
  • Viber/RCS mesajları için geri dönüş
  • Akıllı telefonu olmayan kullanıcılara ulaşmak
  • Tüm mobil ağlarda evrensel uyumluluk
  • Yüksek teslimat oranları (%95+)

Temel SMS Mesajı

Talep

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

Parametreler

Parametre Tür Gerekli Açıklama
'dan' dize Evet Alfasayısal gönderen kimliği (en fazla 11 karakter)
'e' dize Evet E.164 formatında alıcı telefon numarası
'tür' dize Evet "sms" olarak ayarla
'metin' dize Evet Mesaj içeriği
'müşteriMesajId' dize Hayır Dahili izleme kimliğiniz
'ttl' tamsayı Hayır Saniye cinsinden yaşam süresi

Örnekler

Basit 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."
    }]
  }'

Müşteri Kimliğini içeren SMS

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

TTL ile SMS

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

Karakter Kodlama

GSM 7 bit Kodlama

Standart GSM alfabesi (SMS başına 160 karakter):

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

Genişletilmiş GSM Karakterleri

Bu karakterler 2 karakter olarak sayılır:

| ^ € { } [ ] ~ \

Unicode (UCS-2) Kodlama

Özel karakterlere sahip mesajlar Unicode kodlamasını kullanır (SMS başına 70 karakter):

  • Emoji: 😀 🎉 ❤️
  • Kiril: А Б В Г Д Е Ж
  • Özel semboller: ✓ ✗ ★ ♥

Mesaj Uzunluğu

Tek SMS

  • GSM 7 bit: 160 karakter
  • Unicode: 70 karakter

Çok parçalı SMS

Mesajınız sınırı aştığında birden çok parçaya bölünür:

  • GSM 7 bit: Parça başına 153 karakter
  • Unicode: Parça başına 67 karakter

Örnek

{
  "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."
  }]
}

Bu mesaj (201 karakter) 2 parçaya bölünecek.

Yanıt

Başarılı Yanıt

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

Yanıt Alanları

Alan Açıklama
'mesaj Kimliği' İzleme için benzersiz tanımlayıcı
'durum' Mesaj durumu (kabul edildi, reddedildi)
'parçalar' SMS parça sayısı
'e' Alıcının telefon numarası

Gönderen Kimliği

Alfanümerik Gönderen

Gönderen olarak marka adınızı kullanın (en fazla 11 karakter):

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

Kısıtlamalar:

  • Maksimum 11 karakter
  • Yalnızca harfler ve sayılar
  • Boşluk veya özel karakter yok
  • Alıcı alfasayısal gönderenlere yanıt veremez

Sayısal Gönderen

Gönderen olarak bir telefon numarası kullanın (iki yönlü SMS için):

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

Kullanım Durumları

OTP Doğrulaması

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

Sipariş Bildirimleri

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

Randevu Hatırlatıcıları

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

Ödeme Onayları

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

En İyi Uygulamalar

Mesaj İçeriği

  • ✅ Mesajları kısa ve net tutun
  • ✅ Gönderenin kimliğini ekleyin
  • ✅ Gerekirse harekete geçirici mesaj ekleyin
  • ✅ Doğru dil bilgisi ve yazım kurallarını kullanın
  • ❌ Aşırı noktalama işaretlerinden kaçının!!!
  • ❌ Tamamını BÜYÜK HARF kullanmayın
  • ❌ Şüpheli görünen URL kısaltıcılardan kaçının

Karakter Kullanımı

  • Göndermeden önce karakter sayısını kontrol edin
  • Genişletilmiş GSM karakterlerinden haberdar olun (2 olarak sayın)
  • Toplu göndermeden önce özel karakterlerle test edin
  • Daha uzun mesajlar için GSM kodlamasını kullanmayı düşünün

Telefon Numaraları

  • Her zaman E.164 biçimini kullanın: +380XXXXXXXXXX
  • Göndermeden önce telefon numaralarını doğrulayın
  • Geçersiz numaraları listenizden kaldırın
  • Kişi listenizi güncel tutun

Zamanlama

  • Yerel saat dilimlerine saygı gösterin
  • Geceleri göndermekten kaçının (22.00 - 08.00)
  • Ticari mesajlar için mesai saatlerini dikkate alın
  • Zamana duyarlı mesajlar için uygun TTL'yi ayarlayın

Uyumluluk

  • Pazarlama mesajları göndermeden önce onay alın
  • Promosyon SMS'i için devre dışı bırakma talimatlarını ekleyin
  • Yerel düzenlemelere (GDPR vb.) uyun
  • "Rahatsız Etmeyin" listelerine saygı gösterin

Hata İşleme

Yaygın Hatalar

Hata Sebep Çözüm
INVALID_RECIPIENT Yanlış telefon formatı E.164 biçimini kullanın
INVALID_SENDER Geçersiz gönderen kimliği Gönderen kimliği kurallarını kontrol edin
'MESSAGE_TOO_LONG' Maksimum uzunluğu aşıyor Mesajı böl veya kısalt
'GEÇERSİZ_ENKODLAMA' Desteklenmeyen karakterler GSM veya Unicode kullanın

Maliyet Optimizasyonu

Mesaj Bölümlerini Azaltın

  • Mesajları 160 karakterin (GSM) veya 70'in (Unicode) altında tutun
  • Unicode'u tetikleyen özel karakterlerden kaçının
  • Uygun olduğunda kısaltmalar kullanın
  • Gereksiz boşlukları kaldırın

Örnek Optimizasyon

❌ Önce (171 karakter, 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.

✅ Sonra (156 karakter, 1 SMS): 

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

Toplu Gönderim

Tek bir istekte birden fazla mesaj gönderin:

{
  "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"
    }
  ]
}

Sonraki Adımlar