Hakkımızda Tarifeler İletişim
Anında Cevap JSON APIAna Sayfa
Gönderim ve Sorgulama Hakkında
JSON Objeleri Hakkında
Hata Kodları
Gönderim Statüleri
Paket Gönderim Statüleri
Gönderim Yöntemleri
Tarih Aralığında Raporlama

Anında Cevap JSON API Kullanım Kılavuzunu indirmek için TIKLAYINIZ!


Başlangıç

Anında Cevap SMS, Turkcell'in yeni nesil mobil pazarlama hizmetleri için geliştirdiği bir üründür. Alıcıya gönderilen mesaj, flaş mesaj olarak telefonda görüntülenir. Kullanıcıya bir giriş yazısı gösterildikten sonra, onayı alınarak 16 farklı kurguda bilgi verilebilir veya gönderim yapılan kişilerden bilgi talebi alınabilir. Kullanıcı onayı ile cevap, SMS olarak 6721 kısa numarasına ücretsiz olarak gönderilir.

Aboneye gönderilen mesaj, operatör tarafından sim karta yüklenilen bir uygulamaya ihtiyaç duymaktadır. Bu nedenle Turkcell Anında Cevap Servisi, 64bit ve üzeri sim kartlarda çalışmaktadır.

16 farklı kurguda, en fazla 4 ekran ve 2 adet soru sorulabilir. Toplam 3 farklı ekran ve 2 farklı aksiyon bulunmaktadır. Kurumların ihtiyaçlarına göre yeni kurgular planlanabilir veya tasarlanabilir.

1. Ekran
1.1 Bilgilendirme Mesajı (DisplayText, DisplayText2, displayText3)DT
1.2 Değer Al(GetInput) GI
1.3 Listeden Seç (SelectInput) SI
2. Aksiyon
2.1 Mesaj Gönder (SendSMS) SendSMS
2.2 Arama Yap (Call) Call


Gönderim ve Sorgulama Hakkında

Anında Cevap SMS gönderim ve raporlaması yapabilmek için taleplerin XML formatında hazırlanıp http://booster.mobildev.com/json adresine post edilmesi gerekmektedir. Her request'e karşılık olarak işleme ait durum bilgisi yine json formatında response verilir. Response objesinin code nodu “0” ise işlem başarılı, başka bir değer aldığında ise description alanında detaylı bilgi verilecektir. Ayrıca detaylı bilgi için, bkz. Hata Kodları.
{
"Response": {
"code": 0,
"description": ""
}
}

JSON Objeleri Hakkında

1. Authentication: Kullanıcı bilgilerinizin bulunduğu obje bilgisidir. Bu obje 3 değer alır.
1.1. Username: [açıklama]
1.2. Vendor_code: [açıklama]
1.3. Password: [açıklama]
2. Service ID: Yapılacak işleme ait ID bilgisi.
3. Content: Gönderime ait detaylar
3.1. Display Text: Kişiye gösterilecek bilgilendirme mesajı. En fazla 220 karakter olabilir.
3.2. GetInput: Kullanıcıdan bilgi alma amaçlı kullanılan ekran bilgisi, 2 zorunlu toplam 5 değer alır.
3.2.1. SMSText: Cevap gönderilirken mesaj metni başına eklenecek ayraç.
3.2.2. Text: Bilgi alma esnasında kullanıcıya gösterilecek mesaj en fazla 50 karakter olabilir.
3.2.3. Format: 3 farklı değer alabilir NUMERIC, ALPHANUMERIC, PASSWORD_NUMERIC
3.2.4. MinLength: Alınacak bilginin min. uzunluk değeri. Default 1
3.2.5. MaxLength: Alınacak bilginin max. uzunluk değeri. Default 50
3.3. SelectInput: Kullanıcının belirli seçenekler arasından seçim yapması için kullanılır.
3.3.1. SMSText: Cevap gönderilirken mesaj metni başına eklenecek ayraç.
3.3.2. Text: Bilgi alma esnasında kullanıcıya gösterilecek mesaj En fazla 50 karakter olabilir.
3.3.3. OptionList: Kullanıcıya gösterilecek seçenekler, tavsiye edilen seçenek sayısı 2- 6 arasında olmalıdır.
3.3.4. Option Value: Gönderilecek mesaj metni içerisine eklenecek seçim değeri.
3.4. Send SMS: Mesaj gönderim esnasında kullanıcıya gösterilecek bilgilendirme mesajıdır. En fazla 50 karakter alabilir.
3.5. Call: Arama başlatılacak MSISDN numarası.
4. MSISDNArray: Mesaj gönderilecek msisdn bilgileri (string array).
5. Description: Gönderime ait açıklama bilgisi.
6. Senddate: Gönderim gerçekleştirme tarihi bilgisidir. İleri tarihli olarak da kurulum yapılabilir. Geçerli Tarih formatı: yyyy-MM-dd HH:mm:ss (yıl-ay-gün saat-dakika-saniye)

Hata Kodları

Hata Kodu
Açıklama
0
Başarılı İşlem
1
Hatalı, geçersiz serviceId bilgisi
2
Gönderim Content bilgisi bulunamadı
3
MSISDNArray bilgisi hatalı / eksik
4
Hatalı / Eksik Parametre (hatalı parametre detaylı olarak açıklama alanında belirtilecektir.)
5
GetInput alanı eksik
6/8
SendSMS alanı eksik
7
SelectInput alanı eksik
9
Call MSISDN eksik
10
GetInput2 alanı eksik
11
SelectInput2 alanı eksik
12
Hatalı / Geçersiz PacketID bilgisi

Gönderim Statüleri

Statü
Açıklama
OK / Success
If all SIM service OTA short messages are delivered OK is returned as the result.
OK is the indication that all short messages are successfully received by the SIM card. But the reception of OK does not mean the successful execution of the commands by the SIM card. There is no way of knowing whether the SIM service is successfully displayed to the recipient.
NOT_SUBSCRIBER
The SIM Profile assigned to the MSISDN of service recipient subscriber does not support dynamic SIM services.
OTA_ENCRYPTION_FAILED
OTA could NOT encrypt the SIM service APDUs. This is most probably because of missing OTA keys.
NOK
If for any reason a SIM service OTA short message cannot be delivered to the recipient by SMSC, NOK is returned as the result. The primary reason for NOK is that SMSC cannot deliver the short message until the end of short message validity period. (The handset is turned off or is out of GSM coverage.) One other possibility is that the static SIM Service to be sent does not have any content.
TIMEOUT
A request timeout was detected by Interactive application. This result is returned when OTA does return a response for a request. (Very low probability.)
SYSTEM ERROR
A system failure that unexpectedly terminates the processing of SIM Service request is detected. (Very low probability.)


Paket Gönderim Statüleri

Statü
Açıklama
0
Gönderim beklemede
1
Gönderim tamamlandı
6
Hata oluştu (hata detayı error message alanında belirtilir)
7
Hatalı JSON / XML formatı
9
Gönderiliyor.
 

Gönderim Yöntemleri

1. DT_GI_SMS (Bilgilendirme Mesajı, Bilgi Al, Mesaj Gönder)
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 3,
"Content": {
"DisplayText": "Sayin Ozan Özgür ERDOĞAN, Lutfen kayitlarimizda eksik bulunan TC Kimlik Numaranizi giriniz.",
"GetInput": {
"SMSText": "TCKN ",
"Text": "TCKN : ",
"Format": "NUMERIC",
"MinLength": 11,
"MaxLength": 11
},
"SendSMS": "Kimlik numaraniz gonderiliyor..."
},
"MSISDNArray": ["5331234567"],
"Description": "",
"Senddate": "2014-09-15 03:12:00" }


Response Format:
{ "Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}

2. DT_SI_SMS (Bilgilendirme Mesajı, Değer Seç, Mesaj Gönder)
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 4,
"Content": {
"DisplayText": "13.06.2012 10:56'da ABC'de yaptiginiz 150TL tutarindaki alisverisinizi taksitlendirmek ister misiniz?",
"SelectInput": {
"SMSText": "TAKSIT ",
"Text": "SECIMINIZ : ",
"OptionList": ["Taksit İstemiyorum", "3 Taksit", "6 Taksit", "12 Taksit"],
"OptionValue": ["<EXIT>", "3", "6", "12"],
},
"SendSMS": "Tercihiniz gonderiliyor..."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}


3. DT_GI_SI_SMS (Bilgilendirme Mesajı, Bilgi Al, Değer Seç, Mesaj Gönder)
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 5,
"Content": {
"DisplayText": "Sayın Ma Donna, Anketimize katilmanizi rica ederiz.",
"GetInput": {
"SMSText": "YAS ",
"Text": "YASINIZ:",
"Format": "NUMERIC",
"MinLength": 1,
"MaxLength": 3
},
"SelectInput": {
"SMSText": "TAKIM ",
"Text": "TAKIMINIZ:",
"OptionList": ["BESIKTAS", "FENERBAHCE", "GALATASARAY", "DIGER"],
"OptionValue": ["BJK", "FB", "GS", "DIGER"],
},
"SendSMS": "Anketimize Katildiginiz icin tesekkurler..."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}

4. DT_SI_GI_SMS (Bilgilendirme Mesajı, Değer Seç, Bilgi Al, Mesaj Gönder)
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 6,
"Content": {
"DisplayText": "Sayın Ma Donna, Anketimize katilmanizi rica ederiz.",
"SelectInput": {
"SMSText": "TAKIM ",
"Text": "TAKIMINIZ:",
"OptionList": ["BESIKTAS", "FENERBAHCE", "GALATASARAY", "DIGER"],
"OptionValue": ["BJK", "FB", "GS", "DIGER"],
},
"GetInput": {
"SMSText": "YAS ",
"Text": "YASINIZ:",
"Format": "NUMERIC",
"MinLength": 1,
"MaxLength": 3
},
"SendSMS": "Anketimize Katildiginiz icin tesekkurler..."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}

5. DT_DT_SMS (Bilgilendirme Mesajı, Bilgilendirme Mesajı, Mesaj Gönder)
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 7,
"Content": {
"DisplayText": "Sayin Ma Donna, ABC'de Haziran ayi boyunca size ozel %50 indirim yapiyoruz.",
"DisplayText2": "ABC kartinizi yaninizda bulundurmayi unutmayin. En iyi dileklerimizle.",
"SendSMS": "Bilgileriniz Gönderiliyor..."
},
"MSISDNArray": [
"5321234567",
"5321234568",
"5321234568",
"5321234569"
],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}

6. DT (Bilgilendirme Mesajı)
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 10,
"Content": {
"DisplayText": "Sayin Ma Donna, ABC'de Haziran ayi boyunca size ozel %50 indirim yapiyoruz."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}



Response Format:

{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}

7. DT_SMS
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 11,
"Content": {
"DisplayText": "Sayin Ma Donna, ABC'de Haziran ayi boyunca size ozel %50 indirim yapiyoruz.",
"SendSMS": "Mesaj gonderiliyor..."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:

{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}

8. DT_GI_GI_SMS
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 12,
"Content": {
"DisplayText": "Sayın Ma Donna, Anketimize katilmanizi rica ederiz.",
"GetInput": {
"SMSText": "YAS ",
"Text": "YASINIZ:",
"Format": "NUMERIC",
"MinLength": 1,
"MaxLength": 3
},
"GetInput2": {
"SMSText": "BOY ",
"Text": "BOY:",
"Format": "NUMERIC",
"MinLength": 1,
"MaxLength": 3
},
"SendSMS": "Bilgiler gonderiliyor..."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}

9. DT_SI_SI_SMS
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 13,
"Content": {
"DisplayText": "Sayin Ma Donna, ABC'de Haziran ayi boyunca size ozel %50 indirim yapiyoruz.",
"SelectInput": {
"SMSText": "TAKIM ",
"Text": "TAKIMINIZ:",
"OptionList": ["BESIKTAS", "FENERBAHCE", "GALATASARAY", "DIGER"],
"OptionValue": ["BJK", "FB", "GS", "DIGER"]
},
"SelectInput2": {
"SMSText": "SERVIS ",
"Text": "FUTBOL SERVISI ILE",
"OptionList": ["ILGILENIYORUM", "ILGILENMIYORUM"],
"OptionValue": ["EVET", "HAYIR"]
},
"SendSMS": "Anketimize Katildiginiz icin tesekkurler..."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:

{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}

10. DT_SC (Bilgilendirme Mesajı, Arama Başlat (Setup Call))
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 14,
"Content": {
"DisplayText": "Sayin Ma Donna, ABC'de Haziran ayi boyunca size ozel %50 indirim yapiyoruz.",
"SMSText": "Mesaj gonderiliyor...",
"Call": "5321234567"
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:

{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}

11. DT_DT_SC
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 15,
"Content": {
"DisplayText": "Sayin Ma Donna, ABC'de Haziran ayi boyunca size ozel %50 indirim yapiyoruz.",
"DisplayText": "Indirimlerimiz hakkinda bilgi almak icin aramaya yonlendirileceksiniz onayliyormusunuz",
"SendSMS": "Bilgileriniz Gönderiliyor...",
"Call": "5321234567"
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}



12. DT_DT_GI_SI_SMS
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 16,
"Content": {
"DisplayText": "Sayın Ma Donna, Anketimize katilmanizi rica ederiz.",
"DisplayText2": "Ankete katilmak ucretsizdir katiliminiz icin tesekkur ederiz.",
"GetInput": {
"SMSText": "YAS ",
"Text": "YASINIZ:",
"Format": "NUMERIC",
"MinLength": 1,
"MaxLength": 3
}, "SelectInput": {
"SMSText": "TAKIM ",
"Text": "TAKIMINIZ:",
"OptionList": ["BESIKTAS", "FENERBAHCE", "GALATASARAY", "DIGER"],
"OptionValue": ["BJK", "FB", "GS", "DIGER"]
},
"SendSMS": "Bilgiler gonderiliyor..."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}


13. DT_DT_SI_SMS
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 17,
"Content": {
"DisplayText": "Sayın Ma Donna, Anketimize katilmanizi rica ederiz.",
"DisplayText2": "Ankete katilmak ucretsizdir katiliminiz icin tesekkur ederiz.",
"SelectInput": {
"SMSText": "TAKIM ",
"Text": "TAKIMINIZ:",
"OptionList": ["BESIKTAS", "FENERBAHCE", "GALATASARAY", "DIGER"],
"OptionValue": ["BJK", "FB", "GS", "DIGER"]
},
"SendSMS": "Bilgiler gonderiliyor..."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}


14. DT_DT_GI_SMS
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 18,
"Content": {
"DisplayText": "Sayın Ma Donna, Anketimize katilmanizi rica ederiz.",
"DisplayText2": "Ankete katilmak ucretsizdir katiliminiz icin tesekkur ederiz.",
"GetInput": {
"SMSText": "YAS ",
"Text": "YASINIZ:",
"Format": "NUMERIC",
"MinLength": 1,
"MaxLength": 3
},
"SendSMS": "Bilgiler gonderiliyor..."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}


15. DT_DT
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 21,
"Content": {
"DisplayText": "Sayın Ma Donna, Anketimize katilmanizi rica ederiz.",
"DisplayText2": "Ankete katilmak ucretsizdir katiliminiz icin tesekkur ederiz."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}


16. DT_DT_DT
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 22,
"Content": {
"DisplayText": "Sayın Ma Donna, Anketimize katilmanizi rica ederiz.",
"DisplayText2": "Ankete katilmak ucretsizdir katiliminiz icin tesekkur ederiz.",
"DisplayText3": "En kisa surede geri bildirim alacaksiniz."
},
"MSISDNArray": ["5321234567", "5321234568", "5321234568", "5321234569"],
"Description": "",
"Senddate": "2014-09-15 03:12:00"
}


Response Format:
{
"Response": {
"code": 0,
"description": ""
},
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}


Tarih Aralığında Raporlama

1. Packet ID Raporlama
Request Format :
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 1,
"PacketId": "b8a2469f586a47c5acffdaa2e3c26e"
}


Response Format:

{
"Response": {
"code": 0,
"description": ""
},
"Packet": {
"packetId": "b8a2469f586a47c5acffdaa2e3c26e",
"serviceId": 3,
"logdate": "15.09.2014 16:29",
"senddate": "15.09.2014 16:29",
"status": 1,
"errormessage": "",
"recordcount": 1,
"description": "",
"ipaddress": "0:0:0:0:0:0:0:1"
},
"Content": {
"DisplayText": "Sayin Ozan Özgür ERDOĞAN, Lutfen kayitlarimizda eksik bulunan TC Kimlik Numaranizi giriniz.",
"GetInput": {
"SMSText": "TCKN ",
"Text": "TCKN : ",
"Format": "NUMERIC",
"MinLength": 11,
"MaxLength": 11
},
"SendSMS": "Kimlik numaraniz gonderiliyor..."
},
"Logs": [
{
"msisdn": "5335801834",
"status": "SUCCESS",
"senddate": "15.09.2014 16:38",
"deliverydate": "",
"hasresponse": true,
"response": " TCKN61669457802"
}
]
}


2. Tarih Aralığında Raporlama
Request Format:
{
"Authentication": {
"username": "",
"vendor_code": "",
"password": ""
},
"ServiceId": 2,
"Start": "2014-09-01 00:00:00",
"End": "2014-10-01 23:59:59"
}



Response :
{
"Response": {
"code": 0,
"description": ""
},
"RecordCount": 1,
"Logs": [
{
"packetId": "b8a2469f586a47c5acffdaa2e3c26e",
"msisdn": "5335801834",
"status": "SUCCESS",
"senddate": "15.09.2014 16:38",
"deliverydate": "",
"hasresponse": true,
"response": " TCKN61669457802"
}
]
}


Test Hesabı AlProjem Var!


Follow @mobildev_tweets