Інтеграція Бітрікс24 з Sipuni
Sipuni — російський хмарний сервіс віртуальної АТС, орієнтований на малий і середній бізнес. Особливість Sipuni — акцент на простоті налаштування та готових CRM-інтеграціях. Офіційний конектор Sipuni для Бітрікс24 входить до маркетплейсу і покриває базові потреби. Для складніших сценаріїв доступний прямий API.
Офіційний конектор Sipuni
Встановлюється з каталогу Бітрікс24 (Застосунки → Маркетплейс → Sipuni). Авторизація через API-ключ Sipuni. Після підключення працює:
- Спливаюча картка при вхідному дзвінку
- Створення лідів при пропущених дзвінках
- Історія дзвінків у CRM
- Вихідні дзвінки з картки CRM
- Прикріплення записів розмов
Офіційний конектор достатній для більшості сценаріїв малого бізнесу. Обмеження з'являються при нестандартній маршрутизації або коли кілька порталів Бітрікс24 мають працювати з однією Sipuni-АТС.
Sipuni API: розширена інтеграція
Sipuni надає REST API та webhooks. Документація доступна за адресою sipuni.com/api.
Авторизація: Sipuni використовує API-ключ, що передається в заголовку запиту X-Api-Key або як параметр api_key.
Отримання подій: в особистому кабінеті Sipuni (розділ Налаштування → Інтеграції → Webhooks) налаштовується URL для сповіщень. Sipuni підтримує події:
-
call.incoming— вхідний дзвінок (ще не відповіли) -
call.answered— оператор відповів -
call.ended— дзвінок завершено -
call.missed— пропущений дзвінок
Маршрутизація в Sipuni і відображення в Бітрікс24
Sipuni підтримує сценарії та схеми маршрутизації. Вхідний дзвінок може проходити через кілька кроків: IVR → черга → конкретний співробітник. У webhook Sipuni передає поле answered_by — внутрішній номер того, хто відповів останнім.
Якщо потрібно відстежувати весь шлях дзвінка (пройшов через IVR → був у черзі N секунд → відповів співробітник X), це реалізується через складові події Sipuni або через додатковий запит до API історії дзвінків після завершення.
Запис дзвінків у Sipuni
Sipuni зберігає записи в хмарі. Доступ через API:
GET https://sipuni.com/api/v1/records/{call_id}
X-Api-Key: {api_key}
Sipuni повертає посилання на файл або redirect на завантаження. Термін зберігання визначається тарифом (зазвичай 14–30 днів на базових тарифах). Для довгострокового зберігання — завантажувати і зберігати у власне сховище при кожній події call.ended.
Робота з кількома співробітниками
При груповому дзвінку (кілька телефонів дзвонять одночасно) Sipuni у webhook передає answered_by лише при відповіді одного зі співробітників. Інші події про відхилені дзвінки до інших співробітників не надходять — це спрощує обробку порівняно з деякими іншими провайдерами.
Кейс: агентство нерухомості, 20 агентів
Агентство використовувало Sipuni із закріпленими номерами за окремими агентами (у кожного агента — свій міський номер від Sipuni). Клієнт телефонує безпосередньо агенту. Вимога: кожен дзвінок має створюватися в CRM у конкретного агента, а якщо агент недоступний і дзвінок переадресовано колезі — це теж має фіксуватися.
Реалізація через кастомний webhook-обробник: таблиця {міський номер Sipuni → USER_ID Бітрікс24}. При вхідному дзвінку реєструється дзвінок у відповідального агента (власника номера). Якщо через 15 секунд не відповів — Sipuni переадресує на наступного в ланцюжку. При події answered_by з іншим номером обробник оновлює відповідального в дзвінку.
Додатково: аналіз пропущених — якщо агент не відповідає більше 3 дзвінків на день, система створює завдання керівнику для розбору ситуації.
Термін налаштування: 3–5 робочих днів.