XML kodu bir ‘smspack’ elementinden oluşur.

 

smspack Parametreleri & Parametre Değerleri:

 

*1. ka= Kayıt esnasında alınan kullanıcı adıdır.

 

*2. pwd= Kayıt esnasında alınan erişim parolasıdır, eğer oluşturmuşsanız E-postanıza gelen Apikey bilgisidir.

 

*3. org= Kayıt esnasında alınan originatörlerden biri olmalıdır. Originatörünüz yoksa bu parametre kullanılmayabilir

 

 4. Eğer mesaj ileri bir tarihte gönderilecekse tarih=“yyyy-aa-gg ss:dd” formatında bir parametrede eklenebilir.

 

Mesaj anında gönderilecekse bu parametre kullanılmamalıdır.

 

Örn: tarih=“2005-08-25 14:30”  veya tarih=“2005-12-31 23:59” gibi.

 

 5. Gönderilen mesajlar normalde 24 saat boyunca denenir. Bu süreyi artırmak yada azaltmak için bitis=“yyyy-aa-gg ss:dd” formatında bir parametrede eklenebilir.

 

Örn: bitis=“2005-12-31 23:59” gibi. Ulaşmayan mesajların denenmesi bu tarihte bitecektir.

 

 6. IP= Web sistemleri yada programlar üzerinden birden fazla ve farklı lokasyondaki kullanıcılara hizmet veren firmalar, sms'i gönderen sistemin IP'sini

bu alanda belirteceklerdir. Bu adres ilgili mevduatlar gereği MUTLUCELL sunucularında saklanmak durumundadır.(Örneğin: IP="78.85.12.15")

 

7. aboneid= Mesaj gönderen işletmeniz abonesi ise aboneid'si belirtilmelidir.(Örneğin: aboneid="14587")

 

 8. bayiid= Bayilerin uygulamalarına özel gönderimler için kullanılır.(Örneğin: bayiid="xyzsoft")

 

 9. zamanayay= Mesaj paketinin belirlenen süre boyunca parça parça gönderilmesini sağlar. Zaman parametresi dakika cinsinden yazılır ve en az 30

en çok da 720 dakika olabilir. (Örneğin: zamanayay="60")

10. addLinkToEnd= Bu parametreyi eklemeniz sonucu mesaj metninizin sonuna, " SMSRET http://ret.im/ABCDEFG" açıklaması eklenir. Mesajı alan numaralar linke tıklayarak bir daha mesaj almak istemediklerini belirtebilirler. Bu durumda mesaj gönderilen numara otomatik olarak karalisteye eklenir ve bu numaraya sms gönderimi engellenir.

 

      Örnek Kullanım: <smspack ka="kullanıcı_adım" pwd="parolam" org="MUTLUCELL" addLinkToEnd="true" >

 

 Not: İzin talep linki eklenmiş sms gönderimlerinde, mesajın karakter sayısını hesaplarken toplam karakter sayısına 29 karakter ilave etmeniz gerekmektedir.

 

11. shortCodeKeyword= Bu parametreyi eklemeniz sonucu mesaj metninizin sonuna, " SMS iptal icin " + KEYWORD + " yaz ****'a ücretsiz gönder" açıklaması eklenir. Mesajı alan numaralar belirtilen numaraya KEYWORD'u yazıp sms atarak bir daha mesaj almak istemediklerini belirtebilirler. Bu durumda mesajı gönderen numara otomatik olarak karalisteye eklenir ve bu numaraya sms gönderimi engellenir.

 

      Örnek Kullanım: <smspack ka="kullanıcı_adım" pwd="parolam" org="MUTLUCELL" shortCodeKeyword="KEYWORD" >

 

 Not: Bu parametreyi kullanabilmek için öncelikle Kısa Kod SMS gönderim aktivasyonunuzun yapılmış olması gerekmektedir. Aktivasyon için çağrı merkezimizle irtibata geçebilirsiniz. Aksi takdirde 20 hata kodu ile cevap alırsınız.

Kısa kod eklenmiş sms gönderimlerinde, mesajın karakter sayısını hesaplarken toplam karakter sayısına 50 + KEYWORD uzunluğu kadar karakter ilave etmeniz gerekmektedir.

 Eğer mesajınızı türkçe karakterlerle gönderiyorsanız (charset="turkish") ilave etmeniz gereken karakter sayısı 51 + KEYWORD uzunluğu olur.

 

12. charset= Mesajın, Türkçe gibi dillerde bulunan yerel karakterler (ş,ğ...) kullanarak gönderilmesi için kullanılır .(Örneğin: charset="turkish")

 

  12.1 charset="default"

          Mesajın içerisindeki türkçe karakterler ingilizce karakterlere dönüştürülür(ş=s, ğ=g...  gibi). 1 adet mesajın boyutu 155 karakterdir.

 

         Not: 7 bit gsm alfabesi genişleme tablosunda yer alan aşağıdaki karakterler escape'lenerek yazıldıkları için çift karakter sayılırlar.

         

                 ^  {  }  \  [  ]  ~  |  €

 

         155 karaktere kadar 1 sms olarak gönderilir.

 

         155 karakterden 301 karaktere kadar 2 sms olarak gönderilir.

 

         301 karakterden 454 karaktere kadar 3 sms olarak gönderilir.

 

         454 karakterden 607 karaktere kadar 4 sms olarak gönderilir.

 

         607 karakterden 760 karaktere kadar 5 sms olarak gönderilir.

 

         760 karakterden 913 karaktere kadar 6 sms olarak gönderilir.

 

          Mesaj, içerisindeki türkçe karakterlerle beraber gönderilir. 1 adet türkçe kısa mesajın boyutu 150 karakterdir. (Normal sms 155 karakterdir)

 

         Not 1: 7 bit gsm alfabesi genişleme tablosunda yer alan aşağıdaki karakterler escape'lenerek yazıldıkları için çift karakter sayılırlar.

         

                 ^  {  }  \  [  ]  ~  |

 

         Not 2: Gönderilen SMS'lerde aşağıdaki karakterler çift karakter sayılırlar.

         

                 Ş , ş , Ğ , ğ , ç , ı , İ

 

         150 karaktere kadar 1 sms olarak gönderilir.

 

         150 karakterden 293 karaktere kadar 2 sms olarak gönderilir.

 

         293 karakterden 442 karaktere kadar 3 sms olarak gönderilir.

 

         442 karakterden 591 karaktere kadar 4 sms olarak gönderilir.

 

         591 karakterden 740 karaktere kadar 5 sms olarak gönderilir.

 

         740 karakterden 889 karaktere kadar 6 sms olarak gönderilir.

     

 

   12.3 charset="unicode"

          Rusça, arapça gibi özel karakterli dillerle mesaj göndermek için kullanılır. 1 adet mesajın boyutu 65 karakterdir. (Normal sms 155 karakterdir)

 

         65 karaktere kadar 1 sms olarak gönderilir.

 

         65 karakterden 129 karaktere kadar 2 sms olarak gönderilir.

 

         129 karakterden 196 karaktere kadar 3 sms olarak gönderilir.

 

         196 karakterden 263 karaktere kadar 4 sms olarak gönderilir.

 

         263 karakterden 330 karaktere kadar 5 sms olarak gönderilir.

 

         330 karakterden 397 karaktere kadar 6 sms olarak gönderilir.

 

 

Örn1: <smspack ka="kullanıcı_adım" pwd="parolam" org="MUTLUCELL" >

 .

 .

 .

        </smspack>        

 

Örn2: <smspack ka="kullanıcı_adım" pwd="parolam" org="MUTLUCELL" charset="turkish" addLinkToEnd="true" >

 .

 .

 .

        </smspack>

 

Örn3: <smspack ka="kullanıcı_adım" pwd="parolam" org="MUTLUCELL" tarih="2011-08-27 18:30" bitis="2011-09 22:00" IP="78.85.12.15" aboneid="14587" >

 .

 .

 .

        </smspack>

 

 

Örn4: <smspack ka="kullanıcı_adım" pwd="parolam" org="MUTLUCELL" bayiid="xyzsoft" >

 .

 .

 .

        </smspack>        

 

13. periyot= Zamana yaymalı sms'lerde mesajın belirlenen periyodik zamanlarda parça parça gönderilmesini sağlar. Zaman parametresi dakika cinsinden yazılır ve en az 0

en çok da 60 dakika olabilir. (Örneğin: periyot="30")

 

14. brandCode= Markanıza özel, İleti Yöneti Sistemi(İYS) tarafından tekil olarak atanan İYS numarası bilgisidir.

Firmanızın, mal veya hizmetinizin tanıtımı, kutlama-temenni, promosyon, kampanya, indirim veya hediye içerikli tanınırlılığınızı artırmak amaçlı göndereceğiniz ticari elektronik iletiler İleti Yöneti Sistemi(İYS)'nden sorgulama yapılarak gönderilmelidir.

İYS'de kayıtlı olmayan bir numaraya ticari elektronik ileti gönderilemeyecek ve başarısız kabul edilecektir.

Göndereceğiniz alıcı tipi TACIR ise parametre bilgisi MarkaBilginiz_TACIR şeklinde olmalıdır. (Örneğin: brandCode="123456_TACIR")

TACIR bilgisini eklemediğinizde BIREYSEL izinlerinizde kontrol yapılacaktır. (Örneğin: brandCode="123456")

 

Smspack elementi mesaj elementlerinden oluşur. Bir smspackte (sms paketinde) sınırsız sayıda mesaj elementi olabilir.

 

 

Ayrıca Bakınız: Mesaj Elementi

 

*: işareti bulunduran parametrelerin gönderimi zorunludur.