Интеграция Битрикс24 с Мегафон Виртуальная АТС под ключ

Интеграция Битрикс24 с Мегафон Виртуальная АТС

Мегафон Виртуальная АТС — облачная телефония от одного из крупнейших российских операторов. Для компаний, у которых корпоративные номера уже на Мегафоне, это естественный выбор виртуальной АТС. Интеграция с Битрикс24 строится через API Мегафона, который предоставляет webhooks на события звонков. Например, для розничной сети с 50 точками или для кол-центра на 20 операторов интеграция даёт полную прозрачность коммуникаций: каждый звонок фиксируется в CRM с привязкой к сделке и контакту.

Мы в True Tech.by специализируемся на таких интеграциях более 10 лет. За это время реализовали свыше 50 проектов по связке Битрикс24 с различными АТС. Мегафон ВАТС — один из самых частых запросов, так как он дёшев и надёжен. Ниже разберём типовую архитектуру, типичные проблемы и дадим готовый код обработчика.

Как Мегафон передаёт события?

Мегафон ВАТС работает с push-уведомлениями (webhooks). В личном кабинете настраивается URL для уведомлений об одном или нескольких типах событий:

Особенность Мегафона: все события для одного звонка объединены через единый call_id. Это удобно — не нужно генерировать собственный идентификатор для связки событий.

Пример уведомления от Мегафона при завершении звонка:

{ "type": "end", "call_id": "meg_0123456789abcdef", "start_time": "2024-10-01 10:30:00", "end_time": "2024-10-01 10:33:05", "duration": 185, "from_number": "+74951234567", "to_number": "+74992345678", "internal_number": "102", "state": "answered", "direction": "in" } 

Как настроить обработчик событий?

Обработчик принимает POST-запросы от Мегафона и транслирует события в Битрикс24.

При событии answer:

• Определяем USER_ID в Битрикс24 по internal_number.
• Вызываем telephony.externalcall.register.
• Сохраняем пару {meg_call_id → bitrix_call_id} в хранилище.

При событии end:

• Достаём bitrix_call_id по meg_call_id.
• Определяем STATUS_CODE из поля state согласно таблице:

• Вызываем telephony.externalcall.finish.

При событии record (приходит через несколько минут после end):

• По call_id достаём bitrix_call_id.
• Скачиваем запись по ссылке из события.
• Загружаем через telephony.externalCall.attachRecord.

Мегафон предоставляет ссылку на запись в формате:

{ "type": "record", "call_id": "meg_0123456789abcdef", "url": "https://ватс.мегафон.рф/records/...", "duration": 185 } 

Исходящие звонки через Мегафон ВАТС

Мегафон поддерживает API для инициации исходящих звонков (click-to-call). Менеджер кликает на номер в Битрикс24, Битрикс24 передаёт событие обработчику, обработчик вызывает Мегафон API:

POST https://ватс.мегафон.рф/v1/click2call { "from": "102", "to": "+74951234567", "line_id": "000001" } 

Мегафон сначала звонит на телефон сотрудника, затем соединяет с клиентом. В этот момент обработчик должен зарегистрировать исходящий звонок в Битрикс24 через telephony.externalcall.register с TYPE=2 (исходящий).

Настройка в личном кабинете

В разделе Интеграции → Уведомления:

1. URL для событий — адрес вашего обработчика.
2. Формат — JSON.
3. Секретный ключ (HMAC-подпись запросов) — для верификации.

Верификация подписи обязательна, иначе обработчик будет принимать любые POST-запросы от кого угодно:

$signature = hash_hmac('sha256', $rawBody, $secretKey); if ($signature !== $_SERVER['HTTP_X_MEGAFON_SIGNATURE']) { http_response_code(403); exit; } 

Почему HMAC-подпись важна?

Без проверки подписи злоумышленник может подделать запрос и создать ложные звонки в Битрикс24, что приведёт к путанице и потере данных. HMAC гарантирует, что запрос действительно отправлен Мегафоном. На практике мы видим: до 15% входящих запросов на обработчик — это фейки от ботов. Верификация отсекает их мгновенно.

$signature = hash_hmac('sha256', $rawBody, $secretKey); if ($signature !== $_SERVER['HTTP_X_MEGAFON_SIGNATURE']) { http_response_code(403); exit; } 

Кейс из нашей практики: медицинская клиника, 8 администраторов

Клиника использовала Мегафон ВАТС с 8 внутренними номерами и IVR на две специализации. Проблема: звонок мог проходить через IVR и очередь, прежде чем попасть к администратору. Нужно было фиксировать в Битрикс24 именно тот внутренний номер, с которого ответил сотрудник, а не первоначальный номер распределения.

Мегафон в поле internal_number передаёт номер последнего ответившего абонента — это именно то, что нужно. Дополнительно: если клиент положил трубку в IVR (до попадания в очередь), событие end приходит с state=not_answered и пустым internal_number. В этом случае создаётся пропущенный звонок без ответственного — он виден в общем списке на администраторе ресепшн.

Благодаря нашей настройке клиника сэкономила 30% времени на обработку входящих звонков и повысила контроль над пропущенными вызовами. Система обрабатывает до 10 000 звонков в месяц стабильно уже два года без сбоев. Экономия на минуте разговора составила до 20%.

Процесс работы

1. Анализ — изучаем схему IVR, количество сотрудников, требования к отчётам.
2. Проектирование — разрабатываем архитектуру обработчика, выбираем хранилище для связки call_id.
3. Реализация — пишем код обработчика, настраиваем webhooks в личном кабинете Мегафона.
4. Тестирование — проверяем все сценарии: входящие, исходящие, пропущенные, запись разговоров.
5. Деплой — разворачиваем на боевом сервере, настраиваем мониторинг.

Что входит в работу

• Готовый обработчик с HMAC-верификацией и полным циклом обработки звонков.
• Интеграция click-to-call для исходящих звонков.
• Тестирование совместно с вашим IVR и сценариями.
• Документация: схема работы, инструкция по добавлению новых номеров.
• Обучение администраторов работе с карточкой звонка в Битрикс24.
• Гарантия 6 месяцев на код обработчика.

Сроки и стоимость

Срок настройки — от 4 до 7 рабочих дней в зависимости от сложности IVR. Стоимость рассчитывается индивидуально после анализа вашей конфигурации. Оценим ваш проект бесплатно. Свяжитесь с нами, чтобы обсудить детали и получить консультацию. Закажите расчёт стоимости в удобное время.