Anketlerin E-Posta Entegrasyonu ile Gönderilmesi

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.

epostakanal

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!