Yeni Geri Bildirim Oluşturma

Yeni bir geri bildirim oluşturur.

POST /external/v1/feedbacks

Kimlik Doğrulama

Kimlik Doğrulama Yöntemi Token token=<TOKEN>

İstek

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>`
`Content-Type`	Evet	İstek içeriğinin türünü belirtir. application/json olmalıdır.	`application/json`

İstek Gövdesi

{
  "node_id": "<node_id>",
  "flow_id": "<flow_id>",
  "language_id": "<language_id>",
  "created_at": <unix_timestamp>,
  "customer": {
    "name": "<customer_name>",
    "phone_number": "<phone_number>",
    "email": "<email>",
    "external_id": "<external_id>"
  },
  "responses": [
    {
      "question_key": "<question_key>",
      "body": "<response_body>"
    },
    {
      "question_key": "<question_key>",
      "option_key": "<option_key>"
    }
  ]
}

İstek Gövdesi Alanları

Alan	Tip	Zorunlu	Açıklama
`node_id`	string	Evet	Birim ID'si.
`flow_id`	string	Evet	Flow ID'si.
`language_id`	string	Hayır	Dil ID'si.
`created_at`	integer (int64)	Hayır	Unix zaman damgası.
`customer`	object	Hayır	Müşteri bilgileri.
`customer.name`	string		Müşterinin adı.
`customer.phone_number`	string		Müşterinin telefon numarası.
`customer.email`	string		Müşterinin e-posta adresi.
`customer.external_id`	string		Müşterinin harici tanımlayıcısı.
`responses`	array	Evet	Geri bildirim kapsamında gönderilen yanıtlar.
`responses[].question_key`	string		Soru anahtarı.
`responses[].body`	string	Evet*	TextResponse için zorunludur.
`responses[].option_key`	string	Evet*	OptionResponse için zorunludur.

Zorunluluk Açıklaması

Evet* = body ve option_key alanlarının aynı yanıt öğesinde birlikte gönderilmesi gerekmez. TextResponse için body alanı, OptionResponse için ise option_key alanı zorunludur.

İstek Örneği

JSON İstek Örneği

{
  "node_id": "<node_id>",
  "flow_id": "<flow_id>",
  "language_id": "<language_id>",
  "created_at": <unix_timestamp>,
  "customer": {
    "name": "<customer_name>",
    "phone_number": "<phone_number>",
    "email": "<email>",
    "external_id": "<external_id>"
  },
  "responses": [
    {
      "question_key": "<question_key>",
      "body": "<response_body>"
    },
    {
      "question_key": "<question_key>",
      "option_key": "<option_key>"
    }
  ]
}

Yanıtlar

201 Geri Bildirim Oluşturuldu

Yanıt Alanları

Alan	Tip	Zorunlu	Açıklama
`id`	string		Oluşturulan geri bildirimin benzersiz tanımlayıcısı.

Yanıt Örneği

JSON Yanıt Örneği

{
  "id": "<feedback_id>"
}

400 hata yanıtı

Hata Kodu: 13028
Hata Mesajı: Geçersiz parametreler

401 Hata: Yetkisiz Erişim

Hata Kodu: 13001
Hata Mesajı: Hatalı kimlik doğrulama anahtarı

{"error_message":"Wrong authentication token","data":"Wrong authentication token","code":13001,"errors":null}

404 hata yanıtı

Hata Kodu: 13002
Hata Mesajı: İstenen kaynak bulunamadı!

{"error_message":"Requested resource not found!","data":"Requested resource not found!","code":13002,"errors":{"question_id":null}}

Pisano Harici API - Geri Bildirim - Geri Bildirim Oluştur