Mobildev JAVA API, SMS gönderimi için, iki adet sınıf sunmaktadır. Bunlar:

1. Aynı mesajı farklı numaralara göndermek için SmsToMany
2. Farklı mesajları farklı numaralara göndermek için SmsMultiSender

Mobildev olarak, JAVA API üzerinden göndereceğiniz toplu mesaj paketlerinin boyutunu 30.000’i aşmayacak şekilde ayarlamanızı öneririz.

1. SmsToMany Sınıfı

SmsToMany sınıfı, GSM numaralarına aynı içeriğe ait mesajın gönderilmesinde kullanılır.Bunu yapmak için SmsToMany sınıfından bir örnek aldıktan sonra:

• SetUsername() yöntemine kullanıcı adını,

• SetPassword() yöntemine kullanıcı adına ait şifreyi,

• SetOriginator() yöntemine Originator bilgisini,

• SetMessage() yöntemine en fazla 160 karakter uzunluğundaki (Türkçe ve “&”,”<”,”>”,ENTER,LineFeed gibi özel karakterler içermeyen) mesaj içeriğini,

• Eğer yapacağınız gönderimin ileri bir tarihte gerçekleşmesini istiyorsanız SetDate() yöntemine GünAyYılSaatDakika (ggaayyyyssdd) şeklinde tarih bilgisini,

• SetNumbers() yöntemine mesajın gönderileceği GSM numaralarını belirttikten sonra SendMessage() yöntemini çağırırsanız mesaj paketi Gateway’a gönderilir. Gelen paket Gateway tarafından işlendikten sonra uygun geri dönüş değeri oluşturulur. Geri dönüş değerini SendMessage() yöntemini bir değişkene aktararak kullanabilirsiniz. Aşağıdaki örnekte SmsToMany sınıfının kullanımıyla ilgili örnek kod görülmektedir.

Örnek: SmsToMany sınıfı

import com.Mobilus.Sms.*;
  class merhaba
  {
    public static void main(String[] args)
    {
      try
      {
          SmsToMany cr = new SmsToMany();
          cr.SetUsername("test");
          cr.SetPassword("1111");
          cr.SetOriginator("SMSTEST");
          cr.SetMessage("Test mesajidir");
          cr.SetDate("180820041455");
          String[] numbers = {"05428112345,05556446022"};
          cr.SetNumbers(numbers);
          Object[] o = cr.SendMessage();
          System.out.println((String)o[0]);
      }
      catch(Exception e)
      {
          e.printStackTrace();
      }
    }
  }

SendMessage() yöntemiyle gönderilen SMS paketi Gateway’a ulaştığında iki çeşit geri dönüş değeri alınır:

1. İşlem başarılıysa: “ID: 3152005” şeklinde SMS paketine ait TimerID bilgisi döner.

2. Hata oluşmuşsa: Bknz. Hata kodları

2. SMSMultiSender Sınıfı

SmsMultiSender sınıfı, GSM numaralarına farklı içerikli mesajlar gönderilmesinde kullanılır. Bunu yapmak için SmsMultiSender sınıfından bir örnek aldıktan sonra:

• SetUsername() yöntemine kullanıcı adını,

• SetPassword() yöntemine kullanıcı adına ait şifreyi,

• SetOriginator() yöntemine Originator bilgisini,

• AddMessage() yöntemine en fazla 160 karakter uzunluğundaki (Türkçe ve “&”,”<”,”>”,ENTER,LineFeed gibi özel karakterler içermeyen) mesaj içeriğini ve mesajın gönderileceği cep telefonu numarasını,

• Eğer yapacağınız gönderimin ileri bir tarihte gerçekleşmesini istiyorsanız SetDate() yöntemine GünAyYılSaatDakika (ggaayyyyssdd) şeklinde tarih bilgisini belirttikten sonra SendMessage() yöntemini çağırırsanız mesaj paketi Gateway’a gönderilir.Gelen paket Gateway tarafından işlendikten sonra uygun geri dönüş değeri oluşturulur. Geri dönüş değerini SendMessage() yöntemini bir değişkene aktararak kullanabilirsiniz. Aşağıdaki örnekte SmsMultiSender sınıfının kullanımıyla ilgili örnek kod görülmektedir.

Örnek: SmsMultiSender sınıfı

import com.Mobilus.Sms.*;
  class merhaba
  {
    public static void main(String[] args)
    {
      try
      {
        SmsToMany cr = new SmsToMany();
        cr.SetUsername("test");
        cr.SetPassword("1111");
        cr.SetOriginator("SMSTEST");
        cr.SetMessage("Test mesajidir");
        cr.SetDate("180820041455");
        cr.AddMessage("05356446022","Test mesajidir bu.");
        cr.AddMessage("05428112345","multi test messaji");
        Object[] o = cr.SendMessage();
        System.out.println((String)o[0]);
      }
      catch(Exception e)
      {
        e.printStackTrace();
      }
    }
  }

SendMessage() yöntemiyle gönderilen SMS paketi Gateway’a ulaştığında iki çeşit geri dönüş değeri alınır:

1. İşlem başarılıysa: “ID: 3152005” şeklinde SMS paketine ait TimerID bilgisi döner.

2. Hata oluşmuşsa: Bknz. Hata kodları