Интеграция Битрикс24 с 3CX: настройка, кейсы, решение проблем

Интеграция Битрикс24 с 3CX

Представьте: компания использует 3CX и Битрикс24, но звонки не фиксируются в CRM. Менеджеры тратят время на ручной ввод данных, теряются лиды, сложно отследить качество обслуживания. Это типичная ситуация, когда нужна бесшовная интеграция телефонии. Мы решаем такие задачи — синхронизируем звонки, записи и автоматически создаём карточки в CRM. В этой статье разберём технические детали двух официальных способов интеграции и расскажем о подводных камнях, с которыми столкнулись на практике. Наша команда — сертифицированные специалисты с 10+ летним опытом в Битрикс24 и 3CX, мы выполнили более 50 интеграций телефонии. За счёт автоматизации вы экономите до 20 рабочих часов в месяц на каждого менеджера — это даёт до 40 000 руб экономии.

3CX — коммерческая IP-АТС с продуманным веб-интерфейсом и собственной экосистемой клиентских приложений. В отличие от Asterisk, 3CX предоставляет структурированный API для интеграций — что упрощает задачу, но и накладывает ограничения на архитектурные решения.

Как настроить Custom CRM Integration в 3CX для Битрикс24?

1. В консоли 3CX Management Console перейдите в CRM Integration → Custom CRM.
2. Укажите URL для события "Call Answered":

   https://ваш_портал.bitrix24.ru/rest/КЛЮЧ/telephony.externalcall.register/
   

   Параметры передаются в теле POST:

   {
     "USER_PHONE_INNER": "%Ext%",
     "PHONE_NUMBER": "%CallerNumber%",
     "CALL_START_DATE": "%CallStarted%",
     "CRM_CREATE": "Y",
     "TYPE": "%Direction%"
   }
   

3. Укажите URL для события "Call Ended":

   https://ваш_портал.bitrix24.ru/rest/КЛЮЧ/telephony.externalcall.finish/
   

   Параметры:

   {
     "CALL_ID": "%call_id_saved%",
     "DURATION": "%TalkDuration%",
     "STATUS_CODE": "200"
   }
   

4. Сохраните настройки.

Проблема: Custom CRM Integration в 3CX не предоставляет механизма хранения состояния — нельзя сохранить CALL_ID из ответа Битрикс24 и передать при завершении. Это ключевое ограничение: для полноценной интеграции с сохранением CALL_ID нужен промежуточный сервер.

Почему нужен промежуточный сервер для передачи CALL_ID?

Архитектура с промежуточным обработчиком решает проблему:

3CX → webhook → PHP/Node.js обработчик
                     ↓
              Битрикс24 REST API → получаем CALL_ID
                     ↓
              Сохраняем CALL_ID в Redis/БД с ключом = UNIQUEID звонка
                     ↓
3CX → webhook завершения → обработчик
                     ↓
              Достаём CALL_ID из Redis
                     ↓
              telephony.externalcall.finish
                     ↓
              Прикрепляем запись

Это добавляет компонент инфраструктуры, но даёт полный контроль над интеграцией. Мы используем такой подход во всех проектах — он надёжнее и масштабируемее. Средняя стоимость окупается за 3-6 месяцев за счёт исключения ручного ввода.

Запись звонков: как передать в Битрикс24

3CX сохраняет записи в директории сервера или в облачном хранилище (зависит от версии и настроек). Доступ к файлам через 3CX Recording Storage API или напрямую к файловой системе. Для передачи в Битрикс24 — скрипт после завершения звонка обращается к 3CX API, получает ссылку на запись и загружает её через telephony.externalCall.attachRecord.

3CX возвращает ссылку на запись через API звонков:

GET /api/recordings?callId={callId}

Авторизация через JWT-токен (3CX версии 18+): Authorization: Bearer <token>.

3CX SBC и проблема NAT: что проверить

3CX часто разворачивается с SBC (Session Border Controller) для NAT-traversal. При интеграции с Битрикс24 через SIP-транк нужно убедиться, что внешний IP SBC прописан в настройках SIP-транка Битрикс24. Иначе — одностороннее аудио при звонках от Битрикс24 к 3CX. Это частая ошибка, которую мы выявляем на этапе аудита. Получите консультацию по вашей инфраструктуре — напишите нам, мы проверим конфигурацию.

Сравнение методов интеграции

Типичные ошибки и их решения

Кейс из нашей практики: распределённая команда, 3CX в облаке

IT-компания с офисами в двух городах использовала 3CX Hosted (облачная версия). Требование: когда клиент звонит на московский номер и попадает к питерскому менеджеру, в Битрикс24 звонок должен создаваться у питерского менеджера с привязкой к московскому входящему номеру.

3CX Custom CRM Integration не поддерживает маппинг внутренних номеров на пользователей Битрикс24. Решили через промежуточный обработчик с таблицей соответствий: внутренний номер 3CX → ID пользователя Битрикс24. При регистрации звонка обработчик смотрит в таблицу и подставляет USER_ID нужного пользователя. Срок настройки: 7 рабочих дней. Клиент получил полностью автоматизированную телефонию с корректной маршрутизацией.

Что входит в нашу работу по интеграции

• Аудит текущей конфигурации 3CX и Битрикс24.
• Проектирование архитектуры (промежуточный сервер, маппинг, запись).
• Настройка Custom CRM Integration или CFD под ваши задачи.
• Разработка промежуточного обработчика (PHP/Node.js) с сохранением CALL_ID.
• Интеграция записи звонков: API 3CX → загрузка в Битрикс24.
• Траблшутинг NAT/SBC, SIP-транков.
• Тестирование и обучение пользователей.
• Гарантийная поддержка 30 дней.

Оценим ваш проект за 1-2 дня. Свяжитесь с нами — подберём оптимальное решение под вашу инфраструктуру.

Настройка телефонии под ключ: от SIP до CRM

SIP-транк не регистрируется — первая проблема при подключении телефонии к Битрикс24. Клиент присылает данные от провайдера, вбиваешь в раздел «Телефония → Настройка телефонии → SIP-коннектор», а статус висит «Ожидание регистрации». Порты 5060/5061 для SIP и диапазон 10000–20000 для RTP закрыты на фаерволе — классика. Или кодек G.729 не поддерживается, а G.711 жрёт полосу по 87 кбит/с на линию. На 20 одновременных разговоров — считайте сами. Мы подключаем и настраиваем телефонию так, чтобы звонки не терялись, маршрутизация работала по логике бизнеса, а CRM получала данные автоматически.

Протокол SIP (Session Initiation Protocol) — стандарт для голосовой связи через интернет. Наши специалисты имеют 5+ лет опыта интеграции с Битрикс24. Гарантия на настроенные решения — 1 год. Свяжитесь с нами для бесплатного аудита текущей инфраструктуры — часто находим слепые зоны: пропущенные без задач, менеджеры со статусом «На линии» и нулём звонков, IVR-ветки, в которые никто не попадает.

SIP-регистрация и подключение: как избежать срывов?

Неправильный NAT, закрытые порты или несовместимые кодеки — 90% сбоев. Проверяем поддержку кодеков на стороне оператора, настраиваем keepalive и резервные SIP-серверы. После настройки регистрация держится месяцами.

Контракт с оператором уже есть, менять номера — не вариант. Подключаем к Битрикс24 через SIP-коннектор. Для стабильной работы нужен канал: минимум 100 кбит/с на линию для G.729, 87 кбит/с для G.711a.

Типичные задачи:

• Городские номера от любого оператора — сохраняются при переходе на Б24
• Номера 8-800 для входящих — маршрутизация через CRM
• Многоканальные номера с распределением по отделам через IVR
• Аналоговые линии через VoIP-шлюзы Grandstream или Linksys

Где обычно стопорится:

• Порты SIP/RTP закрыты на уровне провайдера или роутера
• NAT не пробрасывается корректно — односторонняя слышимость
• Разные кодеки на стороне АТС и Битрикса — нет звука вообще

Мы решаем эти проблемы за 1–3 дня, а не неделями.

Пошаговая инструкция подключения через SIP-транк:

1. Проверяем открытость портов SIP (5060/5061) и RTP (10000–20000) на фаерволе.
2. Согласовываем кодеки: G.711 или G.729 — тестируем оба варианта.
3. Настраиваем SIP-коннектор в админке Битрикс24: логин, пароль, домен/IP провайдера.
4. Включаем keepalive (период 30–60 секунд) для стабильной регистрации.
5. Проверяем двухстороннюю слышимость тестовым звонком.
6. Настраиваем резервный SIP-сервер на случай сбоя основного.

Облачная АТС или SIP-транк: что выбрать?

Облачная ВАТС не требует железа — подключается за 1–2 дня. SIP-транк сохраняет ваши номера и позволяет гибридную схему с on-premise АТС. Облачная АТС настраивается в 2-3 раза быстрее и экономит до 40% бюджета по сравнению с содержанием собственной инфраструктуры. Сравните провайдеров по реальным кейсам.

Зачем нужна запись звонков и как её настроить?

Все входящие и исходящие пишутся автоматически. Хранение — облако Битрикс24 (ограничение по тарифу) или собственный сервер через модуль voximplant. Каждая запись привязана к карточке в CRM: контакт, сделка, лид. Прослушивание — из таймлайна сделки.

Инструменты контроля:

• Уведомление о записи — обязательно по 152-ФЗ, настраивается в IVR
• AI-транскрибация — распознавание речи через встроенный модуль CoPilot или внешний сервис. Переводит звонок в текст, можно искать по ключевым словам
• Анализ тональности — система помечает звонки с негативом. Не замена прослушиванию, но фильтрует 90% рутины
• Выборочная запись — только входящие, только конкретные отделы
• Автоматический контроль длительности — звонки короче 15 секунд почти всегда означают проблему: сбросили, не дозвонились, менеджер не поднял

Руководитель видит сводные отчёты: количество звонков по менеджерам, средняя длительность, пропущенные без перезвона. Последний пункт — самый болезненный: пропущенный звонок без задачи на перезвон = потерянный клиент.

Типичные ошибки в маршрутизации

Маршрутизация — самая хрупкая часть. Настроили «по очереди», а менеджер залогинился и ушёл обедать — звонок висит 40 секунд и сбрасывается. Или IVR с пятью уровнями вложенности — клиент бросает трубку на третьем. Мы используем рабочие сценарии распределения:

• По ответственному из CRM — номер найден в базе, звонок летит напрямую менеджеру
• По очереди — равномерная нагрузка между операторами со статусом «На линии»
• По отделам через IVR — голосовое меню, максимум два уровня. Больше — потеря звонков
• По времени — рабочее/нерабочее время, выходные
• По региону — определение по коду номера, распределение на локальных менеджеров

При входящем звонке система выполняет: Номер найден в CRM:

• Маршрутизация на ответственного менеджера
• Всплывающая карточка: имя, компания, открытые сделки, история обращений
• Если менеджер не отвечает за 15 секунд — переадресация на коллегу, потом на руководителя

Номер не найден:

• Автоматически создаётся лид в CRM (настройка Телефония → CRM-интеграция → Создавать лид при неизвестном номере)
• Звонок распределяется по очереди
• Вся информация фиксируется для последующей обработки

Интеграция с CRM: как автоматизировать работу?

Всплывающая карточка при входящем звонке показывает:

• Имя, компания, должность
• Текущие сделки со статусами
• Последние 5 обращений — звонки, письма, чаты
• Комментарии по клиенту
• Кнопки: «Создать сделку», «Поставить задачу», «Перевести звонок»

Автоматизация через бизнес-процессы настраивается в разделе «CRM → Роботы и триггеры»:

• Пропущенный звонок → лид + задача на перезвон ответственному
• Завершение разговора → запись активности в таймлайн сделки
• Пропущенный без перезвона в течение 30 минут → уведомление руководителю
• Входящий от клиента с просроченной сделкой → эскалация

Аналитика доступна в разделе «Телефония → Баланс и статистика» и отчётах CRM:

• Количество звонков по менеджерам, отделам, направлениям
• Средняя длительность и время ожидания на линии
• Процент пропущенных с трендом за неделю
• Конверсия звонков в сделки — самая важная метрика для коммерческого отдела

Callback, автообзвон и голосовое меню: как увеличить конверсию?

Виджет «Перезвоните мне» на сайте — одно поле (телефон), ничего лишнего. Система дозванивает менеджеру, потом клиенту. Каждый запрос — автоматический лид в CRM. Антиспам: ограничение запросов с одного номера. A/B-тестирование расположения — виджет справа внизу конвертит лучше, чем слева, но зависит от дизайна. Callback снижает потерю звонков до 30% по сравнению с ручным набором.

Автообзвон:

• Обзвон по сегменту из CRM — менеджер подключается после ответа клиента
• Роботизированный обзвон с голосовым сообщением — подтверждение заказов, напоминания о записи
• IVR-сценарии: «нажмите 1 для подтверждения»
• Расписание с учётом часовых поясов — модуль проверяет регион по коду номера

Построение голосового меню:

• Приветственное сообщение — название компании, уведомление о записи
• Выбор отдела через DTMF — максимум 4–5 пунктов
• Очередь ожидания с музыкой и позицией в очереди
• Нерабочее время — голосовая почта или информационное сообщение

Запись профессиональным диктором — имеет смысл для приветствия и основного меню. Глубже — синтез речи, проще обновлять.

Что входит в настройку телефонии?

Deliverables после завершения проекта:

• Настроенная SIP-регистрация (облачная АТС или SIP-транк под ключ)
• Работающая маршрутизация звонков (по CRM, очереди, IVR)
• Запись звонков с хранением в облаке или на сервере
• Интеграция с CRM: всплывающие карточки, автосоздание лидов, бизнес-процессы
• Виджет обратного звонка на сайте
• Голосовое меню (IVR) с записью диктора или синтезом
• Документация по настройкам и обучение сотрудников (2 сессии)
• Техническая поддержка в течение месяца после запуска

Всё включено в комплексную настройку — без скрытых доплат. Закажите настройку телефонии и получите готовую инфраструктуру для работы с клиентами.

Сроки и стоимость настройки

Стоимость рассчитывается индивидуально — зависит от количества номеров, сложности маршрутизации и необходимых интеграций. Средний бюджет на настройку — от нескольких тысяч до десятков тысяч рублей в зависимости от объёма. Оценим ваш проект за 1 день. Начинаем с бесплатного аудита текущей инфраструктуры — часто находим слепые зоны: пропущенные без задач, менеджеры со статусом «На линии» и нулём звонков, IVR-ветки, в которые никто не попадает. Свяжитесь с нами для консультации — мы предложим оптимальное решение под ваш бюджет и бизнес-процессы.