Mavibot-те VoIPstudio телефониясын пайдалану үшін VoIPstudio тіркелгісінде API кілтін жасап, оны интеграция параметрлеріне енгізіп, интеграция қосылғаннан кейін Mavibot көрсететін URL мекенжайына оқиғаларды жеткізуді конфигурациялау қажет.
VoIPstudio — бұл 70+ елде телефон нөмірлері қолжетімді бұлтты АТС. Дәстүрлі телекоммуникациялық оператордан айырмашылығы, ол ішкі пайдаланушыларды, қоңырау топтарын, кезектерді және IVR мәзірлерін қолдайды, ал бот осы АТС үстінде жұмыс істейді.
Бот қызметкерлер атынан тұтынушыларға қоңырау шала алады, қоңырауларды ауыстыра және аяқтай алады, жазбаларды сақтай алады және қоңырау оқиғаларын сөйлесуге жібере алады.
Қажетті ақпаратты алу
- voipstudio.com сайтында тіркеліп, қажетті елде телефон нөмірін сатып алыңыз.
- АТС-те пайдаланушылар жасаңыз — қоңырауларды қабылдайтын әрбір қызметкерге бір пайдаланушы. Қоңыраулар пайдаланушыға тіркелген барлық құрылғыларға жеткізіледі, сондықтан әр қызметкерге бөлек телефон нөмірін көрсетудің қажеті жоқ.
- Параметрлер → API бөліміне өтіп, API кілтін жасап, оны көшіріңіз.
Интеграцияны қосу
Телефония параметрлерінде VoIPstudio таңдап, келесіні енгізіңіз:
- API кілті — VoIPstudio тіркелгісіндегі кілт.
Интеграция енді қосылды. Оны ажырату үшін API кілті өрісін тазалап, параметрлерді сақтаңыз.
Сақтағаннан кейін бетте хабарландыру URL мекенжайы пайда болады. Оны көшіріңіз:
https://chatter.mavibot.ai/voipstudio_webhook/
Бұл URL мекенжайын жарияламаңыз немесе ешкіммен бөліспеңіз. Интеграцияны ажыратып, қайта қоссаңыз, кілт өзгеріссіз қалады, сондықтан хабарландыруларды қайта конфигурациялаудың қажеті жоқ.
Содан кейін VoIPstudio тіркелгісінде Интеграциялар → Webhooks → Қосу → Webhook қосу бөліміне өтіп, көшірілген URL мекенжайын қойып, келесі оқиғаларды таңдаңыз:
- Қоңырау күйінің өзгеруі — немесе Қоңырау шырылдауы, Қоңырау қосылды, Қоңырау аяқталды және Қоңырау өткізілді оқиғаларын жеке таңдаңыз;
- Қоңырау жазбасы дайын — егер қоңырау жазбалары қажет болса.
Бұл конфигурациясыз шығыс қоңыраулар жұмыс істейді, бірақ қоңырау оқиғалары сөйлесуде көрінбейді.
Қызметкерлер
Қызметкер параметрлерінде VoIPstudio пайдаланушы ID өрісін толтырыңыз — АТС-тегі пайдаланушының сандық идентификаторы, мысалы 10002.
АТС пайдаланушы ID енгізіңіз, телефон нөмірін емес. ID мәнін VoIPstudio тіркелгісіндегі пайдаланушылар тізімінен таба аласыз. Онсыз тұтынушы картасындағы қоңырау түймесі сол қызметкер үшін жұмыс істемейді.
Тұтынушы картасынан қоңырау шалу
Сөйлесу картасында тұтынушының телефон нөмірінің жанында қоңырау түймесі пайда болады.
VoIPstudio алдымен қызметкерге оның барлық тіркелген құрылғыларына бір уақытта қоңырау шалады. Қызметкер жауап бергеннен кейін, VoIPstudio тұтынушыға қоңырау шалып, екі жақты байланыстырады.
Егер қызметкер жауап бермесе, тұтынушыға қоңырау шалынбайды.
Калькулятор функциялары
Қызметкерден тұтынушыға қоңырау
voipstudio_employee_call(client_phone, employee_user_id, caller_id)
Параметрлер:
- client_phone — тұтынушының телефон нөмірі. Міндетті.
- employee_user_id — бірінші қоңырауды қабылдауы тиіс қызметкердің VoIPstudio пайдаланушы ID. Міндетті.
-
caller_id — тұтынушыға көрсетілетін телефон нөмірі. Қосымша. Қоңырау шалушы нөмірін жасыру үшін
anonymousмәнін бере аласыз.
Қоңырауды ауыстыру
voipstudio_transfer_call(phone, call_id)
Белсенді қоңырауды басқа телефон нөміріне ауыстырады.
Параметрлер:
- phone — қоңырау ауыстырылатын телефон нөмірі. Міндетті және бірінші параметр болуы керек.
-
call_id — қоңырау идентификаторы. Қосымша. Егер көрсетілмесе, тұтынушының ағымдағы қоңырауы
voipstudio_call_idайнымалысынан алынады.
Қоңырауды аяқтау
voipstudio_hangup_call(call_id)
Белсенді қоңырауды аяқтайды.
Параметрлер:
- call_id — қоңырау идентификаторы. Қосымша. Егер көрсетілмесе, тұтынушының ағымдағы қоңырауы пайдаланылады.
Қоңырау жазбасының сілтемесін алу
voipstudio_get_record_link(call_id)
Қоңырау жазбасына сілтемені қайтарады. Сілтеме әдетте жазба дайын оқиғасы алынған кезде автоматты түрде сақталады. Бұл функция оқиға алынбаған жағдайда пайдалы.
Параметрлер:
- call_id — қоңырау идентификаторы. Қосымша. Егер көрсетілмесе, тұтынушының ағымдағы қоңырауы пайдаланылады.
Функция тіркелгідегі ең соңғы 100 жазбаны іздейді. Жоғары жүктемелі АТС-тегі ескі қоңырау үшін жазба табылмауы мүмкін. Бұл жағдайда жазбаны тікелей VoIPstudio тіркелгісінен алыңыз.
Қоңырау кезіндегі кері шақырулар
Қоңырау барысында сөйлесуге кері шақырулар келесі форматта жіберіледі:
voipstudio_call_event call.hangup
Оқиға атауы VoIPstudio-дан алынған күйінде беріледі, мысалы call.ringing, call.connected, call.hangup және т.б. Қолжетімді оқиғалар хабарландыруларды конфигурациялау кезінде таңдаған оқиғаларға байланысты.
Егер оқиға атауы берілмесе, оның орнына қоңырау күйі пайдаланылады:
INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP.
Жазба дайын болғанда бөлек кері шақыру жіберіледі:
voipstudio_call_event recording
Жазба сілтемесін пайдаланбас бұрын
recordingкері шақыруын күтіңіз. Жазба қоңырау аяқталғаннан кейін өңделеді, сондықтанcall.hangupалынған кездеvoipstudio_record_linkайнымалысы әлі бос болады.
Егер сіздің АТС-тегі екі қызметкер бір-бірімен сөйлессе, кері шақырулар сөйлесуге жіберілмейді және тұтынушы картасы жасалмайды.
Қоңыраудан кейінгі тұтынушы айнымалылары
| Айнымалы | Мәні |
|---|---|
| voipstudio_call_id | VoIPstudio-дағы қоңырау ID |
| voipstudio_call_state | Қоңырау күйі: INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP
|
| voipstudio_call_duration | Қоңырау ұзақтығы секундпен |
| voipstudio_call_cause | Қоңыраудың аяқталу себебі |
| voipstudio_terminated_by | Қоңырауды кім аяқтады: caller немесе callee
|
| voipstudio_record_link | Қоңырау жазбасына сілтеме |
| voipstudio_record_id | VoIPstudio-дағы жазба ID |
Қоңырау жазбалары
Қоңырау жазбасы VoIPstudio параметрлерінде қосылады және АТС-тің өзі басқарады. Егер жазбалар қажет болса, VoIPstudio тіркелгісінде қоңырау жазбасын қосып, хабарландыруларды конфигурациялау кезінде Қоңырау жазбасы дайын оқиғасын таңдаңыз.
voipstudio_record_linkURL мекенжайы қол жеткізу кілтімен қорғалған. Оны браузерде тікелей ашуға немесе тұтынушымен бөлісуге болмайды. Жазбаны VoIPstudio тіркелгісіндегі қоңырау тарихы бөлімінен жүктеп алуға болады.
Қоңырау жазбасы қолданыстағы заңнамаға бағынады. Германияда, Францияда, Испанияда және АҚШ-тың көптеген штаттарында екі тараптың келісімі қажет болуы мүмкін, ал кейбір юрисдикцияларда қоңыраудың басында ауызша ескерту де қажет болуы мүмкін. Осы талаптардың сақталуына VoIPstudio тіркелгісінің иесі жауапты.
Ақаулықтарды жою
| Қате | Себебі |
|---|---|
| Қоңырау жасау кезінде авторизация қатесі |
API кілті қате немесе мерзімі өткен. Кілттің Параметрлер → API бөлімінде жасалғанына көз жеткізіңіз, login сұрауы арқылы алынған емес. |
| Қоңыраулар жұмыс істейді, бірақ сөйлесуде кері шақырулар жоқ | VoIPstudio-да webhook жасалмаған, Қосу қосқышы өшірулі немесе қате URL енгізілген. Интеграция бетінен толық URL мекенжайын, соның ішінде соңындағы кілтті көшіріңіз. |
| Қоңырау жасалмайды немесе қызметкердің құрылғылары шырылдамайды | VoIPstudio пайдаланушы ID орнына телефон нөмірі енгізілген немесе пайдаланушыда тіркелген құрылғылар жоқ. |
recording кері шақыруы алынбайды |
VoIPstudio-да қоңырау жазбасы қосылмаған немесе Қоңырау жазбасы дайын оқиғасы таңдалмаған. |
VoIPstudio тікелей VoIPstudio-мен есептеседі: әрбір АТС пайдаланушысы үшін жазылым ақысы, қосымша қоңырау төлемдері. Бұл минутына төленетін және тұрақты жазылымсыз операторлардан ерекшеленеді. Шығындарды бағалау кезінде тек қоңырау көлемін емес, конфигурацияланған пайдаланушылар санын ескеріңіз.