Pisano Link Kısaltma Servisi (psn.vc)
Pisano tarafından sağlanan ve psn.vc alan adı üzerinden API’ı sağlanan link kısaltma servisi
- SMS ile gönderilen kişiye özel geri bildirim linkinin kısaltılması
- Geri bildirim linklerinin pazarlama materyalleri üzerine basılması
gibi durumlarda kullanılabilen bir servistir.
Pisano Link Kısaltma Servisi Nasıl Kullanılır?
Pisano’nun sağlamış olduğu link kısaltma servisi, HTTP API dışında bir arayüz vermemektedir. Dolayısıyla web tarayıcısı vs. gibi araçlarla kullanılamaz.
İstek
Link kısaltma servisini çağırmak için, https://psn.vc/shorten adresine, aşağıdaki parametre ve başlıkları içeren bir POST isteği gönderilmelidir.
URL Parametreleri İle Beraber Özel Değerler Gönderme
Pisano platformunda oluşturulan geri bildirim linklerine, aşağıdaki formatı takip ederek, müşterinin geri bildirimde verdiği cevaplara ek olarak, istenilen özel değerleri ekleyebilirsiniz.
Özel Değerleri Şifrelemek
Pisano, URL içerisine parametre olarak eklenmiş özel değerlerin, kötü niyetli müşteriler tarafından değiştirilerek, yanıltıcı geri bildirimlerde bulunmaları engellemek için, bu değerlerin base64 ile şifrelenmesini istemektedir. Aşağıdaki adımları izleyerek, bu değerlerin nasıl şifreleneceğini öğrenebilirsiniz.
1. Akış İçerisinde Özel Değerlere Karşılık Gelen Soru Anahtarlarının Eklenmesi
URL parametreleri ile özel değerler gönderilmeden önce, kanalınıza atanmış akıştaki soruların anahtarlarını belirlemeniz gereklidir. Bu anahtarlar, sizin göndereceğiniz özel değerlerin, akış içerisindeki hangi soruya cevap olarak karşılık geleceğini belirler.
2. responses URL Parametresinin Oluşturulması
İlk adımda anlatılan soru anahtarları belirlendikten sonra, bu sorulara karşılık gelen özel değerlerin gönderilmesi işlemine başlayabilirsiniz. responses ismindeki URL parametresi, JSON formatında bir obje array’inin string’e dönüştürülerek base64 ile encode edilmiş halidir.
Array içerisindeki her obje aşağıdaki formata sahiptir.
Göndermek istediğiniz her özel değer için, bu özel değer objelerini bir array’e eklemelisiniz. Bütün objeleri ekledikten sonra, elde ettiğiniz array’i string’e çevirip, sonucundaki string’i base64 ile encode ederek responses URL parametresini elde edebilirsiniz. Sonrasında ise geri bildirim linkinin sonuna bu parametreyi ekleyebilirsiniz. Örnek olarak verilen demo linki, bu işlem sonrasında aşağıdaki gibi görünecektir.
https://demo-web.pisano.co/web_feedback?node_id=d330b0c2-e0aa–44e3-a5f7– 8256fbc218ae&responses=HASHLENMIS_OZEL_DEGER
Aşağıda yukarıdaki işlemlerin, JavaScript dilinde yazılmış doğrudan örneğini bulabilirsiniz.
Yukarıdaki adımları takip ettiğinizde, elde edeceğiniz hash aşağıdaki gibidir.
Bu hash’i, geri bildirim URL’ine responses parametresi ile beraber ekleyebilirsiniz. Bu işlem sonucu linkin son hali https://demo-web.pisano.co/web_feedback?node_id=d330b0c2-e0aa–44e3-a5f7– 8256fbc218ae&responses=W3sicXVlc3Rpb24iOiJrdWxsYW5pY2lfaWQiLCJhbnN3ZXIiOiJMZW8g UGlzYW5vIn1d olacaktır.
Aşağıda bu linkten bırakılan örnek bir ekran görüntüsünü bulabilirsiniz.
Pisano Platformu Üzerinden Geri Bildirim E-Maili Göndermek
Pisano platformunu kullanarak, müşterilerinizden geri bildirim toplamak için e-mail gönderebilirsiniz.
API Üzerinden E-Mail Göndermek
Endpoint
POST /v1/email_campaigns/:campaign_id/email_sharings/
Parametreler
Başlıklar (HTTP Header)
Örnek cURL İsteği
➜ ~ curl 'https://api-stage.pisano.co/v1/email_campaigns//email_sh
arings' -H 'Authorization: Token token=""' -H 'Content-Type: applicat
ion/json' --data '{"emails":["emir.bostan@pisano.co"],custom_attributes: {}, trans
actional_data: {}}'
Başarılı Cevap
Pisano Platformu Üzerinden SMS Göndermek
Pisano, sağlamış olduğu adaptör altyapısı ile beraber, şirketlerin kullandığı SMS servislerine entegre olarak, SMS aracılığıyla müşteri geri bildirimi toplayabilir.
API Üzerinden SMS Göndermek
Endpoint
POST /v1/sms_campaigns/:campaign_id/sms_sharings/
Parametreler
Başlıklar (HTTP Header)
Örnek cURL İsteği
curl 'https://api-stage.pisano.co/v1/sms_campaigns//sms_sharings' -
H 'Authorization: Token token=""' -H 'Content-Type: application/json'
--data '{"phone_numbers":["+905340109413"]}'
Başarılı Cevap