Інтеграція Бітрікс24 з телефонією Білайн Бізнес
Ми постійно бачимо, як компанії втрачають дані дзвінків через відсутність інтеграції. Корпоративна телефонія Білайн Бізнес працює або через віртуальну АТС (Віртуальний офіс), або через прості SIM-карти. Обидва варіанти можна під'єднати до Бітрікс24, але підходи суттєво різняться. За 4 роки ми виконали понад 50 інтеграцій і накопичили готові рішення для кожного сценарію. У цій статті розберемо, як правильно налаштувати з'єднання, щоб не втратити жодного дзвінка та отримати повну аналітику.
Згідно з документацією Бітрікс24, інтеграція із зовнішніми АТС здійснюється через REST-метод telephony.externalCall.register.
Як інтегрувати віртуальний офіс Білайн з Бітрікс24?
Віртуальний офіс (хмарна ВАТС) надає API та webhooks для подій дзвінків. Налаштування починається із запиту доступу у техпідтримки Білайн або через партнерську програму. В особистому кабінеті ВАТС у розділі Налаштування → Інтеграції → API вказуємо URL вашого обробника та секрет для підпису. Білайн надсилає події у форматі JSON з HMAC-SHA256 у заголовку X-Beeline-Signature. Обробник повинен реєструвати дзвінки в Бітрікс24 через REST-метод telephony.externalCall.register.
Таблиця підтримуваних подій:
| Подія | Тригер |
|---|---|
call.start |
Вхідний виклик зареєстровано |
call.answer |
Співробітник відповів |
call.end |
Розмову завершено |
call.record_ready |
Запис готовий до завантаження |
Після реєстрації викликаємо telephony.externalCall.attachRecord для прикріплення аудіо. Термін зберігання запису в хмарі Білайн — від 7 днів до року, залежить від тарифу.
Як налаштувати обробник подій?
- Створіть скрипт на PHP, який приймає POST-запити від Білайн.
- Перевірте HMAC-підпис у заголовку
X-Beeline-Signature. - Розберіть JSON та зареєструйте дзвінок через
telephony.externalCall.register. - За подією
call.record_readyзавантажте запис і прикріпіть його черезtelephony.externalCall.attachRecord. - Налаштуйте логування помилок та моніторинг.
Що робити, якщо використовуються корпоративні SIM без ВАТС?
Без віртуальної АТС події дзвінків недоступні безпосередньо. Є три рішення:
- Перехід на Віртуальний офіс — мобільні номери стають внутрішніми, інтеграція через API.
- GSM-шлюз — апаратний конвертер SIM у SIP, підключається до будь-якої АТС, у тому числі до Бітрікс24 напряму.
- Хмарні SIM-конектори — сервіси (SimCom та ін.) віртуалізують SIM та надають SIP-інтерфейс.
Другий варіант зазвичай дешевший: вартість шлюзу — від 5 000 до 15 000 грн одноразово, тоді як перехід на ВАТС може коштувати 20 000+ грн на місяць. Однак ВАТС забезпечує в 2-3 рази швидшу обробку даних дзвінків завдяки прямому API.
Налаштування через офіційний додаток Білайн у Бітрікс24
Білайн та Бітрікс24 — партнери. У розділі «Телефонія» Бітрікс24 обираємо «Підключити телефонію» → додаток «Білайн Бізнес». Авторизуємося корпоративним акаунтом, зіставляємо внутрішні номери з користувачами. Цей спосіб підходить для компаній, які вже використовують Віртуальний офіс.
Порівняння API-інтеграції та додатку
| Параметр | API через webhooks | Додаток Білайн |
|---|---|---|
| Гнучкість | Повний контроль над обробником | Обмежено налаштуваннями додатку |
| Швидкість впровадження | 2–5 днів на розробку | 1 день |
| Підтримка нестандартних сценаріїв | Так | Ні |
| Залежність від партнерського доступу | Так | Ні |
| Продуктивність | Обробка до 1000 дзвінків/хв | До 100 дзвінків/хв |
Ми рекомендуємо API-інтеграцію, якщо потрібна складна маршрутизація або аналітика на стороні Бітрікс24. API-рішення у 2-3 рази швидше обробляє великі обсяги порівняно з додатком.
Типові помилки при інтеграції
- Неправильний HMAC-підпис: перевірте секрет та алгоритм (SHA256).
- Діапазон IP-адрес Білайн: додайте їх до білого списку сервера.
- Таймаути: обробник повинен відповідати протягом 5 секунд, інакше Білайн повторює запит.
- Втрата подій: налаштуйте чергу на Redis або RabbitMQ.
Що входить в роботу
В рамках інтеграції ми виконуємо повний цикл робіт: від аудиту поточної схеми до передачі в експлуатацію. Ось що конкретно входить:
- Документування схеми дзвінків та розподілу номерів.
- Налаштування обробника подій на вашому сервері (PHP, можна на базі нашого модуля).
- Мапінг номерів на користувачів Бітрікс24.
- Тестування всіх сценаріїв: вхідний, вихідний, переклад, запис.
- Навчання адміністраторів та відповіді на питання протягом тижня після здачі.
- Пост-релізна підтримка та доробки за зауваженнями.
Після завершення ви отримуєте інструкцію з обслуговування та схему обробки помилок.
З нашої практики: торговий холдинг у 6 містах
Федеральна торгова мережа — наш клієнт — мала офіси в 6 містах, кожен зі своїм акаунтом Білайн ВАТС. Кожен офіс обробляв понад 200 дзвінків на день. Вимагалося бачити дзвінки в одному Бітрікс24, але менеджери кожного міста — лише свої. Ми побудували архітектуру: шість вебхуків на одному сервері, обробник визначає місто за URL та підставляє правильний LINE_NUMBER. Права доступу налаштували через CRM. Нестандартне завдання: при перекладі клієнта з Москви до Санкт-Петербурга дзвінок мав потрапити пітерському менеджеру. Вирішили через подію перекладу у ВАТС — обробник створював новий дзвінок з вірним офісом. Результат: пропущені дзвінки знизилися на 30%, економія на обробці вхідних склала до 40% на місяць. Термін виконання — 8 робочих днів, включаючи узгодження з Білайн по кожному акаунту.
Зв'яжіться з нами для безкоштовної оцінки вашого сценарію. Отримайте консультацію інженера з інтеграції.
Терміни та як замовити
Термін інтеграції одного офісу — від 3 до 7 днів. Для складних схем (як у кейсі) — до 10 робочих днів. Вартість — від 15 000 до 30 000 грн залежно від складності. Оцінимо ваш сценарій безкоштовно — зв'яжіться з нами. Працюємо офіційно, з гарантією. Отримайте точний розрахунок термінів та вартості для вашого сценарію.
Наш досвід — понад 4 роки (з 2019 року) та 50+ впроваджень телефонії Бітрікс24 штатом сертифікованих інженерів. Використовуємо перевірені підходи.