Pisano Provider Tanımlama Dökümantasyonu
SMS Provider Tanımlama
SMS Provider tanımlaması, ilgili akışın SMS yoluyla gönderilebilmesi için kullanılan bir servis olarak tanımlanır.
Pisano tarafından daha önce entegrasyonu yapılmış servisler tercih edilebileceği gibi, kullanıcılar kendi yazdıkları servisleri de kullanabilirler.
Daha önce entegrasyonu yapılmış servislere örnek olarak Mobildev ve Codec SMS v.b verilebilir.
Yazılmış olan servisin kullanılabilmesi için, servis ihtiyacına uygun olarak aşağıda belirtilen sağlayıcı türlerinden herhangi biri seçilebilir.
Generic Message Provider (Global)
Generic SOAP Message Provider (Global)
Örneğin, "Generic Message Provider (Global)" sağlayıcı tipi seçildiğinde, gerekli alanların doldurulması gerekir. Bu alanlar tamamen servis ihtiyacına göre değişiklik gösterir. Pisano ile servis arasında en önemli unsur dinamik noktalardır. Örneğin, SMS Provider için yazılmış olan servisin bir phone key'i alması gerekir, ancak bu key'in dinamik olması beklenir. Dinamikleştirme işlemi, Pisano interpolasyonları kullanılarak yapılır. Aşağıdaki örnekte olduğu gibi, provider kısmında interpolasyonu tanımlandığında, gönderilecek kişinin telefon numarası sistem tarafından otomatik olarak bu alana doldurulacaktır.
Örneğin, Pisano telefon numaralarının başındaki "+" işaretini siliyor. Eğer servis sağlayıcınız telefon numarasının başında "+" işaretini bekliyorsa, bu durumda büyük olasılıkla işlem başarısız olacaktır. Bu gibi durumlarda, kendi provider'ınızı düzenlemeli ve tanımlamaları bu durumları göz önünde bulundurarak yapmalısınız.
Push Notification Provider Tanımlama
Push Notification Provider tanımlaması, SMS Sağlayıcısı sekmesi üzerinden yapılır ve Push Notification kanalı da SMS Sağlayıcıyı kullanır.
Push Notification Provider, ilgili akışın push notification yoluyla gönderilebilmesi için kullanılan servistir.
Pisano tarafından daha önce entegrasyonu yapılmış servisler tercih edilebileceği gibi, kendi yazdığınız servisi de kullanabilirsiniz.
Daha önce entegrasyonu yapılmış servislere örnek olarak Mobildev ve Codec SMS v.b verilebilir.
Yazmış olduğunuz servisi kullanmak için servis ihtiyacına göre aşağıda belirtmiş olduğumuz sağlayıcı türlerinden herhangi birini seçebilirsiniz.
Generic Message Provider (Global)
Generic SOAP Message Provider (Global)
Örneğin, "Generic Message Provider (Global)" sağlayıcı tipi seçildiğinde, gerekli alanların doldurulması gerekir. Bu alanlar tamamen servis ihtiyacına göre değişiklik gösterir. Pisano ile servis arasında en önemli unsur dinamik noktalardır. Örneğin, Push Notification Provider için yazılmış olan servisin bir phone key'i alması gerekir, ancak bu key'in dinamik olması beklenir. Dinamikleştirme işlemi, Pisano interpolasyonları kullanılarak yapılır. Aşağıdaki örnekte olduğu gibi, provider kısmında interpolasyonu tanımlandığında, gönderilecek kişinin telefon numarası sistem tarafından otomatik olarak bu alana doldurulacaktır.
Örneğin, Pisano telefon numaralarının başındaki "+" işaretini siliyor. Eğer servis sağlayıcınız telefon numarasının başında "+" işaretini bekliyorsa, bu durumda büyük olasılıkla işlem başarısız olacaktır. Bu gibi durumlarda, kendi provider'ınızı düzenlemeli ve tanımlamaları bu durumları göz önünde bulundurarak yapmalısınız.
Whatsapp Provider Tanımlama
WhatsApp Provider tanımlaması, SMS Sağlayıcısı sekmesi üzerinden yapılmaktadır ve WhatsApp kanalı da SMS Sağlayıcıyı kullanır
WhatsApp Provider, ilgili akışın push notification yoluyla gönderilebilmesi için kullanılan bir servistir.
Pisano tarafından daha önce entegrasyonu yapılmış servisler tercih edilebileceği gibi, kendi yazdığınız servisi de kullanabilirsiniz.
Daha önce entegrasyonu yapılmış servislere örnek olarak Mobildev ve Codec SMS v.b verilebilir.
Yazmış olduğunuz servisi kullanmak için servis ihtiyacına göre aşağıda belirtmiş olduğumuz sağlayıcı türlerinden herhangi birini seçebilirsiniz.
Generic Whatsapp Provider (Global)
Örneğin, "Generic Message Provider (Global)" sağlayıcı tipi seçildiğinde, gerekli alanların doldurulması gerekir. Bu alanlar tamamen servis ihtiyacına göre değişiklik gösterir. Pisano ile servis arasında en önemli unsur dinamik noktalardır. Örneğin, Whatsapp Provider için yazılmış olan servisin bir phone key'i alması gerekir, ancak bu key'in dinamik olması beklenir. Dinamikleştirme işlemi, Pisano interpolasyonları kullanılarak yapılır. Aşağıdaki örnekte olduğu gibi, provider kısmında interpolasyonu tanımlandığında, gönderilecek kişinin telefon numarası sistem tarafından otomatik olarak bu alana doldurulacaktır.
Örneğin, Pisano telefon numaralarının başındaki "+" işaretini siliyor. Eğer servis sağlayıcınız telefon numarasının başında "+" işaretini bekliyorsa, bu durumda büyük olasılıkla işlem başarısız olacaktır. Bu gibi durumlarda, kendi provider'ınızı düzenlemeli ve tanımlamaları bu durumları göz önünde bulundurarak yapmalısınız.
Mail Provider Tanımlama ve Template Özelleştirmesi
Mail provider tanımlaması, SMS Provider tanımlamasıyla aynı yapıda çalışır.
Mail entegrasyonu kısmında, gönderilen mail template şablonunuzu iki farklı şekilde özelleştirebilirsiniz.
Template Düzenleme
Birinci Yöntem Mail Kanallarınız sayfasında, şablonunu düzenlemek istediğiniz kampanyanın "Şablon" sütunundaki düzenle butonuna tıklayarak hazırladığınız mail template'i yapıştırmanız yeterli olacaktır.
Burada önemli olan kısım, oluşturulacak templatelerde anket yönlendirme kısmına bu keyin girilmesidir. Örneğin, yukarıda verilen template örneğinde olarak belirtilmiştir; buradaki keye dinamik olarak anket URL'si doldurulacaktır.
İkinci önemli olan kısım, provider kısmıdır. Şablon kısmında yapılan tanımlamalara göre, örneğin string bir veri girildiyse , ancak HTML bir veri girildiyse olarak belirtilmiştir. Mail provider’ınızın body kısmı bu tanımlamalara göre düzenlenmelidir.
Üçüncü önemli nokta, ve kısımlarıdır. Bu kısımlar, Pisano tarafından dinamik olarak doldurulacaktır.
- İkinci yöntem, Mail Kanallarınız sayfasından şablonunu düzenlemek istediğiniz kampanyanın Şablon sütunundaki düzenle butonuna tıklayarak keyini yapıştırmak olacaktır. Sonrasında, Mail Sağlayıcıları tabından mail sağlayıcınızın Request Template kısmını özelleştirerek hazırladığınız template kullanılabilir.
Burada fromName, fromEmail, replyEmail ve body kısımları sabit tutulacaktır.
Burada önemli olan birinci nokta, body kısmına HTML template kodunun string olarak gönderilmesidir.
İkinci önemli nokta, template kodunuzdaki keyidir. Çünkü bu, şablon kısmında tanımladığınız keyine karşılık gelecektir; yani bu kısım dinamik olarak anket URL'si ile doldurulacaktır.
Üçüncü önemli nokta, ve kısımlarıdır. Bu kısımlar, Pisano tarafından dinamik olarak doldurulacaktır.
Örnek Bir Mail Template (String)
Provider tanımlama mantığı, Pisano tarafında genel olarak aynı yapıda işlemektedir. Tek fark, entegrasyon biçimi ve kanallara göre dinamik olarak doldurulan değişen interpolasyonlardır.