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

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

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

Как интегрировать Битрикс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%, что в среднем экономит 100 000–200 000 руб в месяц.

Эти данные передаются в Битрикс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