Інтеграція Бітрикс24 з UIS (CoMagic)
UIS (CoMagic) — платформа телефонії та коллтрекінгу. Підключення до Бітрикс24 дає команді продажів єдине вікно: дзвінки, записи розмов, аналітику за джерелами — все всередину CRM. Налаштовуємо інтеграцію так, щоб кожен дзвінок перетворювався на сутність CRM з коректною атрибуцією джерела.
Два підходи до підключення
| Параметр | SIP-коннектор Бітрикс24 | REST API (користувацька інтеграція) |
|---|---|---|
| Складність налаштування | Низька — штатний інтерфейс Б24 | Середня — потрібна розробка |
| Вхідні дзвінки | Через SIP-транк UIS | Через метод telephony.externalcall.register |
| Вихідні дзвінки | Click-to-call через софтфон | Click-to-call через callback API UIS |
| Запис розмов | Завантаження за посиланням з UIS | telephony.externalcall.attachRecord |
| Коллтрекінг | Не підтримується | Повна передача utm-меток та джерела |
| Картка клієнта | Спливає штатно | Спливає + додаткові поля |
Для базових сценаріїв достатньо SIP-коннектора. Якщо потрібен коллтрекінг та розширена аналітика — REST API.
Вхідні дзвінки
При вхідному дзвінку Бітрикс24 повинен:
- Визначити номер дзвонка через АОН.
- Знайти контакт або компанію в CRM за номером телефону.
- Показати картку клієнта менеджеру до зняття трубки.
- Створити запис про дзвінок у таймлайні сутності CRM.
Через SIP-коннектор це працює з коробки при правильному налаштуванні SIP-облікових записів. Через REST API — вебхук з UIS викликає telephony.externalcall.register з параметрами PHONE_NUMBER, USER_ID, TYPE=1 (вхідний). Бітрикс24 піднімає картку автоматично.
Вихідні дзвінки
Менеджер натискає на номер у картці CRM. Далі два варіанти:
- SIP-коннектор. Дзвінок йде через софтфон Бітрикс24 безпосередньо на SIP-транк UIS.
- REST API + callback. Бітрикс24 відправляє запит у UIS через callback API — АТС дзвонить спочатку менеджеру, потім клієнту. Менеджер знімає трубку — дзвінок з'єднується.
Другий варіант зручніший для колл-центрів: не потрібен софтфон, дзвінок приходить на звичайний робочий телефон.
Запис розмов
UIS зберігає записи розмов на своїх серверах. Варіанти завантаження в Б24:
-
Пряме посилання. Метод
telephony.externalcall.attachRecordприймає URL файлу запису. Бітрикс24 завантажує та прив'язує до дзвінку у таймлайні. -
Завантаження файлу. Якщо UIS відає файл через API, проміжний скрипт завантажує MP3 та вивантажує в Б24 через
disk.folder.uploadfile, потім прив'язує до дзвінку.
Записи доступні у картці контакту, угоді та у загальному звіті за дзвінками.
Коллтрекінг та атрибуція лідів
Головна цінність зв'язки UIS + Бітрикс24 — розуміння, звідки прийшов дзвінок. CoMagic підміняє номери на сайті: кожен відвідувач бачить унікальний номер, прив'язаний до його сесії. Коли клієнт дзвонить, UIS знає:
- Джерело трафіку — Google Ads, Яндекс.Директ, SEO, прямий захід
- UTM-метки — campaign, medium, source, content, term
- Сторінка входу та сторінка дзвінка
- Ключове слово (при інтеграції з рекламними кабінетами)
Ці дані передаються в Бітрикс24 при створенні лід або дзвінка. Схема:
- Відвідувач заходить на сайт. CoMagic присвоює сесію та підміняє номер.
- Відвідувач дзвонить. UIS фіксує дзвінок з прив'язкою до сесії.
- Вебхук з UIS відправляє дані в Бітрикс24: номер дзвонка + джерело + utm-метки.
- Обробник вебхука створює лід у CRM через
crm.lead.addз заповненими полямиUTM_SOURCE,UTM_MEDIUM,UTM_CAMPAIGNта користувацьким полем «Джерело дзвінка». - Якщо контакт уже існує — дзвінок прив'язується до існуючої сутності, utm-метки записуються у примітку.
Для коректної роботи користувацькі поля в CRM мають бути створені заздалегідь. Ми створюємо:
-
UF_CRM_CALL_SOURCE(рядок) — назва джерела з CoMagic -
UF_CRM_CALL_KEYWORD(рядок) — ключове слово -
UF_CRM_CALL_LANDING(рядок) — URL сторінки входу
Звіти за дзвінками
Бітрикс24 формує вбудовані звіти: кількість дзвінків за менеджерами, пропущені, тривалість. Для розширеної аналітики з урахуванням джерел використовуємо:
- Списки або смарт-процеси — агрегація даних коллтрекінгу в окрему сутність для побудови звітів у BI-конструкторі Б24.
-
Вивантаження в Google Sheets / Power BI — через REST API
crm.lead.listз фільтром за UTM-полями.
Що налаштовуємо при впровадженні
- Підключення SIP-транка UIS або реєстрація серверного додатка для REST API
- Маршрутизація вхідних: розподіл за відділами, чергами, IVR (на стороні UIS)
- Маппінг внутрішніх номерів UIS → користувачі Бітрикс24
- Логіка створення лідів: новий лід при кожному дзвінку або тільки при відсутності контакту
- Передача даних коллтрекінгу та налаштування користувацьких полів CRM
- Підключення запису розмов зі збереженням у Б24 або за посиланням
- Тестування: вхідний, вихідний, пропущений, повторний дзвінок від існуючого клієнта