MODÜL HAKKINDA

Otomatik Sms Sistemi

GET veya POST methoduyla ilgili url’e tanımlanmış parametreler ile sms gönderme isteğinde bulunabilirsiniz.

SANAL SANTRAL SCRİPT KODU

procedure DonusYap;
begin
//Api fonksiyonu çalıştır.
API(s,‘http://websms.telsam.com.tr/get_api.php?username=ApiKullanıcıAdı&password=ApiŞifre&receivers=538400XXXX&text=Donus%20yapılacak%20numara:

${CALLERID(num)}&originator=Başlık’);
//Ses çal.
PlayBack(‘Donusyapilacaktir’);

//Çağrıyı sonlandır.
Hangup;
end;

TANIMLAMALAR

Parametre Zorunluluk Tanım Açıklama
username + Zorunlu Kullanıcı Adı
password + Zorunlu Şifre
receivers + Zorunlu Alıcı gsm numaraları ·          Birden fazla numara belirtmek için “,” (virgül) ayracı kullanılmalıdır.

·          Eğer mesaj raporlarının takibi için id belirtmek isterseniz numaranın başına önce id değerinizi, ayraç olarak “:” karakterini daha sonra alıcı numarasını girebilirsiniz. Kullanmaz iseniz sistem kendi id leri ile döndürür.

text + Zorunlu SMS Mesajı Maksimum limit 1080 karakter olabilir.
originator + Zorunlu SMS Başlığı
international Uluslar arası – Yurtiçi mesah gönderim seçeneği ·          1 => Uluslararası mesaj

·          0 veya belirtilmemiş => yurtiçi mesaj

canceltext Mesajın sonuna iptal bilgisi eklensin mi? ·          1 => iptal bilgisi eklensin

·          0 veya belirtilmemiş => eklenmesin.

unicode Mesaj kodlaması ·          1 => Unicode karakter destekli

·          8 => Türkçe karakter destekli

·          0 veya belirtilmemiş =>standart gsm karakterleri

delivery_time İleri tarihli sms ·          Belirtilmez ise hemen gönderim

·          Y-m-d H:i:s formatında tarih belirtilir ise ileri tarihli gönderim

response_type Dönüş cevap şekli ·          “html” belirtilebilir

·          Belirtilmez ise defaul “json” değerini alır

APİ

http://websms.telsam.com.tr/get_api.php?username=ApiKullanıcıAdı&password=ApiŞifre&receivers=538400XXXX&text=${CALLERID(num)}&originator=Telsam

http://websms.telsam.com.tr/get_api.php?username=ApiKullanıcıAdı&password=ApiŞifre&receivers=538400XXXX&text=Arama%20geldi:${CALLERID(num)}&originator=Telsam

BAŞARILI DÖNÜŞ

{“status”:true,”data”:{“sms_id”:13264888,”sms_count”:1,”amount”:”0.0060″,”credit”:”5202.2040″,”valid_receiver”:1,”invalid_receiver”:0,”receivers”:[{“id”:”123″,”gsmNo”:”538400xxxx”,”valid”:true}]}}

HATALI DÖNÜŞ

{“status”:false,”error”:{“code”:2,”message”:”Invalid username or password”}}

HATALI DÖNÜŞ KODLARI

Hata Kodu Hata Mesajı
0 İstek bulunamadı
1 İstek parametreleri eksik. Zorunlu değerler: kullanıcı adı, şifre, alıcılar, metin, kaynak
2 Geçersiz kullanıcı adı veya şifre
3 Erişim reddedildi
4 Orijinalinde geçersiz karakterler bulundu
5 Gönderen uzunluğu en az 3, en çok 11 karakter olmalıdır
6 Gönderen yasaklandı
7 Başlık sistemimizde bulunamadı
8 Gönderen onay bekliyor
9 Alfanümerik SMS bakımda geçici olarak gönderme
10 Alıcı bulunamadı
11 Geçerli bir alıcı bulunamadı
12 Mesaj metni boş
13 Mesajın içinde kötü kelimeler bulundu
14 Kredi yeterli değil
15 Teslim Süresi geçersiz
16 Sistem hatası. Lütfen tekrar deneyin
99 Bilinmeyen hata oluştu