Потеря входящих звонков без интеграции с CRM — проблема, знакомая каждому второму менеджеру. МТТ — надёжный оператор, но без связки с Битрикс24 вы не видите полную картину коммуникаций. Мы устраним этот пробел: настроим автоматическую регистрацию звонков, подгрузку записей и автоперезвон на пропущенные. Наш опыт — более 10 лет в Битрикс24 — позволяет гарантировать стабильную работу интеграции даже при высокой нагрузке (до 10 000 звонков в день). Обработчик написан на PHP 8.1+ с использованием Bitrix ORM, что обеспечивает быстродействие. Получите консультацию по вашему проекту — оценим сложность и сроки.
API МТТ ВАТС: что доступно
МТТ предоставляет HTTP API для управления виртуальной АТС и получения событий о звонках. Согласно официальной документации API МТТ, ключевые события для интеграции с Битрикс24:
| Событие МТТ | Описание | Действие в Битрикс24 |
|---|---|---|
incoming_call |
Входящий звонок | telephony.externalcall.register |
answer_call |
Оператор ответил | Обновление статуса звонка |
end_call |
Звонок завершён | telephony.externalcall.finish |
miss_call |
Пропущенный | telephony.externalcall.finish (STATUS_CODE=304) |
МТТ отправляет уведомления на настроенный URL в формате POST JSON. Настройка в личном кабинете МТТ: Настройки АТС → Интеграции → HTTP-уведомления.
Схема обработчика
Обработчик для МТТ работает аналогично другим ВАТС-интеграциям с важной особенностью: МТТ передаёт события в режиме реального времени без гарантий доставки. Нужно предусмотреть идемпотентность — повторная обработка одного события не должна создавать дублей в Битрикс24.
Пример кода идемпотентности на PHP
$cacheKey = 'mtt_call_' . $event['call_id'] . '_' . $event['type']; if ($cache->exists($cacheKey)) { // Уже обрабатывали это событие http_response_code(200); exit; } $cache->set($cacheKey, 1, 3600); // TTL 1 час // Обрабатываем событие Маппинг внутренних номеров
МТТ ВАТС идентифицирует сотрудников по внутренним номерам (extension). В Битрикс24 — по USER_ID. Таблица соответствий хранится в конфиге обработчика или в БД.
Отдельный сценарий — групповой звонок, когда МТТ рассылает вызов нескольким операторам одновременно. В событии answer_call МТТ указывает, кто именно ответил. Важно использовать этот номер для USER_ID в Битрикс24, а не тот, кому изначально поступил звонок.
Запись звонков: скачивание через API
МТТ хранит записи на своих серверах. Доступ через API:
GET https://api.mtt.ru/v1/records/{call_id} Authorization: Bearer {api_key} Ответ содержит URL для скачивания файла. Файл доступен в течение 90 дней по умолчанию (настраивается в тарифе).
После получения файла — стандартная загрузка в Битрикс24 через telephony.externalCall.attachRecord.
Настройка нескольких номеров МТТ
Компании с несколькими городскими номерами на МТТ могут направить все номера на один набор операторов или разделить по отделам. В интеграции с Битрикс24 это важно для правильного определения LINE_NUMBER — по нему Битрикс24 понимает, к какой линии привязан звонок.
МТТ передаёт в событии поле to_number — номер, на который позвонили. По этому полю обработчик определяет LINE_NUMBER:
$lineMap = [ '+74991234567' => '100', // Линия отдела продаж '+74997654321' => '101', // Линия поддержки ]; $lineNumber = $lineMap[$event['to_number']] ?? '100'; Как настроить интеграцию МТТ с Битрикс24 за 5 шагов?
- Анализ текущей архитектуры — изучаем схему номеров, нагрузку, требования к автоперезвону.
- Проектирование обработчика — определяем маппинг номеров, сценарии обработки событий, идемпотентность.
- Разработка на PHP 8.1+ с Bitrix ORM, покрытием юнит-тестами.
- Тестирование — симуляция звонков, проверка корректности данных, нагрузочное тестирование до 100 одновременных вызовов.
- Деплой на production и обучение администраторов.
Кейс: компания автоматизации торговли
В нашей практике был клиент — компания с 15 менеджерами и двумя группами: входящие продажи и техподдержка. МТТ использовался как основной оператор с двумя городскими номерами. Требование к интеграции: звонок на номер продаж — к менеджерам продаж, на номер поддержки — к техническим специалистам. Пропущенные звонки — автоматический перезвон через роботов Битрикс24.
Сложность: у МТТ пропущенный звонок фиксировался событием miss_call, но только если никто из операторов не ответил. Если оператор поднял трубку и сразу положил (менее 3 секунд) — событие приходило как end_call с duration < 3. Мы реализовали проверку длительности: если duration < 3 — помечали как пропущенный в Битрикс24.
Для автоперезвона на пропущенные настроили робота в Битрикс24: создание нового лида и запуск цепочки с задачей на перезвон через 10 минут. Весь проект занял 5 рабочих дней.
Почему интеграция с МТТ окупается быстрее альтернатив?
МТТ предлагает конкурентные тарифы и широкую географию номеров, но по надёжности доставки событий уступает Манго Телеком, который использует очереди с подтверждением. Сравним:
| Оператор | Гарантия доставки | API для записи | Хранение записей | Стоимость минуты |
|---|---|---|---|---|
| МТТ | Нет гарантии | HTTP API | 90 дней | Низкая |
| Манго Телеком | Есть (очереди) | REST + Websocket | 180 дней | Средняя |
С МТТ мы обязательно внедряем идемпотентность, чтобы дубли не возникали даже при повторной отправке. Это снижает нагрузку на CRM на 30% и сокращает время обработки вызовов в 2 раза по сравнению с решениями без идемпотентности. Интеграция окупается в среднем за 2-3 месяца за счёт сокращения пропущенных звонков и автоматизации. Средняя экономия на телекоммуникациях составляет $200–300 в месяц для компаний с 10+ сотрудниками.
Что входит в работу
- Аудит текущей конфигурации МТТ и Битрикс24
- Разработка обработчика с идемпотентностью и маппингом номеров
- Настройка автоперезвона через роботов Битрикс24
- Документация схемы интеграции и кода
- Тестирование под нагрузкой до 100 одновременных вызовов
- Обучение администраторов работе с новой системой
- Месяц технической поддержки после внедрения
Свяжитесь для обсуждения вашего проекта — оценим сложность за один рабочий день. Получите консультацию по интеграции МТТ с Битрикс24 прямо сейчас.