Ara K
Görünüm
1. NetSantral IVR
2. Kısa Mesaj (İnteraktif SMS)
3. Kısa Link
4. Webhook (Web Kancası)
5. API
6. Web Arayüz ile Adres Yükleme
İzin ve ret işlemleri Netsantralde IVR oluşturularak gerçekleştirilebilir. Netgsm Webportal >> Dijital Servisler >> Netiys >> Uygulamalar >> NetsantralIVR menüsü üzerinden detaylı bilgiye ulaşılabilir.
NetİYS entegrasyonu ile arayan numaranın, markanızın İleti yönetim sistemine kayıtlı olup olmadığına karar verebilir, Onay ve Ret işlemlerini sağlayabilirsiniz.
Onaylı Numara Kontrolü Fonksiyonu: Telefon numarasından İYS sistemi üzerinde numaranın onaylı olup olmadığı kontrolünü yapar.
Onay Alma Fonksiyonu: Arayan numara ile İYS sisteminde onay alma fonksiyonudur.
Reddetme Fonksiyonu: Arayan numarayı IYS sisteminde reddeden fonksiyondur.
Anahtar kelimeler belirlenerek kısa mesaj ile izin ve ret işlemleri gerçekleştirilebilir.
Netgsm Webportal >> Dijital Servisler >> Netiys >> Uygulamalar >> Kısa Mesaj >> İnteraktif SMS Tanımlama >> Yeni Kural Ekle şeklinde ulaşılabilir.
NetİYS Kısa Mesaj (İnteraktif SMS) modülü ile yeni kurallar tanımlanır ve tanımlanan kurallar dahilinde alınan mesajlar ile onay ve ret işlemleri yapılmaktadır.
Kısa Mesaj (İnteraktif SMS) modülünü kullanarak var olan interaktif SMS kurallarını görebilir ve üzerinde değişiklik yapabilirsiniz.
Öncelik sırası, eğer birden fazla aynı anahtar kelime ile kural tanımlanırsa öncelik sırası küçük olan kural çalışır.
Örnek Kural:
Kısa link uygulaması; ret ve izin işlemlerini link üzerinden yapılmasına olanak sağlayan NetİYS modülü uygulamasıdır. Uygulama ile telefon numarası ve mail adresi bilgilerine ait izin ve ret işlemleri yapılabilir.
Kısa link oluşturuken izin ve ret işlemleri yapılacak marka bilgisi seçilmelidir.
İstenirse markaya ait logo yüklenebilir; kısa link adresinde, yüklenen logo gösterilebilir.
29417 sayılı Ticari İletişim ve Ticari Elektronik İletiler Hakkında Yönetmelik gereği Kısa link, SMS gönderimlerinde RET-çıkış hakkı olarak kullanılamamaktadır. SMS içeriğinde RET hakkı için 0800'lü ücretsiz tüketici hattı kullanmanız gerekmektedir. Kısa Link'i mail içeriklerinde veya web sayfanızda RET-çıkış hakkı olarak kullanabilirsiniz.
Netgsm Webportal >> Dijital Servisler >> Netiys >> Uygulamalar >>Kısa link (incele) >> Kısa link tanımlama >> Yeni kısa link şeklinde ulaşılabilir.
NetİYS hizmeti kullanılarak yüklenen onay ve ret bilgilerinin sonuç durumları Webhook uygulaması kullanılarak alınabilir.
Sonuç durumu bilgisi Webhook olarak tanımlanan URL adresine iletilir.
Adres yükleme, adres sorgulama ve webhook API’leri için https://www.netgsm.com.tr/dokuman/#İys-adres-yükleme adresini inceleyebilirsiniz.
İYS Adres Yükleme
İYS API Servisi ile Hizmet sağlayıcıların Netgsm İYS İş ortağı aracılığıyla iletişim adreslerini yükleyebilirsiniz.
JSON Post ve Gönderilecek parametreler ;
*username: Sisteme girişte kullanılan kullanıcı adı veya abone numarasıdır.
*password: Sisteme girişte kullanılan şifredir.
*brandCode : Adres izinlerini yüklemek istediğiniz marka kodunuz.
refid: Belirleyeceğiniz bir ID göndererek daha sonra requestin durumunu refid ile sorgulayabilirsiniz. Header içerisinde gönderilir.
*type: İletişim adres türü ARAMA, MESAJ ya da EPOSTA dan biri olmalıdır.
*source:İzin alınan kaynaktır, HS_FIZIKSEL_ORTAM, HS_ISLAK_IMZA, HS_WEB, HS_CAGRI_MERKEZI, HS_SOSYAL_MEDYA, HS_EPOSTA, HS_MESAJ, HS_MOBIL, HS_EORTAM, HS_ETKINLIK, HS_2015, HS_ATM ve HS_KARAR değerlerini alabilir.
*recipient: İzin alınan kullanıcının adres bilgisidir. +905XX XXX XX XX ya da [email protected] formatlarında olmalıdır.
*status: ONAY ya da RET değerini gönderebilirsiniz.
*consentDate: İzin alınan tarih bilgisi YYYY-mm-dd HH:mm:ss formatında gönderilmelidir.
*recipientType: BIREYSEL ya da TACIR parametre olarak gönderilmelidir.
RetailerCode : İzin alınmasına aracılık eden bayiye İYS tarafından atanan İYS numara bilgisidir. Nümerik olmalı.
RetailerAccess:İzne erişimi olan bayilere İYS tarafından tekil olarak atanan İYS numaralarını gösterir. Nümerik olmalı
İYS Adres Sorgulama
İYS veritabanına yüklemiş olduğunuz datalarınızın izinlerinin gerçekleşip gerçekleşmediği sonucunu api ile adres yüklerken belirlenen refid parametresi göndererek sorgulayıp öğrenebilirsiniz. İznin gerçekleşmeme ihtimalinden dolayı adres sorgulama önemli bir işlemdir. API isteklerine dönen hata kodlarına ve hata mesajlarına https://apidocs.iys.org.tr/#tag/HATA-KODLARI ‘dan ulaşabilirsiniz.
JSON Post ve Gönderilecek Parametreler;
*username:Sisteme giriş yaparken kullanılan kullanıcı adı veya abone numarasıdır.
*password:Sisteme giriş yaparken kullanılan şifredir.
*brandCode: İletişim adresi izinlerinizi yüklediğiniz marka kodunuz.
*type: İletişim adres türü ARAMA, MESAJ ya da EPOSTA dan biri olmalıdır.
*recipient: İYS’de kaydını sorgulayacağınız iletişim adres bilgisidir.
+90 5XX XXX XX XX ya da [email protected] formatlarında olmalıdır.
*recipientType: BİREYSEL ya da TACİR parametre olarak gönderilmelidir.
refid refid ile eklenen adresi sorgulayabilirsiniz, refid kullanıldığında recipient, recipientType ve type zorunlu değildir. Yalnızca refid gönderilebilir. Data parametresinde gönderilir.
Adres sorgulama API’si için https://www.netgsm.com.tr/dokuman/#İys-adres-sorgulama adresini inceleyebilirsiniz.
İYS Webhook
İYS’ye yüklenen izin ve ret bilgilerinin sonuç durumları, Webhook kullanılarak alınabilir. Bütün kanallardan gelen izin ve ret işlemlerinin bildirimi webhook olarak tanımlanan URL adresine yapılır.
URL’e bildirilen alanlar ;
iyscode: İYS’de kayıtlı numaranız.
brancode: İYS’de kayıtlı marka kodunuz.
type: İletişim adres türü ARAMA, MESAJ ya da EPOSTA dan biri döner.
source: İzin alınan kaynağı ifade eder, HS_FIZIKSEL_ORTAM, HS_ISLAK_IMZA, HS_WEB, HS_CAGRI_MERKEZI, HS_SOSYAL_MEDYA, HS_EPOSTA, HS_MESAJ, HS_MOBIL, HS_EORTAM, HS_ETKINLIK, HS_2015, HS_ATM ve HS_KARAR ya da IYS_3338, IYS_CM, IYS_WEB, IYS_MOBIL, IYS_KISA_LINK değerlerinden biri döner.
status: ONAY ya da RET değeri döner.
consentDate: İzin alınan tarih bilgisi YYYY-mm-dd HH:mm:ss formatında döner.
recipientType: BIREYSEL ya da TACIR olarak döner.
retailercode: İzin alınmasında aracılık eden bayinin iyscode bilgisidir.Nümerik bayi iyscode değeri döner.
retailerAccess: İzne erişimi olan bayilerin iyscode bilgisidir. {123456,789456} formatında bayi iyscode döner.
submitid: İzin yüklenirken oluşturulan, izin paketinin id bilgisidir. “40e6215d-b5c6-4896- 987c-f30f3678f608” formatında id verisi döner.
recipient: İzin alınan kişinin telefon numarası ya da e-posta adresi bilgisidir. Telefon numaraları E164 uluslararası ( [+][country code][area code][local phone number] ) formatında döner.
resultstatus: İznin işlenme durum bilgisidir. success iznin eklendiğini, failure iznin eklenmediğini gösterir.
errcode: İzin işlenirken karşılaşılan hata kodu bilgisdir. “H155” formatında İYS hata kodu formatındadır.
errmsg: İzin işlenirken karşılaşılan hata mesajı bilgisdir. Metin formatında hata mesajı döner.
creationdate: İznin İYS tarafında işleme alındığı tarih bilgisidir. YYYY-MM-DD HH:mm:ss formatında tarih verisi döner.
İYS webhook API’si için https://www.netgsm.com.tr/dokuman/#İys-webhook adresini inceleyebilirsiniz.
Netiys arayüzünden adres kayıtlarınızın bulunduğu dosyayı yükleyerek İys’ye adres kaydı yapabilirsiniz.
Netgsm abone hesabınıza giriş sağladıktan sonra markanızı seçerek Dijital servisler ≫ NetİYS ≫ Dosya Yükle adımları ile .xls , .xlsx , .csv uzantılı adres dosyanızı yükleyebilirsiniz.