Pisano Harici API - Geri Bildirim - Geri Bildirim Getir
Geri Bildirim Getirme
Belirtilen ID'ye sahip geri bildirimi getirir.
GET
/external/v1/feedbacks/{id}
Kimlik Doğrulama
Yetkilendirme
Token token=<TOKEN>
İstek
Yol Parametreleri
| Parametre | Tip | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|
id |
string | Evet | Geri bildirim ID'si. | id |
Header Bilgileri
| Header | Zorunlu | Açıklama | Örnek |
|---|---|---|---|
Accept |
Hayır | Beklenen yanıtın medya türünü belirtir. | application/json |
Authorization |
Evet | İsteğin kimlik doğrulamasını sağlamak için kullanılan Pisano API anahtarı. | Token token=<TOKEN> |
Yanıtlar
200
Geri Bildirim Detayları
Yanıt Alanları
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
id |
string | Geri bildirimin benzersiz tanımlayıcısı. | |
status |
string | Geri bildirimin mevcut durumu. | |
created_at |
string | Geri bildirimin oluşturulma tarihi ve saati. | |
updated_at |
string | Geri bildirimin son güncellenme tarihi ve saati. | |
title |
string | Geri bildirimin başlığı. | |
average_positivity |
number / nullable | Mevcut olduğunda geri bildirimin ortalama pozitiflik değeri. | |
responses |
array | Geri bildirim kapsamında gönderilen yanıtlar. | |
responses[].question |
object | Yanıtla ilişkili soru. | |
responses[].question.id |
string | Sorunun benzersiz tanımlayıcısı. | |
responses[].question.body |
object | Yerelleştirilmiş soru metni. | |
responses[].question.body.<language_code> |
string | Belirtilen dildeki soru metni. | |
responses[].question.style |
string | Soru tipi/stili. | |
responses[].question.key |
string / nullable | Soru anahtarı. Null olabilir. | |
responses[].question.category_id |
|||
responses[].question.masked |
boolean | Sorunun maskelenip maskelenmediğini belirtir. | |
responses[].question.node_id |
|||
responses[].question.required |
boolean | Sorunun zorunlu olup olmadığını belirtir. | |
responses[].question.weight |
number / nullable | Geçerli olduğunda sorunun ağırlık değeri. | |
responses[].response |
string | Gönderilen yanıt değeri. | |
responses[].positivity |
number / nullable | Mevcut olduğunda yanıtın pozitiflik değeri. | |
responses[].created_at |
string | Yanıtın oluşturulma tarihi ve saati. | |
responses[].custom_score |
|||
responses[].feedback_id |
string | İlişkili geri bildirimin tanımlayıcısı. | |
responses[].id |
string | Yanıtın benzersiz tanımlayıcısı. | |
responses[].order |
number | Yanıtın sıralama değeri. | |
responses[].power_score |
|||
responses[].ranking |
|||
responses[].score |
number / nullable | Geçerli olduğunda yanıtın puanı. | |
responses[].submitted_at |
string | Yanıtın gönderilme tarihi ve saati. | |
responses[].updated_at |
string | Yanıtın son güncellenme tarihi ve saati. | |
node |
object | Geri bildirimle ilişkili birim. | |
node.id |
string | Birimin benzersiz tanımlayıcısı. | |
node.type |
string | Birim tipi. | |
node.name |
string | Birim adı. | |
node.code |
string | Birim kodu. | |
node.timezone |
string | Birim için yapılandırılmış saat dilimi. | |
node.external_id |
|||
node.flow_id |
string | İlişkili akışın tanımlayıcısı. | |
node.parent_id |
string | Üst birimin tanımlayıcısı. | |
tags |
array | Geri bildirimle ilişkili etiketler. | |
flow |
object | Geri bildirimle ilişkili akış. | |
flow.id |
string | Akışın benzersiz tanımlayıcısı. | |
flow.name |
string | Akışın adı. | |
flow.created_at |
string | Akışın oluşturulma tarihi ve saati. | |
flow.deleted_at |
|||
flow.node_id |
string / nullable | Mevcut olduğunda akışla ilişkili birimin tanımlayıcısı. | |
flow.parent_flow_id |
|||
flow.question_category_parent_id |
|||
flow.status |
string | Akışın mevcut durumu. | |
flow.updated_at |
string | Akışın son güncellenme tarihi ve saati. | |
customer |
object | Geri bildirimle ilişkili müşteri. | |
customer.id |
string | Müşterinin benzersiz tanımlayıcısı. | |
customer.email |
|||
customer.phone_number |
string / nullable | Mevcut olduğunda müşterinin telefon numarası. | |
customer.name |
string / nullable | Mevcut olduğunda müşterinin adı. | |
customer.gender |
|||
customer.birth_year |
|||
customer.external_id |
string / nullable | Mevcut olduğunda müşterinin harici tanımlayıcısı. | |
customer.unsubscribed |
boolean | Müşterinin abonelikten çıkıp çıkmadığını belirtir. | |
customer.custom_attrs |
object / nullable | Mevcut olduğunda müşteriye ait özel nitelikler. | |
customer.call_permission |
boolean | Arama izninin bulunup bulunmadığını belirtir. | |
customer.created_at |
string | Müşterinin oluşturulma tarihi ve saati. | |
customer.deleted_at |
|||
customer.node_id |
string | Müşteriyle ilişkili birimin tanımlayıcısı. | |
customer.status |
string | Müşterinin durumu. | |
customer.updated_at |
string | Müşterinin son güncellenme tarihi ve saati. | |
customer.language |
string | Müşterinin dili. | |
assignee |
|||
archiving_user_id |
|||
creator_id |
string | Geri bildirimi oluşturan kullanıcının tanımlayıcısı. | |
flow_id |
string | İlişkili akışın tanımlayıcısı. | |
is_negative |
boolean | Geri bildirimin olumsuz olup olmadığını belirtir. | |
is_spam |
boolean | Geri bildirimin spam olarak işaretlenip işaretlenmediğini belirtir. | |
language_id |
string | Geri bildirimin dil tanımlayıcısı. | |
node_id |
string | İlişkili birimin tanımlayıcısı. | |
origin_url |
string | Geri bildirimin geldiği URL. | |
positivity |
number / nullable | Mevcut olduğunda geri bildirimin pozitiflik değeri. | |
power_score |
|||
priority |
|||
content_categories |
array | Geri bildirimle ilişkili içerik kategorileri. | |
sentiment_score |
|||
time_spent_in_seconds |
number | Geri bildirimin tamamlanması için harcanan süre (saniye). | |
user_agent |
string | İstemcinin User Agent bilgisi. | |
deleted_at |
Yanıt Örneği
JSON
Yanıt Örneği
{
"id": "<feedback_id>",
"status": "open",
"created_at": "<created_at>",
"updated_at": "<updated_at>",
"title": "<feedback_title>",
"average_positivity": 100,
"responses": [
{
"question": {
"id": "<question_id>",
"body": {
"TR": "<question_text>"
},
"style": "score",
"key": "<question_key>",
"masked": false,
"required": false,
"weight": 1.0
},
"response": "10",
"score": 100.0,
"feedback_id": "<feedback_id>",
"id": "<response_id>"
}
],
"node": {
"id": "<node_id>",
"type": "Web",
"name": "<node_name>"
},
"flow": {
"id": "<flow_id>",
"name": "<flow_name>",
"status": "active"
},
"customer": {
"id": "<customer_id>",
"language": "TR"
},
"flow_id": "<flow_id>",
"node_id": "<node_id>",
"is_negative": false,
"is_spam": false,
"origin_url": "<origin_url>",
"positivity": 100.0,
"content_categories": [],
"time_spent_in_seconds": 9,
"user_agent": "<user_agent>"
}
401
Hata: Yetkisiz Erişim
Hata: Yetkisiz Erişim
- Hata Kodu
13001- Hata Mesajı
- Wrong authentication token
{"error_message":"Wrong authentication token","data":"Wrong authentication token","code":13001,"errors":null}
404
Geri bildirim bulunamadı
Geri bildirim bulunamadı
- Hata Kodu
0- Hata Mesajı
- string
{"error_message":"string","data":"string","code":0,"errors":{}}