Інтеграція Бітрікс24 з UIS (CoMagic): дзвінки, колтрекінг, аналітика

Клієнт телефонує за номером з сайту, менеджер бачить лише цифри — ні джерела, ні рекламної кампанії. Це знайома ситуація: без прив'язки ви не побачите, скільки звернень прийшло з контекстної реклами, а скільки з SEO, і не зможете оцінити вартість дзвінка з кожного каналу. Якщо дзвінок загубився через збій АТС — ви просто не дізнаєтесь про нього. UIS (CoMagic) вирішує ці проблеми, але без інтеграції з Бітрікс24 дані залишаються розрізненими. Ми налаштовуємо зв'язку так, щоб кожен дзвінок автоматично створював лід з повною атрибуцією. Підключаємо SIP-транк або REST API — залежно від ваших завдань. Результат: єдина CRM з аналітикою по кожному дотику.

Більше 7 років досвіду інтеграцій Бітрікс24 з телефонією. Сертифіковані спеціалісти. Реалізували 30+ проєктів, включаючи кол-центри на 50+ операторів. Гарантія якості на всі роботи. Скорочення нецільових витрат на рекламу до 30% — типовий результат після налаштування колтрекінгу. При будь-якому бюджеті це забезпечує значну економію.

Як інтегрувати Бітрікс24 з UIS (CoMagic)?

Вибір способу підключення залежить від необхідної глибини аналітики.

Для базових сценаріїв вистачає SIP-конектора. Якщо потрібен колтрекінг та розширена аналітика — REST API.

Як налаштувати вхідні та вихідні дзвінки?

Вхідні дзвінки

При вхідному дзвінку Бітрікс24 повинен:

1. Визначити номер того, хто дзвонить, через АОН.
2. Знайти контакт або компанію в CRM за номером телефону.
3. Показати картку клієнта менеджеру до зняття трубки.
4. Створити запис про дзвінок в таймлайні сутності 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
• Сторінку входу та сторінку дзвінка
• Ключове слово (при інтеграції з рекламними кабінетами)

Точна атрибуція дозволяє скоротити нецільові витрати на рекламу до 30%, що дає значну економію щомісяця.

Ці дані передаються в Бітрікс24 при створенні ліда або дзвінка. Схема:

1. Відвідувач заходить на сайт. CoMagic присвоює сесію та підміняє номер.
2. Відвідувач телефонує. UIS фіксує дзвінок з прив'язкою до сесії.
3. Вебхук з UIS відправляє дані в Бітрікс24: номер того, хто дзвонить + джерело + UTM-мітки.
4. Обробник вебхука створює лід в CRM через crm.lead.add із заповненими полями UTM_SOURCE, UTM_MEDIUM, UTM_CAMPAIGN та користувацьким полем «Джерело дзвінка».
5. Якщо контакт вже існує — дзвінок прив'язується до існуючої сутності, UTM-мітки записуються в примітку.

Для коректної роботи користувацькі поля в CRM повинні бути створені заздалегідь. Ми створюємо:

• UF_CRM_CALL_SOURCE (рядок) — назва джерела з CoMagic
• UF_CRM_CALL_KEYWORD (рядок) — ключове слово
• UF_CRM_CALL_LANDING (рядок) — URL сторінки входу

<?php require_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_before.php'); use Bitrix\Main\Web\Json; $data = Json::decode(file_get_contents('php://input')); $phone = $data['caller_id']; $source = $data['source']; $utm = $data['utm']; $leadFields = [ 'TITLE' => 'Звонок с сайта', 'PHONE' => [['VALUE' => $phone, 'VALUE_TYPE' => 'WORK']], 'UF_CRM_CALL_SOURCE' => $source, 'UTM_SOURCE' => $utm['source'], 'UTM_MEDIUM' => $utm['medium'], ]; $lead = new CCrmLead(); $lead->Add($leadFields); ?> 

Що входить в роботу

• Аудит поточної телефонії та CRM
• Підключення SIP-транку UIS або реєстрація REST-додатку
• Маршрутизація вхідних: черги, IVR, розподіл по відділах (на стороні UIS)
• Маппінг внутрішніх номерів UIS → користувачі Бітрікс24
• Створення користувацьких полів для колтрекінгу
• Інтеграція запису розмов (за URL або файлом)
• Логіка створення лідів: новий лід при кожному дзвінку або тільки при відсутності контакту
• Тестування: вхідний, вихідний, пропущений, повторний дзвінок від існуючого клієнта
• Навчання менеджерів та документація по налаштуваннях

Етапи впровадження: терміни та вартість

Вартість розраховується індивідуально залежно від складності. Отримайте консультацію з інтеграції — ми підготуємо пропозицію та оцінимо ваш проект за 1 день.

Документація REST API телефонії Бітрікс24