Verimor

Mavibot-та Verimor телефониясын пайдалану үшін Verimor тіркелгіңізден API кілтін алып, оны интеграция параметрлеріне енгізу қажет.

Verimor — түрік телекоммуникация провайдері. Оның Bulut Santralim өнімі — бұлтты АТС: қызметкерлер ішкі нөмірлермен жұмыс істейді, ал қоңыраулар осы нөмірлер арқылы бағытталады.

Бот қызметкерді клиентпен байланыстыра алады, қоңырауларды ауыстыра және аяқтай алады, жазбаларды ала алады және қоңырау оқиғаларын сөйлесуге жібере алады.

Қажетті деректерді алу

1. Verimor-дан Bulut Santralim қызметін белсендіріп, қызметкерлеріңізге ішкі нөмірлер жасаңыз.
2. Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım бөлімін ашып, API кілтін көшіріңіз. Ол келесідей көрінеді:

K12345678-1234-5678-4321-123456789012

3. Қызметкерлердің ішкі нөмірлерін жазып алыңыз. Оларды қолжетімділік параметрлерінде көрсету қажет болады.

API кілті бүкіл АТС үшін ортақ және қоңыраулар мен оқиғаларды қабылдау үшін қолданылады. Егер оны Verimor басқару панелінде қайта жасасаңыз, байланыс формасын қайта сақтаңыз. Әйтпесе, қоңыраулар да, сөйлесу оқиғалары да жұмысын тоқтатады.

Қосылу

Телефония қойындысында Verimor таңдап, келесіні енгізіңіз:

• API кілті — Santral Ayarlarım бөліміндегі кілт.
• Шығыс нөмір — клиент көретін сыртқы нөмір, 908505320000 форматында. Бұл өріс міндетті емес. Бос қалдырсаңыз, қызметкердің ішкі нөміріне тағайындалған нөмір қолданылады.

Интеграция енді қосылды.

Интеграцияны ажырату үшін API кілті өрісін тазалап, параметрлерді сақтаңыз.

Хабарландыру URL мекенжайын қолмен конфигурациялаудың қажеті жоқ. Mavibot оны API кілті сақталған кезде АТС-іңізде автоматты түрде орнатады.

Қызметкерлер

Қызметкер параметрлерінде қызметкердің ішкі нөмірін (dahili) толтырыңыз — әдетте 3–4 цифр, мысалы 1001.

Ішкі АТС нөмірін енгізіңіз, қызметкердің ұялы телефон нөмірін емес. Онсыз клиент картасындағы қоңырау түймесі сол қызметкер үшін жұмыс істемейді.

Клиент картасынан қоңырау шалу

Сөйлесу картасында клиенттің телефон нөмірінің жанында қоңырау түймесі пайда болады.

АТС алдымен қызметкердің ішкі нөміріне қоңырау шалады. Тек қызметкер жауап бергеннен кейін ғана клиентке қоңырау шалады.

Бұл реттілік әдейі: клиент желідегі үнсіздікті естімейді, өйткені қызметкер клиенттің телефоны шырылдай бастағанда қосылған болады.

Калькулятор функциялары

Қызметкерден клиентке қоңырау

verimor_employee_call(client_phone, employee_extension, caller_id)

Параметрлер:

• client_phone — клиенттің телефон нөмірі. Міндетті. Түрік форматын 908505320000 немесе халықаралық қоңыраулар үшін 00493027590915 пайдаланыңыз.
• employee_extension — қоңырау шалатын қызметкердің ішкі нөмірі. Міндетті.
• caller_id — клиент көретін нөмір. Міндетті емес. Көрсетілмесе, байланыс параметрлеріндегі шығыс нөмір қолданылады.

Функция call_uuid — қоңырау идентификаторын қайтарады. Ол сондай-ақ verimor_call_uuid айнымалысына сақталады.

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

verimor_transfer_call(employee_extension, call_uuid)

Ағымдағы қоңырауды басқа ішкі нөмірге ауыстырады.

Параметрлер:

• employee_extension — қоңырау ауыстырылатын ішкі нөмір. Міндетті.
• call_uuid — қоңырау идентификаторы. Міндетті емес. Көрсетілмесе, клиенттің соңғы қоңырауы қолданылады.

Қоңырауды аяқтау

verimor_hangup_call(call_uuid)

Параметрлер:

• call_uuid — қоңырау идентификаторы. Міндетті емес. Көрсетілмесе, клиенттің соңғы қоңырауы қолданылады.

Қоңырау жазбасының сілтемесін алу

verimor_get_record_link(call_uuid)

Қоңырау жазбасына жаңа сілтеме сұрайды.

Параметрлер:

• call_uuid — қоңырау идентификаторы. Міндетті емес. Көрсетілмесе, клиенттің соңғы қоңырауы қолданылады.

Қоңырау кезіндегі кері шақырулар

Қоңырау барысында сөйлесуге келесі форматта кері шақырулар жіберіледі:

verimor_call_event answer

Мүмкін оқиғалар:

Оқиға	Қашан орындалады
ringing	Қоңырау шырылдап тұр
answer	Қоңырауға жауап берілді
hangup	Қоңырау аяқталды
user_hangup	Қызметкер қоңырауды аяқтады

Қызметкерлер арасындағы қоңыраулар сөйлесуде көрінбейді.

Типтік «жауап жоқ → мессенджерде хабарлама жіберу» сценарийін hangup оқиғасы және verimor_call_answered айнымалысын тексеру арқылы іске қосуға болады.

Қоңыраудан кейінгі клиент айнымалылары

Айнымалы	Мәні
verimor_call_uuid	Қоңырау идентификаторы
verimor_call_direction	Бағыт: inbound — клиент сізге қоңырау шалады, outbound — сіз клиентке қоңырау шаласыз
verimor_call_extension	Қоңырауды өңдеген қызметкердің ішкі нөмірі
verimor_call_duration	Қоңырау ұзақтығы секундпен
verimor_call_answered	1 — қоңырауға жауап берілді, 0 — жауап берілмеді
verimor_hangup_cause	Қоңыраудың аяқталу себебін көрсететін код
verimor_has_record	1 — жазба бар, 0 — жазба жоқ
verimor_record_link	verimor_get_record_link() шақырғаннан кейінгі қоңырау жазбасына сілтеме

Қоңырауды аяқтау себептерінің кодтары

verimor_hangup_cause мәнінің ең жиі кездесетін мәндері:

Код	Мағынасы
NORMAL_CLEARING	Қоңырау аяқталды және қалыпты түрде аяқталды
USER_BUSY	Бос емес
NO_ANSWER	Жауап жоқ
ORIGINATOR_CANCEL	Қоңырау шалушы жауап берілмей тұрып қоңырауды тоқтатты
CALL_REJECTED	Қоңырау қабылданбады
UNALLOCATED_NUMBER	Жарамсыз нөмір
NO_USER_RESPONSE	Абонент қолжетімсіз
NOT_ALLOWED_BY_IYS	İYS-те рұқсат жоқ, коммерциялық қоңырауларға арналған түрік келісім тізілімі

Қоңырау жазбалары

Қоңырау жазбасы Verimor АТС параметрлерінде қосылуы керек. Жазбалар Verimor тіркелгіңізде сақталады.

⏳ Жазба сілтемелері сұралған сәттен бастап 60 минут бойы жарамды. Одан кейін олар жұмысын тоқтатады. Verimor сонымен қатар API кілтіне минутына бес жазба сілтемесі сұрауынан артық рұқсат бермейді.

Бұл нені білдіреді:

• verimor_record_link айнымалысы автоматты түрде толтырылмайды. Алдымен verimor_get_record_link() шақыру керек.
• Жазбаны жіберетін сценарийде verimor_get_record_link() функциясын жазбаны жіберу сәтінде шақырыңыз, алдын ала емес.
• Алдымен verimor_has_record мәнін тексеріңіз, сұрау лимитін жазбасы жоқ қоңырауларға жұмсамау үшін.
• Жазбаны тұрақты сақтау қажет болса, қоңыраудан кейін бірден файлды өз сақтау орныңызға сақтаңыз.
• Жазба мұрағаты Verimor басқару панелінде қолжетімді, онда жазбаларды кейінірек ойнатуға және жүктеуге болады.

Қоңырау жазбасы заңмен реттеледі. Түркияда ол KVKK талаптарына бағынады: клиент жазба туралы хабардар болуы керек, ал жеке деректерді сақтау заңды негізге ие болуы тиіс. Verimor тіркелгісінің иесі қолданыстағы талаптарды сақтауға жауапты.

Ақаулықтарды жою

Қате	Себебі / Шешімі
Gecersiz anahtar	Жарамсыз API кілті. Santral Ayarlarım бөлімінен ағымдағы кілтті алыңыз.
extension 1005 not found	Ішкі нөмір АТС-іңізде жоқ. Қызметкер параметрлерінде бар dahili нөмірінің болуын тексеріңіз.
"Verimor ішкі нөмірі көрсетілмеген"	Қызметкер параметрлері бос немесе ішкі нөмірдің орнына ұялы телефон нөмірі бар.
Қоңыраулар жұмыс істейді, бірақ сөйлесуде кері шақырулар жоқ	Хабарландыру URL мекенжайы конфигурацияланбаған. Байланыс формасын қайта сақтаңыз.
API кілтін өзгерткеннен кейін қоңыраулар жұмысын тоқтатты	Кілт Verimor басқару панелінде қайта жасалды. Байланыс формасына жаңа кілтті енгізіп, сақтаңыз.
Жазба сілтемесі ашылмайды	Сілтеме мерзімі өткен. verimor_get_record_link() арқылы жаңасын сұраңыз немесе жазбаны Verimor басқару панелінде ашыңыз.
Жазба сілтемесі қайтарылмайды	Минутына бес сұрау лимитіне жетті немесе қоңырауда жазба жоқ. verimor_has_record мәнін тексеріңіз.