Интеграция Битрикс24 с телефонией Билайн Бизнес
Мы постоянно видим, как компании теряют данные звонков, потому что не настроена интеграция. Корпоративная телефония Билайн Бизнес работает либо через виртуальную АТС (Виртуальный офис), либо через простые SIM-карты. Оба варианта можно подключить к Битрикс24, но подходы кардинально разные. За 4 года мы выполнили более 50 интеграций и накопили готовые решения для каждого сценария. В этой статье разберём, как правильно настроить интеграцию, чтобы не потерять ни одного звонка и получить полную аналитику.
Согласно документации Битрикс24, интеграция с внешними АТС осуществляется через REST-метод telephony.externalCall.register.
Как интегрировать виртуальный офис Билайн с Битрикс24?
Виртуальный офис (облачная ВАТС) предоставляет API и webhooks для событий звонков. Настройка начинается с запроса доступа у техподдержки Билайн или через партнёрскую программу. В личном кабинете ВАТС в разделе Настройки → Интеграции → API указываем URL вашего обработчика и секрет для подписи. Билайн отправляет события в формате JSON с HMAC-SHA256 в заголовке X-Beeline-Signature. Обработчик должен регистрировать звонки в Битрикс24 через REST-метод telephony.externalCall.register.
Таблица поддерживаемых событий:
| Событие | Триггер |
|---|---|
call.start |
Входящий вызов зарегистрирован |
call.answer |
Сотрудник ответил |
call.end |
Разговор завершён |
call.record_ready |
Запись готова к скачиванию |
После регистрации вызываем telephony.externalCall.attachRecord для прикрепления аудио. Срок хранения записи в облаке Билайн — от 7 дней до года, зависит от тарифа.
Как настроить обработчик событий?
- Создайте скрипт на PHP, который принимает POST-запросы от Билайн.
- Проверьте HMAC-подпись в заголовке
X-Beeline-Signature. - Разберите JSON и зарегистрируйте звонок через
telephony.externalCall.register. - По событию
call.record_readyскачайте запись и прикрепите её черезtelephony.externalCall.attachRecord. - Настройте логирование ошибок и мониторинг.
Что делать, если используются корпоративные SIM без ВАТС?
Без виртуальной АТС события звонков недоступны напрямую. Есть три решения:
- Переход на Виртуальный офис — мобильные номера становятся внутренними, интеграция через API.
- GSM-шлюз — аппаратный конвертер SIM в SIP, подключается к любой АТС, в том числе к Битрикс24 напрямую.
- Облачные SIM-коннекторы — сервисы (SimCom и др.) виртуализируют SIM и предоставляют SIP-интерфейс.
Второй вариант часто оказывается дешевле полного перехода, но требует обслуживания оборудования.
Настройка через официальное приложение Билайн в Битрикс24
Билайн и Битрикс24 — партнёры. В разделе «Телефония» Битрикс24 выбираем «Подключить телефонию» → приложение «Билайн Бизнес». Авторизуемся корпоративным аккаунтом, сопоставляем внутренние номера с пользователями. Этот способ подходит для компаний, которые уже используют Виртуальный офис.
Сравнение API-интеграции и приложения
| Параметр | API через webhooks | Приложение Билайн |
|---|---|---|
| Гибкость | Полный контроль над обработчиком | Ограничено настройками приложения |
| Скорость внедрения | 2–5 дней на разработку | 1 день |
| Поддержка нестандартных сценариев | Да | Нет |
| Зависимость от партнёрского доступа | Да | Нет |
Мы рекомендуем API-интеграцию, если нужна сложная маршрутизация или аналитика на стороне Битрикс24.
Типичные ошибки при интеграции
- Неправильная HMAC-подпись: проверьте секрет и алгоритм (SHA256).
- Диапазон IP-адресов Билайн: добавьте их в белый список сервера.
- Таймауты: обработчик должен отвечать в течение 5 секунд, иначе Билайн повторяет запрос.
- Утеря событий: настройте очередь на Redis или RabbitMQ.
Что входит в работу
В рамках интеграции мы выполняем полный цикл работ: от аудита текущей схемы до передачи в эксплуатацию. Вот что конкретно входит:
- Документирование схемы звонков и распределения номеров.
- Настройка обработчика событий на вашем сервере (PHP, можно на базе нашего модуля).
- Маппинг номеров на пользователей Битрикс24.
- Тестирование всех сценариев: входящий, исходящий, перевод, запись.
- Обучение администраторов и ответы на вопросы в течение недели после сдачи.
- Пост-релизная поддержка и доработки по замечаниям.
По окончании вы получаете инструкцию по обслуживанию и схему обработки ошибок.
Из нашей практики: торговый холдинг в 6 городах
Федеральная торговая сеть — наш клиент — имела офисы в 6 городах, каждый со своим аккаунтом Билайн ВАТС. Каждый офис обрабатывал более 200 звонков в день. Требовалось видеть звонки в одном Битрикс24, но менеджеры каждого города — только свои. Мы построили архитектуру: шесть вебхуков на одном сервере, обработчик определяет город по URL и подставляет правильный LINE_NUMBER. Права доступа настроили через CRM. Нестандартная задача: при переводе клиента из Москвы в Санкт-Петербург звонок должен был попасть питерскому менеджеру. Решили через событие перевода в ВАТС — обработчик создавал новый звонок с верным офисом. Результат: пропущенные звонки снизились на 30%, экономия на обработке входящих составила до 40% в месяц. Срок выполнения — 8 рабочих дней, включая согласование с Билайн по каждому аккаунту.
Свяжитесь с нами для бесплатной оценки вашего сценария. Получите консультацию инженера по интеграции.
Сроки и как заказать
Срок интеграции одного офиса — от 3 до 7 дней. Для сложных схем (как в кейсе) — до 10 рабочих дней. Оценим ваш сценарий бесплатно — свяжитесь с нами. Работаем официально, с гарантией. Получите точный расчёт сроков для вашего сценария.
Наш опыт — более 4 лет и 50+ внедрений телефонии Битрикс24. Используем сертифицированные подходы.