Интеграция Bitrix24
Интеграция Bitrix24
Bitrix24 — популярная CRM со встроенной телефонией (Voximplant). Подключи интеграцию — и звонки из Битрикса будут автоматически анализироваться.
Как это работает (TL;DR)
Звонок завершается в Bitrix24 → Webhook отправляет событие → Мы загружаем запись → AI анализирует → Отчет готов
Звонки появляются в системе через 2-3 минуты после завершения.
Что понадобится
- Аккаунт Bitrix24 (облако или коробка)
- Подключенная телефония Voximplant
- Включенная запись разговоров
- Права администратора портала
- 15-20 минут на настройку
Облако или коробка?
Bitrix24.Облако — это название.bitrix24.ru. Настройка проще.
Bitrix24.Коробка — установлен на вашем сервере. Настройка сложнее, нужен доступ к серверу.
Инструкция ниже для облачной версии. Для коробки принцип тот же, но пути в меню могут отличаться.
Пошаговая настройка
Шаг 1: Найди свой домен
Домен — это адрес твоего портала Bitrix24.
Примеры:
company.bitrix24.rumycompany.bitrix24.ru
Просто посмотри в адресной строке браузера, когда заходишь в Bitrix24.
Шаг 2: Создай входящий webhook
Входящий webhook нужен, чтобы CallMeAI мог запрашивать данные у Bitrix24.
- Зайди в Bitrix24 как администратор
- Открой Приложения (в левом меню)
- Перейди в Webhooks → Входящие webhooks
- Нажми «Добавить webhook»
- В разделе Права выбери:
- ✅
telephony— доступ к телефонии - ✅
disk— доступ к файлам (нужен для записей)
- ✅
- Нажми «Сохранить»
- Скопируй полученный URL
https://company.bitrix24.ru/rest/1/abc123xyz/Из этого URL тебе нужен токен — часть после последнего слеша перед слешем (в примере: abc123xyz).Шаг 3: Найди Member ID и User ID
Member ID — идентификатор портала. Найти можно:
- В URL входящего webhook (часть после
/rest/) - В Настройки → Информация о портале
User ID — твой ID пользователя. Найти можно:
- В Профиль → Информация (обычно написано ID: 1)
- В URL твоего профиля
Шаг 4: Настрой интеграцию в CallMeAI
- Открой Интеграции
- Найди карточку Bitrix24 → нажми «Настроить»
- Заполни форму:
| Поле | Что вводить |
|---|---|
| Домен | Адрес портала (например, company.bitrix24.ru) |
| Webhook токен | Токен из входящего webhook |
| Member ID | ID портала |
| User ID | Твой ID пользователя |
| Папка критериев | Выбери критерии для анализа |
- Нажми «Сохранить»
Шаг 5: Создай исходящий webhook в Bitrix24
Исходящий webhook отправляет нам данные о завершенных звонках.
- В Bitrix24 открой Приложения → Webhooks → Исходящие webhooks
- Нажми «Добавить webhook»
- Настрой:
| Поле | Значение |
|---|---|
| URL обработчика | https://callmeai.ru/api/bitrix/webhook |
| Событие | ONVOXIMPLANTCALLEND |
- Сохрани
ONVOXIMPLANTCALLEND — это завершение звонка в телефонии. Без него ничего не будет работать.Шаг 6: Проверь, что всё работает
- Позвони через телефонию Bitrix24
- Поговори 2-3 минуты (запись должна сохраниться)
- Заверши звонок
- Подожди 3-5 минут
- Проверь Банк звонков
Если звонок появился — интеграция работает!
Про телефонию Voximplant
Bitrix24 использует Voximplant для телефонии. Убедись, что:
Телефония активирована
- В Bitrix24 открой Телефония (в левом меню)
- Если пишет «Подключите телефонию» — нужно сначала её настроить
Запись разговоров включена
- Телефония → Настройки → Запись разговоров
- Должно быть включено
Записи сохраняются
- После звонка в карточке должна появляться запись
- Если записей нет — проверь настройки или тариф (на бесплатном тарифе запись может быть ограничена)
Что может пойти не так
Webhook не срабатывает
- Событие
ONVOXIMPLANTCALLENDвыбрано? - URL правильный?
https://callmeai.ru/api/bitrix/webhook - Webhook активен (не отключен)? ::
Ошибка авторизации
- Перепроверь webhook токен — скопируй заново
- Убедись, что webhook имеет права на
telephonyиdisk - Проверь Member ID и User ID ::
Нет записи звонка
- Запись разговоров включена в настройках телефонии?
- Тариф поддерживает запись?
- Звонок был достаточно длинным? (короткие могут не записываться)
- Подожди — запись может сохраняться с задержкой ::
Voximplant не записывает
- Настройки телефонии в Bitrix24
- Лимиты на тарифе
- Свободное место на диске
- Напиши в поддержку Bitrix24 ::
Совместимость с тарифами
| Тариф Bitrix24 | Запись звонков | Интеграция работает |
|---|---|---|
| Бесплатный | Ограничена | Частично |
| Базовый | Да | Да |
| Стандартный | Да | Да |
| Профессиональный | Да | Да |
| Enterprise | Да | Да |
Частые вопросы
Можно анализировать старые звонки?
Нет, интеграция работает только с новыми звонками. Старые записи можно скачать из Bitrix24 и загрузить вручную.
Работает ли с внешней телефонией?
Если телефония подключена через Voximplant — да. Если через другого провайдера (Mango, Sipuni и т.д.) — нужна отдельная интеграция с этим провайдером.
Как узнать, что webhook работает?
В Bitrix24 в разделе исходящих webhooks видны логи вызовов. Там можно посмотреть статусы отправки.
Можно подключить несколько порталов?
Пока нет. Один портал — одна интеграция.
Что дальше?
- Настрой фильтры — чтобы не анализировать все подряд
- Добавь менеджеров — для статистики по каждому
- Посмотри аналитику — тренды и KPI команды