Інтеграція з Ringostat

Ringostat — сервіс IP-телефонії і колтрекінгу. Після підключення до Skynum ви отримуєте журнал дзвінків із записами розмов і UTM-мітками, картку вхідного дзвінка з інформацією про клієнта ще до підняття слухавки, дзвінок в один клік, автоматичні завдання на пропущені дзвінки, розумну маршрутизацію на відповідального менеджера і аналітику дзвінків.

Як працює телефонія у Skynum

Ця стаття описує саме підключення Ringostat. Про те, що вміє телефонія після підключення — журнал, картка дзвінка, пропущені, аналітика — читайте в розділі Телефонія.

Підключення складається з трьох частин: створити інтеграцію у Skynum, зіставити співробітників і налаштувати кабінет Ringostat.

Що потрібно підготувати

• активний кабінет Ringostat з підключеним номером;
• SIP-акаунти співробітників, які вже додані в Ringostat і приймають дзвінки;
• доступ до розділів Ringostat API і Webhooks 2.0 кабінету;
• доступ до розділу Віртуальна АТС — він знадобиться для розумної маршрутизації.

Ключ API і проєкт у Ringostat

1. Увійдіть у кабінет Ringostat.
2. Відкрийте Інтеграція → Ringostat API.
3. Скопіюйте Auth-key. Якщо ключа ще немає, згенеруйте його на цій сторінці.
4. Скопіюйте Project id.

У Skynum Auth-key вставляється в поле Токен, а Project id — у поле ID проєкту.

Зберігайте ключ у таємниці

Не публікуйте Auth-key у листуванні чи скриншотах — він дає програмний доступ до проєкту Ringostat.

Що зробити в Skynum

1. Відкрийте Налаштування → Інтеграції → Телефонія.
2. Натисніть Додати інтеграцію.
3. Виберіть Ringostat.
4. Заповніть Назва інтеграції.
5. Увімкніть Інтеграція активна.
6. У полі Токен вставте Auth-key з кабінету Ringostat.
7. У полі ID проєкту вставте Project id.
8. За потреби виберіть Філія, юридична особа.
9. Натисніть Перевірити підключення.
10. Якщо перевірка успішна, збережіть інтеграцію.

Після збереження внизу сторінки з'явиться поле Webhook URL (вставте у кабінет телефонії). Скопіюйте цю адресу — вона знадобиться в кабінеті Ringostat і для вебхуків, і для кроку розумної маршрутизації. Адреса одна для всього.

Автоматичне завдання для пропущеного дзвінка увімкнене від початку: на кожен пропущений вхідний дзвінок Skynum створюватиме завдання передзвонити. Якщо такий сценарій вам не потрібен, вимкніть перемикач.

Якщо у вас підключено кілька телефоній, позначте одну з них За замовчуванням — саме через неї працюватиме дзвінок в один клік.

Напрямки співробітників у Ringostat

У довіднику співробітників Ringostat у кожного може бути кілька напрямків: SIP робочого місця, SIP мобільного застосунку, звичайний телефонний номер. Радимо додати співробітнику всі напрямки, якими він реально користується:

• SIP-напрямки — основні: при маршрутизації і дзвінку в один клік дзвонять одразу всі SIP-робочі місця співробітника, і він відповідає там, де йому зручно;
• телефонний номер — резерв на випадок роботи без SIP-застосунку: якщо дзвонити нікуди, крім особистого телефону, дзвінок піде на нього.

Поки у співробітника є хоч один SIP-напрямок, особистий телефон не дзвонить.

Співробітники телефонії у Skynum

Щоб Skynum розумів, хто зі співробітників прийняв або здійснив дзвінок, зіставте користувачів Skynum з їхніми напрямками в Ringostat:

1. В інтеграції відкрийте вкладку API мапінг.
2. У секції Співробітники телефонії навпроти кожного співробітника виберіть його напрямки з довідника Ringostat. Якщо список порожній, натисніть Завантажити з Ringostat.
3. Збережіть мапінг.

Одному співробітнику можна вибрати кілька напрямків — виберіть усі його. Для вихідних дзвінків використовується перший SIP-напрямок співробітника з довідника Ringostat.

Що зробити в Ringostat

Вебхуки подій дзвінків

Вебхуки повідомляють Skynum про початок, відповідь і завершення дзвінка — завдяки їм дзвінки з'являються у Skynum одразу. Потрібно п'ять вебхуків, по одному на кожну подію:

1. Перед дзвінком.
2. Перед вихідним дзвінком.
3. У момент підняття трубки.
4. Після дзвінка.
5. Після вихідного дзвінка.

Для кожної з п'яти подій:

1. У кабінеті Ringostat відкрийте Інтеграція → Webhooks 2.0.
2. Натисніть Додати подію.
3. Вкажіть зрозумілу назву й виберіть потрібну подію.
4. Додайте дію HTTP.
5. Виберіть метод POST.
6. У поле Напрямок вставте Webhook URL, скопійований у Skynum.
7. Додайте заголовок Content-Type зі значенням application/json.
8. Для формату відправлення даних виберіть json, формат дати залиште стандартним.
9. У блоці Тіло запиту натисніть Додати всі параметри — так Skynum гарантовано отримає всі потрібні дані.
10. Збережіть і активуйте подію.

Розумна маршрутизація на відповідального менеджера

Skynum може підказувати Ringostat, кому направити вхідний дзвінок: якщо клієнт закріплений за відповідальним менеджером, дзвінок піде спочатку саме йому. Докладніше про логіку — у статті Розумна маршрутизація.

Налаштування складається з двох частин: створити Webhook номер і поставити його першим у чинній схемі переадресації.

Спочатку створіть Webhook номер:

1. У кабінеті Ringostat відкрийте Налаштування → Віртуальна АТС → Webhook номер.
2. Натисніть Додати Webhook номер переадресації.
3. Вкажіть зрозумілу назву.
4. У поле URL вставте Webhook URL, скопійований у Skynum.
5. Для Метод відправки даних виберіть POST.
6. Для Тип відправки даних і Тип отримання даних виберіть json.
7. У полі Поле номеру переадресації (для json) вкажіть dst_callee.
8. Додайте параметр caller і виберіть для нього значення Номер абонента.
9. Поле Json-rpc метод залиште порожнім.
10. Натисніть Зберегти.

Потім додайте його до схеми:

1. Відкрийте Налаштування → Віртуальна АТС → Переадресація.
2. Відкрийте чинну схему, яка обслуговує ваш номер. Нову схему створювати не потрібно.
3. Відкрийте потрібну гілку за днями й часом.
4. Додайте напрямок Webhook номер, виберіть створене налаштування і розташуйте його першим.
5. Одразу після нього залиште звичайний напрямок — той, на який дзвінки йшли до інтеграції.
6. За потреби налаштуйте час очікування для напрямків.
7. Натисніть Зберегти.

Після кроку «Webhook номер» має стояти звичайний крок з напрямками

Крок «Webhook номер» — це підказка, а не повний сценарій. Якщо номер клієнта невідомий Skynum або в клієнта немає відповідального менеджера, дзвінок має піти далі за звичайною схемою.

Обов'язково залиште після Webhook номер звичайний напрямок: співробітника, відділ, чергу або інший маршрут компанії. Без нього дзвінок, для якого Skynum не дав відповідального, одразу завершиться.

Дзвінок в один клік

Окремих налаштувань у кабінеті Ringostat не потребує. Щойно співробітники зіставлені на вкладці API мапінг, дзвінок в один клік працює: спочатку дзвонить робоче місце менеджера, після підняття слухавки — клієнт. Докладніше: Дзвінок в один клік.

Перевірка після підключення

1. Подзвоніть на свій номер Ringostat з мобільного.
2. У Skynum має з'явитися картка вхідного дзвінка, а після завершення — запис у журналі Телефонія → Журнал дзвінків.
3. Перевірте, що в дзвінку визначився співробітник, який відповів.
4. Не візьміть слухавку на тестовому дзвінку — переконайтеся, що створилося завдання передзвонити (якщо перемикач увімкнений).
5. Відкрийте будь-яку картку з телефоном, натисніть на номер і виберіть Дзвінок — перевірте дзвінок в один клік.

Типові проблеми

Дзвінки не з'являються у Skynum одразу

Перевірте в Інтеграція → Webhooks 2.0, що створені й активні всі п'ять подій, кожна використовує метод POST, формат json і саме Webhook URL з інтеграції, а поля додані кнопкою Додати всі параметри. Ringostat не повторює вебхук, який не вдалося доставити, але Skynum регулярно синхронізує журнал дзвінків з Ringostat — дзвінок з'явиться в журналі трохи пізніше разом із записом розмови.

У дзвінку не визначається співробітник

Відкрийте вкладку API мапінг і перевірте, що співробітнику вибрані саме ті напрямки, якими він реально користується. Якщо напрямку немає в списку, натисніть Завантажити з Ringostat.

Дзвінок обривається одразу після кроку «Webhook номер»

У схемі переадресації після Webhook номер немає наступного напрямку. Додайте після нього звичайний напрямок. Якщо дзвінок взагалі не доходить до відповідального, відкрийте створений Webhook номер і перевірте параметр caller зі значенням Номер абонента та поле відповіді dst_callee.

Дзвонить особистий телефон співробітника, хоча він за SIP-застосунком

Перевірте напрямки співробітника: поки у нього є хоч один SIP-напрямок, особистий номер не дзвонить. Якщо дзвонить саме він — SIP-напрямки не додані в довіднику Ringostat або не вибрані в мапінгу.

Перевірка підключення не проходить

Перевірте Auth-key у полі Токен і Project id у полі ID проєкту — скопіюйте їх з Інтеграція → Ringostat API ще раз, без зайвих пробілів, і переконайтеся, що обидва значення з одного проєкту.