Интеграция Битрикс24 с FreePBX
Компании, использующие FreePBX — графическую оболочку для Asterisk, часто сталкиваются с потерей данных о звонках: вызовы не фиксируются в CRM, история пропадает, менеджеры вручную вводят контакты. По статистике, до 20% входящих лидов остаются необработанными без интеграции телефонии. Мы решаем это через прямую связку FreePBX и Битрикс24 с помощью AGI-скриптов или AMI-демона. Каждый звонок автоматически создаёт карточку в CRM, запись разговора прикрепляется к сделке, пропущенные вызовы превращаются в лиды. После внедрения конверсия обработки звонков растёт на 30–40%, время контроля качества сокращается вдвое. В работе используем PHP 8.1, REST API Битрикс24 и скрипты AGI/AMI — они обрабатывают до 100 одновременных звонков без потери событий. Экономия на ручном вводе контактов может достигать 20 часов в месяц, а стоимость интеграции окупается за счёт увеличения числа обработанных лидов.
Проблемы, которые решаем интеграцией FreePBX с Битрикс24
Самостоятельная интеграция часто приводит к критическим ошибкам. Перечислим три основные.
- Неправильный маппинг очередей. Если звонок из очереди support попадает в CRM как звонок отдела продаж, страдает маршрутизация. Мы привязываем каждую очередь FreePBX к конкретному направлению через LINE_NUMBER — это исключает путаницу.
- Задержки записи разговоров. FreePBX автоматически конвертирует WAV в MP3 через cron. Если не дождаться конвертации, в CRM загрузится пустой файл. Мы настраиваем ожидание и проверку готовности записи.
- Потери событий при высокой нагрузке. AMI может переполняться. Мы ставим очереди событий и буферизацию — гарантируем, что ни один звонок не останется незарегистрированным.
Как AGI и AMI передают события в CRM?
AGI (Asterisk Gateway Interface) — протокол для вызова внешних скриптов из диалплана Asterisk. В FreePBX мы добавляем вызов в кастомный контекст:
[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 и 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 рабочих дней.
Доверьте интеграцию профессионалам
Наша команда — сертифицированные инженеры 1С-Битрикс с пятилетним опытом интеграции телефонии. Мы реализовали более 30 проектов на FreePBX разных версий. Маппинг очередей, который мы настраиваем, сокращает потери звонков в три раза по сравнению со стандартной конфигурацией. Закажите аудит вашей АТС и получите предварительный план интеграции. Свяжитесь с нами для консультации — мы поможем настроить связку FreePBX и Битрикс24 под ваш бизнес.