Інтеграція Бітрікс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% економії часу на обробці дзвінків.

Зв'яжіться з нами для безплатної оцінки проєкту. Замовте інтеграцію та отримайте консультацію наших експертів.