Bilgi Bankası
Script ile sms gönderimi
GET veya POST methoduyla ilgili url’e tanımlanmış parametreler ile sms gönderme isteğinde bulunabilirsiniz.
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 |