Інтеграція з 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. За потреби виберіть Філія, юридична особа.
7. У полі Токен вставте Auth-key з кабінету Ringostat.
8. У полі ID проєкту вставте Project id.
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 ще раз, без зайвих пробілів, і переконайтеся, що обидва значення з одного проєкту.