Verimor

Щоб використовувати телефонію Verimor у Mavibot, потрібно отримати API-ключ з вашого облікового запису Verimor і ввести його в налаштуваннях інтеграції.

Verimor — турецький телекомунікаційний провайдер. Його продукт Bulut Santralim — це хмарна АТС: співробітники працюють із внутрішніми номерами, а дзвінки маршрутизуються через ці номери.

Бот може з'єднувати співробітника з клієнтом, переводити та завершувати дзвінки, отримувати записи та надсилати події дзвінків у розмову.

Отримання необхідних даних

1. Активуйте послугу Bulut Santralim у Verimor і створіть внутрішні номери для своїх співробітників.
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.