Щоб використовувати телефонію VoIPstudio у Mavibot, потрібно створити API-ключ у своєму обліковому записі VoIPstudio, ввести його в налаштуваннях інтеграції та налаштувати доставку подій на URL-адресу, яку Mavibot показує після підключення інтеграції.
VoIPstudio — це хмарна АТС із телефонними номерами, доступними в понад 70 країнах. На відміну від традиційного телеком-оператора, вона підтримує внутрішніх користувачів, групи дзвінків, черги та IVR-меню, а бот працює поверх цієї АТС.
Бот може ініціювати дзвінки клієнтам від імені співробітників, переводити та завершувати дзвінки, зберігати записи та надсилати події дзвінків у розмову.
Отримання необхідної інформації
- Зареєструйтеся на voipstudio.com і придбайте телефонний номер у потрібній країні.
- Створіть користувачів в АТС — по одному для кожного співробітника, який отримуватиме дзвінки. Дзвінки доставляються на всі пристрої, зареєстровані за користувачем, тому вам не потрібно вказувати окремий номер телефону для кожного співробітника.
- Перейдіть у Налаштування → API, створіть API-ключ і скопіюйте його.
Підключення інтеграції
У налаштуваннях телефонії виберіть VoIPstudio і введіть:
- API-ключ — ключ із вашого облікового запису VoIPstudio.
Інтеграцію підключено. Щоб відключити її, очистіть поле API-ключ і збережіть налаштування.
Після збереження на сторінці з’явиться URL-адреса сповіщень. Скопіюйте її:
https://chatter.mavibot.ai/voipstudio_webhook/
Не публікуйте цю URL-адресу та не діліться нею ні з ким. Якщо ви відключите та повторно підключите інтеграцію, ключ залишиться тим самим, тому вам не доведеться налаштовувати сповіщення знову.
Потім у своєму обліковому записі VoIPstudio перейдіть у Інтеграції → Webhooks → Увімкнути → Додати webhook, вставте скопійовану URL-адресу та виберіть такі події:
- Зміна стану дзвінка — або виберіть окремо Call Ringing, Call Connected, Call Ended і Call Missed;
- Call Recording Ready — якщо вам потрібні записи дзвінків.
Без цього налаштування вихідні дзвінки все одно працюватимуть, але події дзвінків не з’являтимуться в розмові.
Співробітники
У налаштуваннях співробітника заповніть поле VoIPstudio User ID — числовий ідентифікатор користувача у вашій АТС, наприклад 10002.
Введіть ID користувача АТС, а не номер телефону. ID можна знайти в списку користувачів у вашому обліковому записі VoIPstudio. Без нього кнопка дзвінка в картці клієнта не працюватиме для цього співробітника.
Дзвінок із картки клієнта
Поруч із номером телефону клієнта в картці розмови з’явиться кнопка дзвінка.
VoIPstudio спочатку дзвонить співробітнику на всі його зареєстровані пристрої одночасно. Коли співробітник відповідає, VoIPstudio дзвонить клієнту та з’єднує обидві сторони.
Якщо співробітник не відповідає, клієнту дзвінок не здійснюватиметься.
Функції калькулятора
Дзвінок від співробітника клієнту
voipstudio_employee_call(client_phone, employee_user_id, caller_id)
Параметри:
- client_phone — номер телефону клієнта. Обов’язковий.
- employee_user_id — ID користувача VoIPstudio співробітника, який має отримати перший дзвінок. Обов’язковий.
-
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, перш ніж використовувати посилання на запис. Запис обробляється після завершення дзвінка, тому зміннаvoipstudio_record_linkще порожня, коли отриманоcall.hangup.
Якщо два співробітники у вашій власній АТС розмовляють один з одним, зворотні виклики не надсилаються в розмову, і картка клієнта не створюється.
Змінні клієнта після дзвінка
| Змінна | Значення |
|---|---|
| voipstudio_call_id | ID дзвінка у VoIPstudio |
| 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 | ID запису у VoIPstudio |
Записи дзвінків
Запис дзвінків вмикається у налаштуваннях VoIPstudio і керується самою АТС. Якщо вам потрібні записи, увімкніть запис дзвінків у своєму обліковому записі VoIPstudio та виберіть подію Call Recording Ready під час налаштування сповіщень.
URL-адреса
voipstudio_record_linkзахищена ключем доступу. Її не можна відкрити безпосередньо в браузері або поділитися з клієнтом. Ви можете завантажити запис зі свого облікового запису VoIPstudio в розділі історії дзвінків.
Запис дзвінків регулюється чинним законодавством. У Німеччині, Франції, Іспанії та більшості штатів США може знадобитися згода обох сторін, а в деяких юрисдикціях — також усне повідомлення на початку дзвінка. Власник облікового запису VoIPstudio несе відповідальність за дотримання цих вимог.
Усунення несправностей
| Помилка | Причина |
|---|---|
| Помилка авторизації під час створення дзвінка |
API-ключ неправильний або прострочений. Переконайтеся, що ключ створено в Налаштування → API, а не отримано через запит login. |
| Дзвінки працюють, але зворотні виклики не з’являються в розмові | У VoIPstudio не створено webhook, перемикач Увімкнути вимкнено або введено неправильну URL-адресу. Скопіюйте всю URL-адресу зі сторінки інтеграції, включно з ключем у кінці. |
| Дзвінок не створюється або пристрої співробітника не дзвонять | Замість VoIPstudio User ID введено номер телефону, або в користувача немає зареєстрованих пристроїв. |
Зворотний виклик recording не отримано |
Запис дзвінків не ввімкнено у VoIPstudio або не вибрано подію Call Recording Ready. |
VoIPstudio виставляє рахунки безпосередньо: є абонентська плата за кожного користувача АТС плюс плата за дзвінки. Це відрізняється від операторів, які стягують плату за хвилину без регулярної підписки. Оцінюючи витрати, враховуйте кількість налаштованих користувачів, а не лише обсяг дзвінків.