Интеграция Битрикс24 с телефонией Билайн Бизнес
Билайн Бизнес предоставляет корпоративную телефонию в двух форматах: SIM-карты с корпоративными номерами и виртуальная АТС (Виртуальный офис Билайн). Интеграция с Битрикс24 строится по-разному для этих двух случаев — важно разобраться, какой именно продукт Билайн использует компания.
Виртуальный офис Билайн: API и webhooks
«Виртуальный офис» — облачная ВАТС Билайн с веб-интерфейсом управления. API для интеграций доступен через партнёрскую программу Билайн или по запросу в техподдержку корпоративного обслуживания.
Билайн предоставляет webhooks на события звонков. Настройка в личном кабинете Виртуального офиса: раздел Настройки → Интеграции → API. Поддерживаемые события:
| Событие | Триггер |
|---|---|
call.start |
Входящий вызов зарегистрирован |
call.answer |
Сотрудник ответил |
call.end |
Разговор завершён |
call.record_ready |
Запись готова к скачиванию |
Авторизация webhook-запросов: Билайн добавляет заголовок X-Beeline-Signature с HMAC-SHA256 подписью тела запроса. Секрет задаётся при настройке интеграции.
Корпоративные SIM с переадресацией в Битрикс24
Если компания использует корпоративные мобильные номера Билайн без ВАТС, интеграция с Битрикс24 строится иначе. Здесь нет событий в реальном времени — мобильные звонки Битрикс24 напрямую не видит.
Варианты решения:
- Переход на Виртуальный офис Билайн — мобильные номера становятся внутренними в ВАТС, интеграция через API.
- SIM-коннекторы (GSM-шлюзы) — аппаратные устройства, которые берут SIM-карту и регистрируют её как SIP-аккаунт. Через SIP-транк подключаются к Битрикс24 напрямую или через промежуточную АТС.
- Облачные SIM-коннекторы — сервисы вроде SimCom, которые виртуализируют мобильные SIM и предоставляют SIP-интерфейс.
Настройка через официальный Bitrix24 + Билайн коннектор
Билайн и Битрикс24 имеют официальное партнёрство. На стороне Битрикс24 в разделе «Телефония» доступно подключение через «Приложение телефонии». Процесс:
- В Битрикс24: Телефония → Подключить телефонию → Выбрать приложение Билайн Бизнес.
- Авторизация через корпоративный аккаунт Билайн.
- Маппинг внутренних номеров Билайн на пользователей Битрикс24.
После подключения звонки Билайн ВАТС начинают отображаться в Битрикс24 через стандартные механизмы телефонии платформы.
Работа с записями и аналитикой
Билайн ВАТС сохраняет записи в облаке. При событии call.record_ready приходит ссылка для скачивания. Срок хранения зависит от тарифа (от 7 дней до 1 года). Для загрузки в Битрикс24 стандартная схема через telephony.externalCall.attachRecord.
Аналитика звонков в Битрикс24 (отчёты по количеству, длительности, пропущенным) строится на данных, которые обработчик передаёт при регистрации звонков. Для корпоративной отчётности Билайн также предоставляет собственный API статистики — можно строить аналитику параллельно в двух системах.
Кейс: торговая сеть, корпоративные номера в 6 городах
Федеральная торговая сеть с офисами продаж в 6 городах. Каждый офис работал на своём номере Билайн ВАТС. Требование: единый Битрикс24 для всех офисов, звонки из каждого города видны только менеджерам этого города.
Архитектура: шесть отдельных аккаунтов Билайн ВАТС, шесть endpoint для webhooks на одном сервере-обработчике. Обработчик определяет офис по URL (или по заголовку источника) и подставляет правильный LINE_NUMBER для Битрикс24. Видимость звонков настраивается через права доступа в CRM Битрикс24 — каждый руководитель офиса видит только свои звонки.
Нестандартное требование: при переводе клиента из одного офиса в другой (клиент купил в Москве, вопрос к Питеру) — звонок должен появиться у питерского менеджера. Реализовали через событие перевода в Билайн ВАТС: при переводе создаётся новый звонок в Битрикс24 с правильным офисом.
Срок настройки: 6-10 рабочих дней (из-за координации с 6 аккаунтами Билайн).