Help Center Mesaj Gönder

Mesaj Gönder

/bat/messagelist uç noktasını kullanarak SMSBAT API aracılığıyla mesaj gönderin.

Uç nokta

POST /bat/messagelist

İstek Yapısı

İstek gövdesi, mesaj nesnelerinden oluşan bir JSON dizisidir:

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

Parametreler

Gerekli Parametreler

ParametreTürAçıklama
’dan’dizeAlfasayısal gönderen kimliği
’e’dizeE.164 biçiminde alıcının telefon numarası (ör. +380XXXXXXXXX)
‘tür’dizeMesaj türü: sms, viber_promo, viber_trans, viber_carousel, viber_survey, viber_otp, rcs, flashcall
’metin’dizeMesaj içeriği (çoğu tür için gerekli, bazıları için isteğe bağlı)

İsteğe Bağlı Parametreler

ParametreTürAçıklama
’müşteriMesajId’dizeİzleme için dahili tanımlayıcınız
’ttl’tamsayıSaniye cinsinden yaşam süresi
’mesajVerileri’nesneTipe özel konfigürasyon (mesaj tipine göre değişir)

Kimlik Doğrulama

Üç kimlik doğrulama yönteminden birini seçin:

=== “API Anahtar Başlığı”

```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 Temel Kimlik Doğrulaması”

```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!"
    }]
  }'
```

=== “Şifre Olarak API Anahtarı”

```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!"
    }]
  }'
```

Yanıt

Başarılı Yanıt

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

Yanıt Alanları

AlanTürAçıklama
’mesaj listesi kimliği’tamsayıMesaj listesi için benzersiz tanımlayıcı
’mesaj Kimliği’dizeHer mesaj için benzersiz tanımlayıcı
’durum’dizeMesaj durumu: ‘kabul edildi’, ‘reddedildi’, ‘başarısız'
'parçalar’tamsayıMesaj parçası sayısı (SMS için)
‘müşteriMesajId’dizeDahili tanımlayıcınız (varsa)
‘e’dizeAlıcının telefon numarası

Mesaj Türleri

SMS

Basit metin mesajları:

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

Viber Promosyonu

Zengin medya içeren tanıtım mesajları:

{
  "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 İşlemsel

İşlem bildirimleri:

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

Viber OTP

Tek kullanımlık şifre bildirimleri:

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

Hata İşleme

HTTP Durum Kodları

KodAçıklama
200İstek başarılı
400Hatalı istek - geçersiz parametreler
401Yetkisiz - kimlik doğrulama başarısız oldu
429Çok fazla istek - oran sınırı aşıldı
500Dahili sunucu hatası

Hata Yanıtı

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

En İyi Uygulamalar

Telefon Numarası Formatı

Telefon numaraları için her zaman E.164 biçimini kullanın:

  • ✅ Doğru: ‘+380XXXXXXXXXX’
  • ❌ Yanlış: ‘380XXXXXXXXXX’, ‘0XXXXXXXXX’

Mesaj Metni

  • Birden fazla bölümden kaçınmak için SMS’i 160 karakterin altında tutun
  • Uluslararası karakterler için UTF-8 kodlamasını kullanın
  • Toplu göndermeden önce özel karakterleri test edin

TTL (Yaşam Süresi)

  • Zamana duyarlı mesajlar için uygun TTL’yi ayarlayın
  • OTP mesajları: 300-600 saniye (5-10 dakika)
  • Promosyon mesajları: 3600-86400 saniye (1-24 saat)

Müşteri Mesaj Kimliği

  • Her mesaj için benzersiz tanımlayıcılar kullanın
  • İzleme ve hata ayıklamaya yardımcı olur
  • Sisteminizin kayıtlarıyla ilişkilendirmek için kullanışlıdır

Hız Limitleri

Aşağıdakilerle ilgili bilgi için hesap yöneticinizle iletişime geçin:

  • Saniyedeki mesajlar
  • Günlük mesajlar
  • Eşzamanlı bağlantılar

Sonraki Adımlar