API

მიიღეთ უკუკავშირის ანალიტიკა

GET/api/crm/v2/feedback_analyticsv2
operationId: feedbackAnalytics.default

აბრუნებს შეჯამებულ ფილებს და უკუკავშირის გრაფიკს არჩეული პერიოდისთვის. თითოეული წერტილი წარმოადგენს ერთ საათს UTC-ში; ბრუნდება მხოლოდ არაცარიელი წერტილები. ინტერფეისი ავტომატურად გარდაქმნის დროს მომხმარებლის დროის სარტყელში და აერთიანებს საათებს დღეებად. ნაგულისხმევი პერიოდი — დღეს. პერიოდი შეზღუდულია ერთ წლამდე; უფრო გრძელი პერიოდი იჭრება ბოლო თარიღებიდან. წილის ფილა შეიცავს dynamics — ცვლილება date_comparison_*-თან შედარებით. თუ ეს პერიოდი არ არის მითითებული, ნაგულისხმევად გამოიყენება იმავე სიგრძის პერიოდი უშუალოდ არჩეული პერიოდის წინ. ეს ნაგულისხმევი მნიშვნელობა გამოიყენება მხოლოდ შედარებისთვის და არ ბრუნდება ფილტრებში.

ავტორიზაცია

api-token + language + role

მოთხოვნის პარამეტრები

date_fromstring

მაგალითი: 25/04/2024

date_tostring

მაგალითი: 26/04/2024

date_comparison_fromstring

მაგალითი: 25/03/2024

date_comparison_tostring

მაგალითი: 26/03/2024

chain_idinteger

მაგალითი: 1

branch_idinteger

მაგალითი: 1

პასუხები

OK

object
statusstringსავალდებულო

მნიშვნელობები:successerror

მაგალითი: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringშეიძლება იყოს null

მაგალითი: 2026-08-01 00:00:00

typestringსავალდებულო

მაგალითი: date

modestring (FilterMode)

როგორ ამუშავებს ინტერფეისი ფილტრს; ჩვეულებრივ ფილტრს mode არ აქვს. force_shown — ყოველთვის ნაჩვენებია, დამალვა შეუძლებელია. value_required — განყოფილების შესვლის წერტილი: ყოველთვის ნაჩვენებია, ცარიელი მნიშვნელობა არ აქვს (სანამ მნიშვნელობა არ არის არჩეული, სია ცარიელია; ვარიანტი „ყველა“ არ არსებობს), საერთო გასუფთავება მას არ აშორებს.

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

date_toobject (FilterDateTo)
valuestringშეიძლება იყოს null

მაგალითი: 2026-08-31 23:59:59

typestringსავალდებულო

მაგალითი: date

modestring (FilterMode)

როგორ ამუშავებს ინტერფეისი ფილტრს; ჩვეულებრივ ფილტრს mode არ აქვს. force_shown — ყოველთვის ნაჩვენებია, დამალვა შეუძლებელია. value_required — განყოფილების შესვლის წერტილი: ყოველთვის ნაჩვენებია, ცარიელი მნიშვნელობა არ აქვს (სანამ მნიშვნელობა არ არის არჩეული, სია ცარიელია; ვარიანტი „ყველა“ არ არსებობს), საერთო გასუფთავება მას არ აშორებს.

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

date_rangeobject (FilterDateRange)

მზადყოფილი თარიღის ფილტრის პერიოდები; ქვედა ზღვარი გამოითვლება მომხმარებლის დროის სარტყელში. value — პერიოდი, რომელსაც შეესაბამება მიმდინარე *_from და *_to; null — თვითნებური პერიოდი. default — პერიოდი, რომელსაც სერვერი იყენებს თარიღების გარეშე მოთხოვნაში: ასევე გამოიყენება განყოფილების პირველ ჩატვირთვაზე და მას უბრუნდება სეტინგების განულებისას. პერიოდის ზედა ზღვარი ყოველთვის უდრის მომხმარებლის მიმდინარე დღეს, ამიტომ option მას არ შეიცავს: მზადყოფილი პერიოდისთვის *_to გადაცემა საჭირო არ არის, სერვერი თავად ადგენს მას. ერთი წელზე გრძელი პერიოდი იჭრება ახალი ზღვრის მხრიდან.

valuestring (DateRange) შეიძლება იყოს null

მზადყოფილი თარიღის ფილტრის პერიოდი. მას არ აქვს საკუთარი მოთხოვნის პარამეტრი: ქვედა ზღვარი უკვე გამოთვლილია option-ში და გამოიყენება როგორც *_from. ზედა ზღვარი არ გადმოიცემა არც პასუხში, არც მოთხოვნაში — ის ყოველთვის უდრის მომხმარებლის მიმდინარე დღეს და განისაზღვრება სერვერის მიერ.

მნიშვნელობები:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

მაგალითი: today

defaultstring (DateRange) სავალდებულო

მზადყოფილი თარიღის ფილტრის პერიოდი. მას არ აქვს საკუთარი მოთხოვნის პარამეტრი: ქვედა ზღვარი უკვე გამოთვლილია option-ში და გამოიყენება როგორც *_from. ზედა ზღვარი არ გადმოიცემა არც პასუხში, არც მოთხოვნაში — ის ყოველთვის უდრის მომხმარებლის მიმდინარე დღეს და განისაზღვრება სერვერის მიერ.

მნიშვნელობები:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

მაგალითი: today

typestringსავალდებულო

მაგალითი: select

modestring (FilterMode)

როგორ ამუშავებს ინტერფეისი ფილტრს; ჩვეულებრივ ფილტრს mode არ აქვს. force_shown — ყოველთვის ნაჩვენებია, დამალვა შეუძლებელია. value_required — განყოფილების შესვლის წერტილი: ყოველთვის ნაჩვენებია, ცარიელი მნიშვნელობა არ აქვს (სანამ მნიშვნელობა არ არის არჩეული, სია ცარიელია; ვარიანტი „ყველა“ არ არსებობს), საერთო გასუფთავება მას არ აშორებს.

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

optionarray of objectსავალდებულო
valuestring (DateRange) სავალდებულო

მზადყოფილი თარიღის ფილტრის პერიოდი. მას არ აქვს საკუთარი მოთხოვნის პარამეტრი: ქვედა ზღვარი უკვე გამოთვლილია option-ში და გამოიყენება როგორც *_from. ზედა ზღვარი არ გადმოიცემა არც პასუხში, არც მოთხოვნაში — ის ყოველთვის უდრის მომხმარებლის მიმდინარე დღეს და განისაზღვრება სერვერის მიერ.

მნიშვნელობები:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

მაგალითი: today

date_fromstringსავალდებულო

მაგალითი: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringშეიძლება იყოს null

მაგალითი: 2026-08-01 00:00:00

typestringსავალდებულო

მაგალითი: date

modestring (FilterMode)

როგორ ამუშავებს ინტერფეისი ფილტრს; ჩვეულებრივ ფილტრს mode არ აქვს. force_shown — ყოველთვის ნაჩვენებია, დამალვა შეუძლებელია. value_required — განყოფილების შესვლის წერტილი: ყოველთვის ნაჩვენებია, ცარიელი მნიშვნელობა არ აქვს (სანამ მნიშვნელობა არ არის არჩეული, სია ცარიელია; ვარიანტი „ყველა“ არ არსებობს), საერთო გასუფთავება მას არ აშორებს.

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

date_comparison_toobject (FilterDateTo)
valuestringშეიძლება იყოს null

მაგალითი: 2026-08-31 23:59:59

typestringსავალდებულო

მაგალითი: date

modestring (FilterMode)

როგორ ამუშავებს ინტერფეისი ფილტრს; ჩვეულებრივ ფილტრს mode არ აქვს. force_shown — ყოველთვის ნაჩვენებია, დამალვა შეუძლებელია. value_required — განყოფილების შესვლის წერტილი: ყოველთვის ნაჩვენებია, ცარიელი მნიშვნელობა არ აქვს (სანამ მნიშვნელობა არ არის არჩეული, სია ცარიელია; ვარიანტი „ყველა“ არ არსებობს), საერთო გასუფთავება მას არ აშორებს.

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

მზადყოფილი თარიღის ფილტრის პერიოდები ნაგულისხმევი მნიშვნელობის გარეშე: default ყოველთვის უდრის null.

valuestring (DateRange) შეიძლება იყოს null

მზადყოფილი თარიღის ფილტრის პერიოდი. მას არ აქვს საკუთარი მოთხოვნის პარამეტრი: ქვედა ზღვარი უკვე გამოთვლილია option-ში და გამოიყენება როგორც *_from. ზედა ზღვარი არ გადმოიცემა არც პასუხში, არც მოთხოვნაში — ის ყოველთვის უდრის მომხმარებლის მიმდინარე დღეს და განისაზღვრება სერვერის მიერ.

მნიშვნელობები:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

მაგალითი: today

defaultstring (DateRange) შეიძლება იყოს null

მზადყოფილი თარიღის ფილტრის პერიოდი. მას არ აქვს საკუთარი მოთხოვნის პარამეტრი: ქვედა ზღვარი უკვე გამოთვლილია option-ში და გამოიყენება როგორც *_from. ზედა ზღვარი არ გადმოიცემა არც პასუხში, არც მოთხოვნაში — ის ყოველთვის უდრის მომხმარებლის მიმდინარე დღეს და განისაზღვრება სერვერის მიერ.

მნიშვნელობები:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

მაგალითი: today

typestringსავალდებულო

მაგალითი: select

optionarray of objectსავალდებულო
valuestring (DateRange) სავალდებულო

მზადყოფილი თარიღის ფილტრის პერიოდი. მას არ აქვს საკუთარი მოთხოვნის პარამეტრი: ქვედა ზღვარი უკვე გამოთვლილია option-ში და გამოიყენება როგორც *_from. ზედა ზღვარი არ გადმოიცემა არც პასუხში, არც მოთხოვნაში — ის ყოველთვის უდრის მომხმარებლის მიმდინარე დღეს და განისაზღვრება სერვერის მიერ.

მნიშვნელობები:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

მაგალითი: today

date_fromstringსავალდებულო

მაგალითი: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

მაგალითი: 8920

typestringსავალდებულო

მაგალითი: select

optionarray of object
valueintegerსავალდებულო

მაგალითი: 8920

namestringსავალდებულო

მაგალითი: Green Basket | Kaliningrad

modestring (FilterMode)

როგორ ამუშავებს ინტერფეისი ფილტრს; ჩვეულებრივ ფილტრს mode არ აქვს. force_shown — ყოველთვის ნაჩვენებია, დამალვა შეუძლებელია. value_required — განყოფილების შესვლის წერტილი: ყოველთვის ნაჩვენებია, ცარიელი მნიშვნელობა არ აქვს (სანამ მნიშვნელობა არ არის არჩეული, სია ცარიელია; ვარიანტი „ყველა“ არ არსებობს), საერთო გასუფთავება მას არ აშორებს.

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

branch_idobject (FilterSelectInteger)
valueinteger

მაგალითი: 8920

typestringსავალდებულო

მაგალითი: select

optionarray of object
valueintegerსავალდებულო

მაგალითი: 8920

namestringსავალდებულო

მაგალითი: Green Basket | Kaliningrad

modestring (FilterMode)

როგორ ამუშავებს ინტერფეისი ფილტრს; ჩვეულებრივ ფილტრს mode არ აქვს. force_shown — ყოველთვის ნაჩვენებია, დამალვა შეუძლებელია. value_required — განყოფილების შესვლის წერტილი: ყოველთვის ნაჩვენებია, ცარიელი მნიშვნელობა არ აქვს (სანამ მნიშვნელობა არ არის არჩეული, სია ცარიელია; ვარიანტი „ყველა“ არ არსებობს), საერთო გასუფთავება მას არ აშორებს.

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) სავალდებულო

მთვლელი ფილა შეჯამების ხაზში: მიმოხილვების რაოდენობა და მათი წილი პერიოდზე. თუ პერიოდში არცერთი მიმოხილვა არ არის, percent მნიშვნელობა იქნება null. შედარების პერიოდთან ცვლილება განზრახ არ გადმოიცემა: მიმოხილვების რაოდენობა დამოკიდებულია ტრაფიკზე, ამიტომ მისი ზრდა არაფერს ამბობს ხარისხზე.

valueintegerსავალდებულო

მაგალითი: 96

percentnumber · float

მაგალითი: 75

positiveobject (FeedbackAnalyticsCountTile) სავალდებულო

მთვლელი ფილა შეჯამების ხაზში: მიმოხილვების რაოდენობა და მათი წილი პერიოდზე. თუ პერიოდში არცერთი მიმოხილვა არ არის, percent მნიშვნელობა იქნება null. შედარების პერიოდთან ცვლილება განზრახ არ გადმოიცემა: მიმოხილვების რაოდენობა დამოკიდებულია ტრაფიკზე, ამიტომ მისი ზრდა არაფერს ამბობს ხარისხზე.

valueintegerსავალდებულო

მაგალითი: 96

percentnumber · float

მაგალითი: 75

negativeobject (FeedbackAnalyticsCountTile) სავალდებულო

მთვლელი ფილა შეჯამების ხაზში: მიმოხილვების რაოდენობა და მათი წილი პერიოდზე. თუ პერიოდში არცერთი მიმოხილვა არ არის, percent მნიშვნელობა იქნება null. შედარების პერიოდთან ცვლილება განზრახ არ გადმოიცემა: მიმოხილვების რაოდენობა დამოკიდებულია ტრაფიკზე, ამიტომ მისი ზრდა არაფერს ამბობს ხარისხზე.

valueintegerსავალდებულო

მაგალითი: 96

percentnumber · float

მაგალითი: 75

positive_shareobject (FeedbackAnalyticsShareTile) სავალდებულო

საზოგადოების წილის ფილა შეჯამების ხაზში. განსხვავებით მრიცხველებისგან, შეიცავს dynamics — წილის ცვლილება შედარების პერიოდთან მიმართებაში პროცენტული პუნქტებით; ეს არ არის დამოკიდებული ტრაფიკზე. percent და dynamics არის null, თუ გასაყოფი არ არსებობს: არ არის მიმოხილვები პერიოდში ან შედარების პერიოდში.

valueintegerსავალდებულო

მაგალითი: 96

percentnumber · float

მაგალითი: 75

dynamicsnumber · float

მაგალითი: -0.2

pointsarray of object
datetimestringსავალდებულო

საათობრივი წერტილის დასაწყისი UTC-ში

მაგალითი: 2026-09-08 10:00:00

positiveintegerსავალდებულო

მაგალითი: 3

negativeintegerსავალდებულო

მაგალითი: 1