API арқылы қоңыраулар

Бағдарламаның қоңырауы — оператордікі сияқты желінің қоңырауы: ол қоңыраулар журналына, диалог тарихына және CRM-ге түседі. Бағдарлама тек өз кілтінің желілерін және оператор көретін диалогтарды ғана көреді.

API арқылы қоңыраулар WhatsApp Web және Telegram желілерінде жұмыс істейді.

Бағдарлама не істей алады

• Кіріс қоңырауды қабылдау, қабылдамау немесе тұтқаны қою.
• Желіден клиентке қоңырау шалу: қоңырау бірінші гудоктан бағдарламаға тиесілі.
• Клиентпен нақты уақытта сөйлеу және тыңдау, ол сөзді бөлсе, үнсіз қалу.
• Клиентті желі адамдарына беру: клиент гудок естиді, операторларда кәдімгі кіріс қоңырау сияқты шырылдайды.
• Қоңырау қызметкерлердің қайсысына бірінші түсетінін таңдау.
• Қоңыраулар туралы оқиғалардан білу — өз вебхугыңызға немесе сұрау арқылы, тіпті өз серверіңізсіз.
• Сөйлесуде не болғаны бойынша тарихтан іздеу және клиенттің қайталама қоңырауларын тану.
• Қоңырау қорытындысын алу — жазба дыбысы бойынша, ЖИ-сіз есептелген сөйлесу сандары.

1-қадам. Қоңыраулар кілтін алыңыз

1. Иесі немесе әкімші Баптаулар → API бөлімін ашады.
2. Қоңыраулар кілті батырмасын басыңыз.
3. Бағдарлама жұмыс істейтін желілерді белгілеңіз.
4. gw_… кілтін көшіріңіз: ол бір рет көрсетіледі. Кілтті сол жерде кері қайтарып алуға болады.
5. Кілттің жанындағы тексеру командасын орындаңыз: ол оның желілерінде дәл қазір жүріп жатқан қоңырауларды көрсетеді.

Не көресіз: тексеру командасы кілт желілерінде қазір жүріп жатқан қоңырауларды қайтарады.

Қоңыраулар кілтінің екі құқығы бар: calls:voice — қоңырау алу және шалу, оларда сөйлеу, және channels:read — желілерді көру.

2-қадам. Алғашқы сұрау

API мекенжайы — https://dialogs.tehprof.kz/api/v1/gw/. Әр сұрауда Authorization: Bearer gw_… тақырыбы болады.

curl https://dialogs.tehprof.kz/api/v1/gw/calls/ \
  -H "Authorization: Bearer gw_xxx"

{ "calls": [] }

Не көресіз: қазір қоңырау болмаса — { "calls": [] } жауабы, болса — жүріп жатқан қоңыраулар тізімі.

Әрі қарай: алғашқы бот

• Ең жылдамы — Python SDK: жауап беріп, клиентті адамдарға беретін бот он шақты жол.
• Кез келген тілдегі өз кодыңыз — командалар, дауыс және оқиғалар.
• Сөйлесуден кейін қоңырауларды талдау — тарих және қоңырау қорытындысы.
• Сұрау бас тартса — қателер.