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

Входящий звонок от клиента — и менеджер тратит до двух минут на ручную регистрацию. Карточка контакта не находится, запись разговора теряется, сделка не привязывается. Это проблема, с которой сталкиваются компании, использующие только базовый функционал телефонии. Интеграция Битрикс24 с Ростелеком Виртуальная АТС автоматизирует обработку звонков: входящие и исходящие вызовы фиксируются в CRM, записи сохраняются, click-to-call работает без задержек. Мы выполнили десятки таких проектов — от небольших фирм до государственных учреждений. Сроки выполнения — от 5 до 7 рабочих дней, с гарантией 12 месяцев. Наши инженеры сертифицированы и знают тонкости API Ростелекома. Неправильная проверка подписи webhook'ов или неверный маппинг extension'ов — частые ошибки, которые мы исключаем на этапе проектирования. Свяжитесь с нами для предварительной оценки вашей схемы звонков.

Как настроить интеграцию Битрикс24 с Ростелеком ВАТС за 5 дней?

Ростелеком ВАТС — продукт крупнейшего российского оператора. Для компаний с государственным или корпоративным уклоном сопряжение виртуальной АТС с Битрикс24 — стандартный запрос при внедрении CRM. Весь процесс занимает от 5 рабочих дней. Наши сертифицированные инженеры выполняют интеграцию под ключ с гарантией 12 месяцев.

Проверка подписи webhook'ов

Входящие веб-хуки от Ростелекома подписываются X-Signature. Ключ для проверки подписи находится в личном кабинете ВАТС (раздел Настройки → Интеграции → Веб-хуки).

$expectedSig = hash_hmac('sha256', $rawBody, $webhookKey); if (!hash_equals($expectedSig, $request->header('X-Signature'))) { abort(403); } 

Структура события от Ростелекома:

{ "event": "end", "call_uuid": "rt-abc123def456", "call_direction": "inbound", "caller_id": "+74951234567", "called_number": "+74997654321", "extension": "103", "call_start": "2024-01-15T10:30:00+03:00", "call_answer": "2024-01-15T10:30:15+03:00", "call_end": "2024-01-15T10:33:05+03:00", "duration_full": 185, "duration_talk": 170, "record_id": "record-uuid-12345" } 

Различие duration_full и duration_talk

В Битрикс24 для аналитики нужна фактическая длительность разговора. duration_full включает время ожидания в очереди или IVR, а duration_talk — только разговор. В вызов telephony.externalcall.finish мы передаём именно duration_talk. Это даёт точную статистику для отчётов.

Как получить и сохранить записи разговоров?

Ростелеком хранит записи 90 дней. По record_id из события end запрашиваем файл:

GET https://api.vats.rt.ru/v2/records/{record_id} Authorization: Bearer {access_token} 

Ответ — прямая ссылка на аудиофайл, действительная 1 час. Мы скачиваем файл сразу и загружаем в корпоративное S3-хранилище. В Битрикс24 прикрепляем постоянную ссылку. Это гарантирует доступность записи даже после удаления у провайдера.

Организация исходящих звонков (click-to-call)

Click-to-call через API Ростелекома:

POST https://api.vats.rt.ru/v2/calls/originate Authorization: Bearer {access_token} { "from_extension": "103", "to_number": "+74951234567" } 

Ростелеком перезванивает на телефон сотрудника, затем соединяет с клиентом. Ответ содержит call_uuid для отслеживания. Наши специалисты настраивают эту функцию за 1 день.

Обработка переводов звонков

При переводе звонка (attended или blind) Ростелеком присылает событие transfer. Оно содержит исходный call_uuid и новый extension. Проблема: в Битрикс24 активный звонок привязан к одному USER_ID. Мы реализуем логику завершения исходного звонка и создания нового, или используем кастомное поле «Цепочка переводов». Второй вариант удобнее для истории.

Кейс: государственное учреждение

Наш клиент — региональное госучреждение с номерами Ростелеком. Требование регулятора — хранить записи всех звонков 3 года (Ростелеком хранит 90 дней). Мы реализовали скачивание всех записей в MinIO (корпоративное S3) при каждом событии end. В Битрикс24 прикрепляется постоянная ссылка. Срок реализации — 5–7 рабочих дней. Бюджет проекта определяется сложностью и объёмом работ.

Что входит в работу под ключ?

1. Аудит текущей телефонии и схемы звонков — анализируем существующую инфраструктуру, выявляем узкие места.
2. Настройка webhook'ов и проверки подписи — регистрируем эндпоинты в Ростелекоме, реализуем проверку X-Signature.
3. Разработка кастомного обработчика событий — на PHP с использованием API Битрикс24 (telephony.externalcall.*).
4. Организация хранения записей — скачивание аудиофайлов в S3-совместимое хранилище (MinIO, Amazon S3).
5. Настройка click-to-call и обработка переводов — исходящие звонки через API originate, логика attended/blind transfer.
6. Тестирование всех сценариев — входящие, исходящие, внутренние звонки, переводы, запись.
7. Обучение сотрудников — инструкции и демонстрация работы в Битрикс24.

Преимущества работы с нами

Мы — команда с многолетним опытом в Битрикс24 и более 50 успешных интеграций телефонии. Мы гарантируем стабильную работу связки при пиковых нагрузках. Стоимость интеграции рассчитывается индивидуально после аудита вашей инфраструктуры. Оценим ваш проект бесплатно — просто напишите нам. Результат: до 30% экономии времени на обработке звонков.

Свяжитесь с нами для бесплатной оценки проекта. Закажите интеграцию и получите консультацию наших экспертов.