Help Center TurboSMS API Uyumluluğu

TurboSMS API Uyumluluğu

SMSBAT, TurboSMS API ile uyumluluk katmanını tamamen destekler. Bu, TurboSMS için tasarlanmış mevcut entegrasyonlarınızı, mesaj yapılarını veya uç nokta yüklerini yeniden yazmaya gerek kalmadan doğrudan SMSBAT’a taşımanıza olanak tanır.

Zaten aşina olduğunuz aynı istek gövdesi yapılarını kullanarak SMS ve Viber mesajları göndermeyi (atlıkarıncalar ve anketler gibi gelişmiş özellikler dahil), durumları almayı ve mesaj ayrıntılarını almayı destekliyoruz.

Kimlik Doğrulama

Yerel TurboSMS API’sinden tek farkı Kimlik Doğrulama mekanizmasıdır. TurboSMS özel bir “belirteç” sorgu parametresi veya belirli bir kimlik doğrulama başlığı kullanırken, SMSBAT standart bir Taşıyıcı Belirteci gerektirir.

Tüm istekler için SMSBAT API Simgenizi “Yetkilendirme” başlığına eklemelisiniz:

Authorization: Bearer YOUR_SMSBAT_TOKEN

Temel URL

Tüm uç noktaların SMSBAT API temel URL’sine yönlendirilmesi gerekir:

https://restapi.smsbat.com

Tek Mesaj Gönder

Uç nokta: ‘POST /api/tsms/message/send’

Hibrit dağıtım desteğiyle SMS ve Viber mesajlarının gönderilmesine izin verir (SMS geri dönüşüyle Viber). Tek bir gönderme isteğini işler ve her alıcı için teslimat sonuçlarını döndürür.

Temel Yetenekler

  • Esnek Parametreler: Genel parametreler, belirli SMS/Viber parametreleri tarafından geçersiz kılınabilir.
  • İçerik: Viber karusellerini, anketlerini, dosya eklerini ve etkileşimli düğmeleri destekler.
  • Hata İşleme: Hatalar için bile HTTP 200’ü döndürür (yapılandırılmış hata yanıtları). Sistem hataları için “FATAL_ERROR” durumuyla birlikte “response_code: 999”.
  • Alıcı Hataları: “response_result” dizisinde belirli alıcı hataları döndürülür. Başarısız olan alıcılarda “message_id: null” ve belirli hata kodları bulunur.

İstek Örneği (Karma Mesaj)

{
  "sender": "GlobalSender",
  "text": "Test message",
  "recipients": ["380951111111", "380952222222"],
  "start_time": "2025-09-29T10:00:00Z",
  "sequence_id": "seq_12345",
  "sms": {
    "sender": "SMSSender",
    "text": "SMS version of message",
    "is_flash": false
  },
  "viber": {
    "sender": "ViberSender",
    "text": "Viber version of message",
    "ttl": 3600,
    "image_url": "https://example.com/image.png",
    "caption": "Button text",
    "action": "https://google.com",
    "count_clicks": true,
    "is_transactional": false
  }
}

{
  "sender": "GlobalSender",
  "text": "Check out our products",
  "recipients": ["380951111111"],
  "viber": {
    "sender": "ViberSender",
    "text": "Check out our products",
    "is_transactional": false,
    "carousel": [
      {
        "title": "Product 1",
        "image_url": "https://example.com/product1.jpg",
        "button_caption": "Buy Now",
        "button_url": "https://example.com/buy/product1",
        "link_caption": "Learn More",
        "link_url": "https://example.com/product1"
      },
      {
        "title": "Product 2",
        "image_url": "https://example.com/product2.jpg",
        "button_caption": "Buy Now",
        "button_url": "https://example.com/buy/product2",
        "link_caption": "Learn More",
        "link_url": "https://example.com/product2"
      }
    ]
  }
}

Talep Örneği (Viber Anketi)

{
  "sender": "GlobalSender",
  "text": "Please rate our service",
  "recipients": ["380951111111"],
  "viber": {
    "sender": "ViberSender",
    "text": "Please rate our service",
    "is_transactional": true,
    "survey": [
      "Excellent",
      "Good",
      "Average",
      "Poor"
    ]
  }
}

Birden Fazla Mesaj Gönder (Toplu)

Uç nokta: ‘POST /api/tsms/message/sendmulti’

Bu yöntem, tek bir HTTP isteğinde birden fazla “gönderme” isteği göndermenize olanak tanıyarak bağlantı masrafından tasarruf etmenizi sağlar. 100 isteğe ilişkin verilerle “sendmulti”yi çağırmak, 100 ayrı “gönderme” isteğini yürütmekten daha hızlı olacaktır.

İstek Örneği

{
  "batch_1": {
    "sender": "GlobalSender",
    "text": "Test message",
    "recipients": ["380982462128", "380501111111"],    
    "sms": {
        "sender": "SMSSender",
        "text": "SMS version of message"
    }
  },
  "batch_2": {
    "sender": "GlobalSender",
    "text": "Second message",
    "recipients": ["380501111111"],
    "viber": {
      "sender": "ViberSender",
      "text": "Viber message",
      "is_transactional": true
    }
  }
}

Yanıt Örneği

{
    "response_code": 0,
    "response_status": "OK",
    "response_result": {
        "batch_1": {
            "response_code": 800,
            "response_status": "SUCCESS_MESSAGE_ACCEPTED",
            "response_result": [
                {
                    "phone": "380982462128",
                    "response_code": 0,
                    "message_id": "f1640579-ea75-4bc1-b708-1c3858bf222d",
                    "response_status": "OK"
                }
            ]
        },
        "batch_2": { ... }
    }
}

Mesaj Durumunu Al

Uç nokta: ‘POST /api/tsms/message/status’

Gönderilen mesajların teslim durumlarını, ‘message_id’lerini sağlayarak alın.

İstek Örneği

{
  "messages": [
      "573dcb46-7851-4e16-bb1f-721c13ef5f38", 
      "6b7f9ff5-28c8-4f38-913b-31af6021fbea"
  ]
}

Mesaj Detaylarını Al

Uç nokta: ‘POST /api/tsms/message/details’

SMS ve Viber kanallarına ilişkin tüm yük ayrıntıları, fiyatlandırma ve kesin zaman damgaları da dahil olmak üzere, oluşturulan mesajlarla ilgili ayrıntılı bilgileri almanızı sağlar.

İstek Örneği

{
  "messages": [
      "573dcb46-7851-4e16-bb1f-721c13ef5f38", 
      "f1640579-ea75-4bc1-b708-1c3858bf222d"
  ]
}

Yanıt Örneği

{
    "response_code": 0,
    "response_status": "OK",
    "response_result": [
        {
            "message_id": "573dcb46-7851-4e16-bb1f-721c13ef5f38",
            "sms": null,
            "viber": {
                "added": "2025-09-29T14:17:02.577Z",
                "start": "2025-09-29T10:00:00Z",
                "sent": "2025-09-29T14:17:02.577Z",
                "updated": "2025-09-29T14:17:02.577Z",
                "sender": "ViberSender",
                "text": "Viber version of message",
                "recipient": "380982462128",
                "message_type": "promotional",
                "status": "Queued",
                "price": 0,
                "ttl": 3600,
                "caption": "Button text",
                "action": "https://google.com"
            },
            "response_code": 0,
            "response_status": "OK"
        }
    ]
}