Pisano, sağlamış olduğu adaptör altyapısı ile beraber, şirketlerin kullandığı e-posta servislerine entegre olarak geri bildirim toplayabilir.
E-posta ile anket gönderimi için aşağıdaki adımlar takip edilmelidir:
- E-Posta servis sağlayıcısının tanımlanması: etkileşimli videodan yararlanarak tanımlamaları yapabilirsiniz.
- E-posta anketinin tetiklenmesi
-
.csv dosyası yükleyerek elle tetikleme: toplu anket gönderimi için tercih edilebilir. Anketin gönderimi her gün sıklıkla yapılmayacaksa kullanılır. Anketler elle tetikleneceği için iş birimi tarafından ön hazırlık yapılması gerekir.
-
Workflow ile eposta anketi tetiklemesi: planlanmış zamanlarda toplu anket gönderiminin otomatik olarak yapılması isteniyorsa tercih edilir.
-
API kullanarak (Email Sharing) anketin tetiklenmesi (bu sayfada): işlem bazlı anketlerin otomatik olarak tetiklenmesi için tercih edilir. Müşteri işlemi gerçekleştirdikten hemen sonra anket gönderimi yapılabilir. API'nin ne zaman tetikleneceğine isteği gönderen sistem karar verir. API tetiklendiği anda e-posta gönderimi sağlanır.
-
API Kullanarak (Email Sharing) Anketin Tetiklenmesi
Endpoint Bilgileri
POST https://<pisanoURL>/v1/email_campaigns/campaign_id/email_sharings/
pisanoURL bilgisi Pisano tarafından sizinle paylaşılacaktır.
Parametreler
| Parametre | Değer |
| campaign_id |
E-posta ile gönderilecek kampanya ID |
| emails |
E-posta adres array’i |
| custom_attributes | Müşteri özel bilgi alanları ve değerleri. JSON Object |
| transactional_data |
Linke gömülecek geri bildirim bazlı bilgiler. JSON Object |
Başlıklar (HTTP Header)
| Başlık | Değer |
| Content-Type | application/json |
|
Authorization |
Token token= <API TOKEN> |
Örnek cURL İsteği
curl --location 'https://<pisanoEnvironment>/v1/email_campaigns/<campaignID>/email_sharings' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data '{
"emails": [
"<email1>",
"<email2>"
],
"custom_attributes": {
"<email1>": {
"name": "<name1>",
"external_id": "<external_id1>",
"phone_number": "<phone_number1>"
},
"<email2>": {
"name": "<name2>",
"external_id": "<external_id2>",
"phone_number": "<phone_number2>"
}
},
"transactional_data": {
"<email1>": {
"Segment": "<Segment1>",
"Location": "<Location1>",
"TransactionDate": "<TransactionDate1>"
},
"<email2>": {
"Segment": "<Segment2>",
"Location": "<Location2>",
"TransactionDate": "<TransactionDate2>"
}
}
}'
# - 20 requests in 5 seconds
# - 40 requests in 25 seconds
# - 80 requests in 125 seconds (~2 min)
# - 160 requests in 625 seconds (~10 min)
Tek bir istekte ideal olarak en fazla 5000 kişi icin tetikleme gerçekleştirilmesi önerilir.
On-premises kurulumlarda Email & SMS & Link throttle limitleri artırılabilir veya tamamen kaldırılabilir. On-premises kurulumlarda Throttle kuralları IP bazlı konfigüre edilebilir.
API ID Almak (campaign_id)
- Kanallar > E-Posta Kanallarına gidip "Kampanya Düzenle" butonuna tıklayınız.
- API kullanımında hangi kampanya için gönderim yapılmasını belirleyen API ID bu ekran üzerinden alınmaktadır. Örnek API ID: fdd4e8b7-dd9c-4976-82f6-324e7031138c
- Açılan ekranda, servis sağlayıcısı seçilmelidir. Epostanın konusu Eposta servis sağlayıcısı tarafından yönetilmeyecekse "Konu" başlığı altına girilmelidir.

Token Almak
Pisano'da tüm API kullanımları için TOKEN almalısınız.
API Yanıt Kodları
|
Response Status Code
|
Status
|
Status Code
|
Message
|
|
200 |
OK (Successful) |
|
|
|
400 |
bad_request |
13000 |
An error occured |
|
401 |
unauthorized |
13001 |
Wrong authentication token |
|
404 |
NOT_FOUND |
13002 |
Requested resource not found! |
|
404 |
not_found |
13003 |
Reset Token not found |
|
404 |
not_found |
13005 |
This node, nor any of their parent has any flow |
|
403 |
forbidden |
13007 |
It's not allowed to update Pisano node |
|
400 |
bad_request |
13008 |
Record could not be deleted |
|
400 |
bad_request |
13009 |
Updated question already has responses |
|
404 |
not_found |
13010 |
User not found |
|
401 |
unauthorized |
13011 |
User is inactive |
|
409 |
conflict |
13012 |
Password does not match the old password |
|
403 |
forbidden |
13013 |
Permission denied |
|
400 |
bad_request |
13014 |
Wrong activation code |
|
400 |
bad_request |
13015 |
Required field not present in params! |
|
404 |
not_found |
13016 |
Token not found |
|
400 |
bad_request |
13017 |
Duplicate value |
|
404 |
not_found |
13018 |
Response not found |
|
404 |
not_found |
13019 |
Activation token not found |
|
400 |
bad_request |
13020 |
You selected a reserved node type. Please choose another one. |
|
400 |
bad_request |
13024 |
Multiple responses given for a non-multiple choice question |
|
400 |
bad_request |
13026 |
Captcha is invalid |
|
400 |
bad_request |
13028 |
Invalid parameters |
|
400 |
bad_request |
13029 |
Invalid security hash |
|
400 |
bad_request |
13030 |
Invalid authentication token |
|
400 |
bad_request |
13031 |
Invalid proxy server parameters |
|
409 |
conflict |
13032 |
Wrong credentials |
|
400 |
bad_request |
13033 |
Invalid SDK credentials |
|
400 |
bad_request |
13034 |
Invalid Flow |
|
404 |
not_found |
13035 |
Node not found |
|
403 |
forbidden |
13036 |
Account locked |
|
400 |
bad_request |
13037 |
Malformatted CSV |
|
400 |
bad_request |
13038 |
Required customer identitiy keys not present in params! |