Тарих және қоңырау қорытындысы

Қоңыраулар тарихы

GET /calls/history/ — кілт желілерінің аяқталған қоңыраулары, жаңалары алдымен. Әрқайсысында GET /calls/<id>/ өрістері және behaviour — жазба талданғанда қысқа қорытынды (әйтпесе null).

Келесі бет — next_cursor мәні бар cursor параметрімен. Бос next_cursor — соңғы бет.

ПараметрНе табады
channel_idКілттің бір желісі
since, untilҚоңырау басталуы осы сәттен бастап және осы сәтке дейін (ISO 8601; белдеусіз — UTC)
directionin — кіріс, out — шығыс
answeredtrue — қоңырауда сөйлесті, false — жоқ (өткізіп алынған, қабылданбаған)
markerОсындай сәті бар қоңыраулар; бірнешеуі үтір арқылы — кез келгені бар (тізім төменде)
sideclient немесе ours — кімнің сәті: клиенттің немесе біздің (оператор, бағдарлама)
min_answer_wait_msКлиент кем дегенде бір рет осынша миллисекундтан кем емес жауап күтті
limitБеттегі қоңыраулар: әдепкі 50, ең көбі 100
curl "https://dialogs.tehprof.kz/api/v1/gw/calls/history/?marker=interruption&side=ours&since=2026-11-01" \
  -H "Authorization: Bearer gw_xxx"

{ "calls": [ { "id": 5288, "direction": "in", "duration_sec": 214,
    "behaviour": { "talk_ms": { "ours": 81200, "client": 96400 },
                   "interruptions": { "ours": 3, "client": 1 }, ... } } ],
  "next_cursor": "MjAyNi0xMS0x..." }

Тарихқа жасырын диалогтар және қайта бағыттау кезінде қызметкерлердің телефондарына шалулар кірмейді.

Қайталама қоңыраулар

Әр қоңырауда repeat өрісі бар — бұл клиент осы желіге бұрын қоңырау шалды ма. Тек сол клиенттің сол желіге кіріс қоңыраулары саналады.

  • count_7d — осы қоңырауға дейінгі 7 күнде клиент желіге неше рет қоңырау шалды.
  • last_at — осыған дейін соңғы рет қашан шалды; null — ешқашан.
  • last_answered — сол қоңырауда сөйлесті. false — клиент өткізіп алынған қоңыраудан кейін қайта шалып отыр: оған бірінші болып хабарласыңыз.

Қоңырау қорытындысы

GET /calls/<id>/behaviour/ — сөйлесу сандармен: кім қанша сөйледі, қаншалықты тез жауап берді, тараптар сөзді бір-біріне қалай берді. Қоңырау жазбасының дыбысы бойынша есептеледі — сөзді танусыз және ЖИ-сіз.

  • Қорытынды жазбасы бар қоңырауларда болады.
  • Қорытынды есептеліп жатқанда жауап — ready: false.
  • Дайын болғанда вебхукқа call.analysed келеді.

Тараптар: ours — оператор немесе бағдарлама, client — клиент. Жазба бір жолды болса (sides: 1), тек жалпы сөйлеу мен үнсіздік болады.

ӨрісМәні
talk_ms, overlap_ms, silence_msӘр тарап қанша сөйледі; екеуі бірге; ешкім
interruptionsТарап екіншісінің үстінен неше рет сөйлеп, бір секунд және одан ұзақ тоқтамады
answer_wait_msmedian, max — клиент біздің жауабымызды қанша күтті
turnschanges — сөз екінші тарапқа неше рет өтті, per_minute — минутына, longest_ms — әр тараптың ең ұзақ монологы
response_latency_msЕкінші тарап тоқтағаннан кейін тарап қанша уақыттан соң сөйледі: median, p90, count. Нөлден кем — соңын күтпей бастады
speech_rateТарап сөйлеп тұрғанда секундына буын саны: қоңырау бойы, бірінші және соңғы үштен бірде
backchannelsӘңгімелесушінің сөзі үстінен қысқа «иә», «ағә»: тыңдаушы тыңдап отырғанын білдіреді. Бұл сөз бөлу емес
filled_pauses0,3 с және одан ұзақ созылыңқы бір қалыпты дыбыстар: «э-э», «м-м» немесе созылған буын
pitchДауыс биіктігі: median_hz және range_st — қаншалықты өзгереді, жартылай тонмен
loudness_dbТарап сөзінің орташа қаттылығы. Желі деңгейіне байланысты: бір қоңырау ішінде салыстырыңыз
entrainmentҚоңыраудың бірінші үштен бірінен соңғысына дейін тараптардың қарқыны, қаттылығы және дауыс биіктігі қаншалықты жақындады: 1 — соңында бірдей сөйледі, 0 — өзгеріссіз, нөлден кем — алшақтады
dynamicsӘр тараптың қаттылығы, қарқыны және дауыс биіктігінің ауқымы минут сайын
markersҚоңырау лентасындағы сәттер: at_ms, kind, side, duration_ms
Сәт (`kind`)Не болды
interruptionБір секундтан ұзақ бір уақытта сөйледі
raised_voiceТарап бір секунд және одан ұзақ әдеттегісінен екі есе қатты сөйледі
silenceЕң ұзақ үзілістер; үзілістің тарапы жоқ
pause_after_oursБіздің сөзімізден кейін клиент бір секунд және одан ұзақ үндемеді
loudness_jumpКлиенттің сөзі оның соңғы сөздерінен төрт есе қуатты
longest_monologueӘр тараптың ең ұзақ монологы

version өрісі қорытындыда қандай өрістер бар екенін айтады: бұрын талданған қоңырауларда кейбірі болмауы мүмкін.

Клиент жағында не болды

Қорытынды клиент жағында не естілгенін де айтады: күту музыкасы, гудоктар, қатты байланыс, басқа дауыс. Бұл сәттер markers ішінде 0-ден 1-ге дейінгі confidence сенімділігімен жатыр, тарихтағы marker оларды да табады.

Сәт (`kind`)Не болды
hold_musicКүту музыкасы
repeated_promptСол жазба қайта естілді: дауыстық мәзір немесе бот кеңесін қайталады
ringbackКлиент жағындағы телефон гудоктары
client_deviceДыбыс бойынша клиенттің құрылғысы: handset — тұтқа, speakerphone — қатты байланыс, headset — гарнитура. Тарихта — device параметрі
client_voice_changedКлиент жағында басқа дауыс сөйледі
background_changedФон қаттырақ немесе тынышырақ болып, солай қалды: direction, delta_db

TehProf Dialogs-ты CRM жүйеңізге орнатыңыз

Қолданбаны орнату және WhatsApp-ты QR-код арқылы қосу тегін. Желіге жазылым бөлек төленеді.

Битрикс24-ке орнатуamoCRM-ге орнатуKommo-ға орнату