SmartMessage Engage
İYS Marka Numarası Tanımlama ve Web Servis Parametreleri Kılavuzu
V3 18.06.2021
smartmessage.com
2
Yeni gelen mevzuat ile GSM operatörlerine SMS gönderimi sırasında Hizmet Sağlayıcıların (Firmaların) izinlerini İYS (İleti Yönetim Sistemi) üzerinden kontrol etme zorunluluğu getirilmiştir.
Bu kapsamda, 16.07.2021 itibarıyla, SmartMessage Engage platform üzerinden yapılan SMS, MMS, TCKN ve VKN gönderimlerinde GSM Operatörlerine, İYS Marka Numarası (Brandcode), Alıcı Tipi (Recipient Type) ve Mesaj Tipi (Message Type) alanları gönderilecektir.
Firmaların bu bilgileri SmartMessage Engage platformuna girebilmeleri için İYS Marka Kodu Tanımlama Ekranı oluşturulmuştur.
İYS’den muaf firmaların salessupport@smartmessage.com adresi üzerinden SmartMessage ile iletişime geçmeleri gerekmektedir.
İYS’den muaf olmayıp tercihen kayıt olmayan firmalar, 16.07.2021 tarihi itibarıyla sadece zorunlu bilgilendirme mesajları gönderebileceklerdir; reklam / promosyon / kampanya mesajları gönderemeyeceklerdir.
1. Kullanıcı Arayüzü
SmartMessage Engage platformunda “SMS”, “Dosyadan SMS”, “MMS”, “Dosyadan MMS” ile “Api SMS” ve
“MMS” kampanyaları oluşturma adımında tanımlama ekranı otomatik olarak açılacaktır.
Tanımlama ekranı aracılığıyla İYS Marka Numarası (Brand Code) ve Alıcı Tipi (Recipient Type) değerlerini giriniz.
Bu bilgileri girmeniz bir kereliğine gerekmektedir.
3
Eğer firmanın birden fazla alfanumeriği bulunuyorsa tanımlama ekranının alt kısmında “Alfanumeriğe göre Brand Code kullanmak istiyorum.” seçeneği kullanılabilir.
Firma alfanumerik bazında Brand Code girmek isterse checkbox seçimini işaretleyerek altında açılan alfanumeriğe göre İYS Marka Numarası (Brand Code) ve Alıcı Tipi (Recipient Type) bilgilerini girilmesine imkan tanır.
Firmanın Default İYS Marka Numarası (Brand Code) ve Alıcı Tipi (Recipient Type) bilgilerini girmeden kaydet butonu ile ilerlemesine ve kampanya oluşturmasına izin verilmemektedir.
“Ertele” dediğiniz durumda 16.07.2021 tarihi itibarıyla sadece zorunlu bilgilendirme mesajları
gönderebilirsiniz; reklam / promosyon / kampanya mesajları gönderemeyeceksiniz. İzinli iletişim kurallarına uyma konusunda tüm sorumluluk Firma tarafına aittir.
Bu bilgiler girildikten sonra kampanya oluşturma adımında gönderilecek mesajın bilgilendirme/reklam olup olmadığını belirtmek için “Müşteri İletişim Tercihlerini Kullan” seçimi kullanılacaktır. “Müşteri İletişim Tercihlerini Kullan” seçeneği seçili ise gönderilecek mesaj “REKLAM” olarak değerlendirilip, GSM operatörü tarafından İYS’de sorgu yapılacağı anlamına gelir, seçili değilse “BİLGİLENDİRME” mesajı olarak değerlendirilir ve GSM operatörü İYS’ye sormadan direk olarak mesajı iletir. SmartMessage Engage, “Müşteri İletişim Tercihlerini Kullan” seçeneğini dikkate alarak GSM operatörüne bilgi gönderir.
Bilgilendirme Mesajı: Müşteriye her durumda ulaştırılması gereken, İYS nezdinde herhangi bir izin kontrolü yapılmadan gönderilecek mesajdır. Örneğin, doğrulama kodları, fatura bilgileri, ekstre bilgileri, vb.
4
“Müşteri İletişim Tercihlerini Kullan” kutucuğunun işaretlenmemesi durumunda aşağıdaki uyarı metni çıkacaktır.
Alfanumeriğe göre İYS Marka Numarası (Brand Code) ve Alıcı Tipi (Recipient Type) tanımlanmış ise kampanya oluştururken ilgili alfanumeriği seçtiğinde alfanumerik için tanımlı Brand Code ve Recipient Type bilgileri ile, eğer alfanumerik için tanımlı bir Brand Code yoksa Default Brand Code ve Recipient Type bilgileri operatöre gönderilecektir.
TCKN, VKN ve OTP SMS gönderimleri için Brand Code, Recipient Type ve Message Type bilgileri operatörde default tanımlı parametreden alınacaktır. OTP, TCKN, VKN providerlar için default Message Type =
"BILGILENDIRME", Bulk providerlar için Message Type = "REKLAM"dır. Bu durumda firmaların TCKN ve VKN kullandığı senaryoda default değer bilgilendirme olacağı için operatör tarafında İYS’den izin kontrolü yapılmayacaktır.
2. Web Servis
SmartMessage Engage uygulamasını sadece Web Servis veya Arayüz ve Web Servis birlikte kullanan firmalar, SmartMessage Engage arayüzüne, arayüz kullanıcı adı ve şifresi ile giriş yapmalıdır (web servis kullanıcı adı ve şifresi ile değil). SMS ya da MMS kampanyaları oluşturma ekranlarına girildiğinde çıkacak İYS Marka Numarası Tanımlama Ekranı aracılığıyla aşağıdaki 3 değer girilmelidir.
- Brand Code (İYS Marka Numarası): IYS tarafından markanıza özel verilen kod numarasıdır.
- Recipient Type (Alıcı Tipi): Bireysel/Tacir değerlerini alabilir.
- Message Type (Mesaj Tipi): REKLAM/BILGILENDIRME
Bu bilgileri girmeniz bir kereliğine gerekmektedir. Bu işlemden sonra mevcut Job ID tanımlarınızı (web servis üzerinden iletilen kampanya bilgisi) kullandığınız web servis tipine göre aşağıdaki yönlendirmeler doğrultusunda güncellemeniz gerekmektedir.
5 a) Rest Api
Web servislerde SMS ve MMS gönderimleri için de arayüzde olduğu gibi gönderilecek mesajların bilgilendirme/reklam olup olmadığını belirtmek için messagejob/Create metodu çağrılırken,
"preference_enable" parametresi kullanılacaktır.
Bu parametre “true” olarak gönderildiğinde “REKLAM”, “false” olarak gönderildiğinde “BILGILENDIRME”
mesajı olarak değerlendirilecektir.
{
"channel": "SMS",
"message_security": "STORE", "name": "string",
"content": "string", "date": {
"start": "string", "expire": "string"
},
"time_limit": { "start": "string", "stop": "string"
},
"from_list": [ {
"name": "string", "address": "string"
} ],
"campaign_group": "string", "provider_group": "string", "concat_enable": true, "category_list": [ "string"
],
"preference_enable": true,
"content_duplication_control": true, "urlshortener_enable": true
}
Bundan sonraki süreçte rest servis kullanımlarında “preference_enable” parametresinin kullanımı, İYS’den izin sorgulaması yapılıp yapılmayacağını belirlediğinden, firmaların bu parametreyi doğru şekilde göndermeleri önemlidir.
ÖNEMLİ: İYS geçişi öncesi oluşturulmuş kampanyalarda, bu parametre gönderilmemiş ya da yanlış değerle gönderilmiş olabilir bu sebeple bu parametrenin değerinin doğru şekilde güncellenmesi ya da gerekirse yeni kampanya oluşturulması gerekmektedir. Aksi halde reklam/pazarlama mesajları bilgilendirme olarak gönderilecek ya da bilgilendirme olarak gönderilmesi gereken mesajlar reklam olarak gönderdiğinden mesajlar alıcılara ulaşmayacaktır.
6 b) Soap Web Servis
Soap servislerde de SMS ve MMS gönderimleri için arayüzde olduğu gibi gönderilecek mesajın bilgilendirme/reklam olup olmadığını belirtmek için CREATECAMPAIGN metotu içerisinde yer alan "PREFERENCECONTROLENABLE" parametresi kullanılacaktır.
Bu parametre “TRUE” olarak gönderildiğinde “REKLAM”, “FALSE” olarak gönderildiğinde “BILGILENDIRME”
mesajı olarak gönderilecektir.
<CREATECAMPAIGN>
<VERSION>2.2</VERSION>
<USR>XXXX </USR>
<PWD>XXXX</PWD>
<CAMPAIGNTYPE>EML</CAMPAIGNTYPE>
<MESSAGESECURITY>0</MESSAGESECURITY>
<NAME>Test </NAME>
<BODY>içerik</BODY>
<MESSAGEFROMNAME>Engage 5.7 Tester</MESSAGEFROMNAME>
<MESSAGEFROMADDRESS>Engage 5.7 Tester@Test.Smartmessage- Engage.Com</MESSAGEFROMADDRESS>
<CAMPAIGNGROUPNAME>Standart</CAMPAIGNGROUPNAME>
<REPLYTOADDRESS>noreply@deneme.com.tr</REPLYTOADDRESS>
<SUBJECT>Konu</SUBJECT>
<WORKINGDAYS>MO,TU,WE,TH,FR,SA,SU || 1,2,3,4,5,6,7</WORKINGDAYS>
<PREFERENCECONTROLENABLE>TRUE</PREFERENCECONTROLENABLE>
<CONTENTDUPLICATIONENABLE>TRUE</CONTENTDUPLICATIONENABLE>
</CREATECAMPAIGN>
Bundan sonraki süreçte soap servisler için "PREFERENCECONTROLENABLE" parametresinin kullanımı İYS’den izin sorgulaması yapılıp yapılmayacağını belirlediğinden, firmaların bu parametreyi doğru şekilde göndermeleri önemlidir.
ÖNEMLİ: İYS geçişi öncesi oluşturulmuş kampanyalarda bu parametre gönderilmemiş ya da yanlış değerle gönderilmiş olabilir bu sebeple bu parametrenin değerinin doğru şekilde güncellenmesi ya da gerekirse yeni kampanya oluşturulması gerekmektedir. Aksi halde reklam/pazarlama mesajları bilgilendirme olarak gönderilecek ya da bilgilendirme olarak gönderilmesi gereken mesajlar reklam olarak gönderdiğinden mesajlar alıcılara ulaşmayacaktır.
7 c) SENDSMS Methodu
SmartMessage Engage arayüzünde “Kampanya Yönetimi” bölümüne gelinir.
“Entegrasyon” tab’ine gelinir. Başlangıç tarihi biraz geriye çekilerek (2010 örneğin) arama yapılır.
Çıkan webservis kampanyalarından güncelleme gereken kampanyanın (job id’ye ait kampanya) sol tarafındaki aşağı oka tıklanarak kampanya açılır ve “güncelle” denir.
Güncelleme ekranında ilgili webservisle yapılan gönderimlerin içeriği doğrultusunda “Müşteri iletişim tercihlerini kullan” seçeneği işaretlenir veya işaretlenmez.
Reklam, promosyon, kutlama gibi kampanyalarda “Müşteri iletişim tercihlerini kullan” seçeneği seçilmelidir, aksi takdirde üyelik listenizden ayrılmış, sizden SMS almak istemeyen kişilere de gönderim yapılır ve hukuki sonucu olabilir.
“Müşteri iletişim tercihlerini kullan” seçeneğini seçmediğiniz durum sadece zorunlu “bilgilendirme”
mesajları için olabilir. Şifre gönderimi, zorunlu bilgilendirmeler gibi.