Інтеграція Бітрікс24 з FreePBX
Компанії, які використовують FreePBX — графічну оболонку для Asterisk, часто стикаються з втратою даних про дзвінки: виклики не фіксуються в CRM, історія зникає, менеджери вручну вводять контакти. За даними дослідження HubSpot, до 20% вхідних лідів залишаються необробленими без інтеграції телефонії. Ми вирішуємо це через пряму зв'язку FreePBX і Бітрікс24 за допомогою AGI-скриптів або AMI-демона. Кожен дзвінок автоматично створює картку в CRM, запис розмови прикріплюється до угоди, пропущені виклики перетворюються на ліди. Після впровадження конверсія обробки дзвінків зростає на 30–40%, час контролю якості скорочується вдвічі. У роботі використовуємо PHP 8.1, REST API Бітрікс24 та скрипти AGI/AMI — вони обробляють до 100 одночасних дзвінків без втрати подій. Економія на ручному введенні контактів сягає 20 годин на місяць, що за середньої ставки оператора 200 грн/год становить 4 000 грн на місяць. Вартість базової інтеграції — від 15 000 грн.
Проблеми, які вирішуємо інтеграцією FreePBX з Бітрікс24
Самостійна інтеграція часто призводить до критичних помилок. Перелічимо три основні.
- Неправильний мапінг черг. Якщо дзвінок із черги support потрапляє в CRM як дзвінок відділу продажів, страждає маршрутизація. Ми прив'язуємо кожну чергу FreePBX до конкретного напряму через LINE_NUMBER — це виключає плутанину.
- Затримки запису розмов. FreePBX автоматично конвертує WAV в MP3 через cron. Якщо не дочекатися конвертації, у CRM завантажиться порожній файл. Ми налаштовуємо очікування та перевірку готовності запису.
- Втрати подій при високому навантаженні. AMI може переповнюватися. Ми ставимо черги подій і буферизацію — гарантуємо, що жоден дзвінок не залишиться незареєстрованим.
Як AGI та AMI передають події в CRM?
AGI (Asterisk Gateway Interface) — протокол для виклику зовнішніх скриптів із діалплану Asterisk. У FreePBX ми додаємо виклик у кастомний контекст:
Приклад AGI-скрипту
[from-internal-custom] exten => _.,1,AGI(bitriks24.php,${EXTEN},${CALLERID(num)},${UNIQUEID}) exten => _.,n,Return() Скрипт на PHP 8.1+ приймає три параметри та викликає REST API Бітрікс24: telephony.externalcall.register, telephony.externalcall.finish. Для вхідних дзвінків використовуємо from-trunk-custom. Код покривається unit-тестами на сумісність з FreePBX 14–16. AGI-обробка подій у 5 разів швидша за AMI без буферизації завдяки прямому виклику. Крім того, інтеграція через AGI у 2 рази надійніша за AMI при високому навантаженні — це підтверджено нашими тестами.
Порівняння AGI та AMI
| Характеристика | AGI | AMI |
|---|---|---|
| Протокол | Запуск зовнішнього скрипту | Керування через TCP-сокет |
| Швидкість обробки | Висока (прямий виклик) | Середня (потрібен демон) |
| Складність налаштування | Середня | Висока |
| Підходить для | Одноразові дії (дзвінок) | Моніторинг та керування чергами |
Чому мапінг черг критичний для CRM?
FreePBX дозволяє створити необмежену кількість черг. Ми налаштовуємо AMI-демон, який читає змінну каналу QUEUE_NAME і передає її в CRM. Таблиця відповідності:
| Черга FreePBX | LINE_NUMBER у CRM | Відповідальний відділ |
|---|---|---|
| sales | 200 | Продажі |
| support | 201 | Техпідтримка |
| billing | 202 | Фінанси |
Це дозволяє Бітрікс24 автоматично призначати відповідального та створювати угоди у потрібній воронці.
Кейс: юридична компанія з IVR на 6 відділів
Клієнт використовував FreePBX 15 з багаторівневим IVR. Проблема: при старті дзвінка створювалася картка в CRM, але якщо клієнт вішав трубку під час прослуховування меню, залишався порожній дзвінок — 40% від усіх вхідних. Ми перенесли виклик AGI-скрипту з контексту транку в контекст черги. Тепер telephony.externalcall.register спрацьовує тільки після вибору відділу та потрапляння в чергу. Додатково налаштували тригер: якщо клієнт скинув дзвінок у черзі, створюється лід із позначкою «Очікує дзвінка» — робот Бітрікс24 через 5 хвилин ініціює зворотній виклик. Термін реалізації — 6 робочих днів. Після впровадження конверсія обробки вхідних зросла з 55% до 82% за перший місяць.
Що входить у роботу та орієнтовні терміни
- Аудит конфігурації FreePBX та версії Бітрікс24.
- Проектування схеми мапінгу черг та подій.
- Розробка AGI/AMI-скриптів на PHP 8.1+ з unit-тестами.
- Налаштування запису розмов та конвертації.
- Тестування під навантаженням (до 100 одночасних дзвінків).
- Навчання адміністраторів: як змінювати налаштування черг без переробки інтеграції.
- Гарантія на коректну роботу — 3 місяці.
Процес
- Аналітика — вивчення діалплану, черг та IVR (1–2 дні).
- Проектування — узгодження ТЗ, вибір протоколу, прототип (1–2 дні).
- Реалізація — розробка та налаштування на тестовому контурі (2–3 дні).
- Тестування — навантажувальні тести, граничні випадки (1 день).
- Деплой та навчання — перенесення на продуктив, інструкція (1 день).
Базова інтеграція займає від 3 до 5 робочих днів. Складні кейси з багаторівневим IVR або нестандартним записом — до 10 робочих днів. Налаштування інтеграції Бітрікс24 з FreePBX під ключ — ми виконаємо всі етапи, а ви отримаєте готове рішення.
Довірте інтеграцію професіоналам
Наша команда — сертифіковані інженери 1С-Бітрікс з п'ятирічним досвідом інтеграції телефонії. Ми реалізували понад 30 проектів на FreePBX різних версій. Мапінг черг, який ми налаштовуємо, скорочує втрати дзвінків утричі порівняно зі стандартною конфігурацією. Пропонуємо інтеграцію під ключ: від аудиту до навчання адміністраторів. Оцінимо ваш проект безкоштовно. Замовте аудит вашої АТС та отримайте попередній план інтеграції. Пишіть нам для консультації — ми допоможемо налаштувати зв'язку FreePBX та Бітрікс24 під ваш бізнес.