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

Ми в True Tech.by — експерти з інтеграції B24 з АТС. Наші показники: понад 10 років досвіду, 50+ успішних проектів, що підтверджують нашу експертність.

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

Мегафон Віртуальна АТС — хмарна телефонія від одного з найбільших українських операторів. Для компаній, у яких корпоративні номери вже на Мегафоні, це природний вибір віртуальної АТС. Порівняно з локальною АТС, хмарна Мегафон ВАТС дозволяє заощадити до 50% на обслуговуванні та не потребує капітальних витрат. Інтеграція з Бітрікс24 будується через API Мегафона, який надає webhooks на події дзвінків. Наприклад, для роздрібної мережі з 50 точками або для кол-центру на 20 операторів інтеграція дає повну прозорість комунікацій: кожен дзвінок фіксується в CRM із прив'язкою до угоди та контакту.

Ми в True Tech.by спеціалізуємося на таких інтеграціях понад 10 років. За цей час реалізували понад 50 проєктів із зв'язки Бітрікс24 із різними АТС. Мегафон ВАТС — один із найчастіших запитів, оскільки він дешевший за аналоги на 30% та надійний (99.9% uptime). Нижче розберемо типову архітектуру, типові проблеми та надамо готовий код обробника.

Як Мегафон передає події?

Мегафон ВАТС працює з 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. Архітектура базується на асинхронному обміні подіями через REST API з використанням верифікації підпису HMAC-SHA256.

При події 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%, а щомісячна економія — 15 000 грн. За рік це дало економію 180 000 грн."

Завдяки нашому налаштуванню клініка заощадила 30% часу на обробку вхідних дзвінків та підвищила контроль над пропущеними викликами. Система обробляє до 10 000 дзвінків на місяць стабільно вже два роки без збоїв. Економія на хвилині розмови склала до 20%.

Процес роботи

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

Що входить в роботу

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

Терміни та вартість

Термін налаштування — від 4 до 7 робочих днів залежно від складності IVR. Вартість розраховується індивідуально після аналізу вашої конфігурації. Оцінимо ваш проєкт безкоштовно. Зв'яжіться з нами, щоб обговорити деталі та отримати консультацію. Замовте розрахунок вартості у зручний час.