- Pisano'da Admin olarak oturum açtıktan sonra Ayarlar > Uber Admin > Hesap sayfasına gidiniz.
Bulut ortamdaki müşterilerin bu değeri Pisano destek ekibinden talep etmesi gerekmektedir.
Hesap sayfasında geri bildirimlerin alınacağı hesabı arayın ve tıklayın.
- İstenilen hesap seçildiğinde, URL'den alfanumerik hesap kimliğini alın. (Bu bilgi müşterilerimize Pisano tarafından sağlanacaktır. Uber Admin yetkisi sadece Pisano üzerinde bulunmaktadır.)
- API çağrıları yapılmadan Pisano üzerinden Authorization Token alınıp, API çağrılarında authorization olarak Bearer token olacak şekilde tanımlanmalıdır (Önceki Pisano entegrasyonlarınızda kullandığınız token varsa aynı tokenla ilerleyebilirsiniz):
Authorization Token Alımı - Kopyalanan (sağlanan) kimlik, node_id olarak da bilinen hesap kimliğiniz olarak hizmet verecek ve başlangıçta tüm akışlar burada listelenecektir. (https://pisano_domain/external/v1/flows/?node_id=xxxx): (.com.tr için api.pisano.com.tr)
API'ye GET istekleri gönderebilmek için, şifresi hiçbir zaman güncellemeyen bir kullanıcıdan token alınmalıdır. Bu nedenle Pisano'da sadece entegrasyonda kullanılacak bir "entegrasyon" kullanıcısı oluşturulması önerilir.
İstenirse GET isteği çağrıldığında flow_id dışında aşağıdaki parametreler de uygulanabilir:
Query Parametreleri
| Anahtar | Tanım |
| from | Unix Timestamp formatında geri bildirin oluşturulma başlangıç tarihi |
| to | Unix Timestamp formatında geri bildirin oluşturulma bitiş tarihi |
| time_from | i.e. 1000 (for 10:00 am) |
| time_to | i.e. 1330 (for 1:30 pm) |
| range | scope feedbacks within this range. String. One of ['today', 'yesterday', 'this_week', 'last_week', 'this_month', 'last_month', 'last_7_days', 'previous_7_days', 'last_30_days', 'previous_30_days', 'older_than_30_days'] |
| page | Servis, her yanıt için maksimum 20 geri bildirim bilgisi döndürmektedir. 20'den fazla geri bildirim varsa, page parametresi ile tekrar istek gönderilebilir. |
Yukarıdaki API call un response undan edinilen flow_id bilgisi ile istenilen anket için gelen feedbackler aşağıdaki API, GET metodu çağrılarak response undan cevaplar listelenebilir:
Yanıtların altında soru (question.body) ve responses nesneleri bulunur. Akış tasarımınıza göre müşterilerinizden gelen tüm geri bildirimler ve akış soruları responses nesnesi altında listelenir. Aşağıda bir yanıt örneğini bulabilirsiniz:
"data": [
{
"id": "e14b9be8-596b-43e9-9c21-bab5add97fcd",
"status": "open",
"created_at": "2023-04-04T15:46:55.241+03:00",
"updated_at": "2023-04-04T15:46:55.241+03:00",
"title": null,
"average_positivity": null,
"responses": [
{
"question": {
"id": "cbfdd7e9-7c8f-4e59-ae63-1179cf50179c",
"body": {
"TR": "Tek Seçim"
},
"style": "radio",
"key": "q1",
"category_id": null,
"masked": false,
"node_id": "fa5fa92f-b308-4b0f-b662-76fe22683759",
"required": false,
"weight": null
},
"response": "o2",
"positivity": null,
"created_at": "2023-04-04T15:46:55.448+03:00",
"custom_score": null,
"feedback_id": "e14b9be8-596b-43e9-9c21-bab5add97fcd",
"id": "5d3c98a9-488e-4a83-b9d3-822f6ac1d0c8",
"order": 1.01,
"power_score": null,
"ranking": null,
"score": null,
"submitted_at": "2023-04-04T15:46:55.241+03:00",
"updated_at": "2023-04-04T15:46:55.448+03:00"
}
]
- Kısıt: 5 saniye içinde en fazla 10 istek işlenebilir.