Интеграция Bitrix24

Как подключить CRM Bitrix24 для автоматического анализа звонков

Интеграция Bitrix24

Bitrix24 — популярная CRM со встроенной телефонией (Voximplant). Подключи интеграцию — и звонки из Битрикса будут автоматически анализироваться.

Как это работает (TL;DR)

Звонок завершается в Bitrix24 → Webhook отправляет событие → Мы загружаем запись → AI анализирует → Отчет готов

Звонки появляются в системе через 2-3 минуты после завершения.


Что понадобится

  • Аккаунт Bitrix24 (облако или коробка)
  • Подключенная телефония Voximplant
  • Включенная запись разговоров
  • Права администратора портала
  • 15-20 минут на настройку

Облако или коробка?

Bitrix24.Облако — это название.bitrix24.ru. Настройка проще.

Bitrix24.Коробка — установлен на вашем сервере. Настройка сложнее, нужен доступ к серверу.

Инструкция ниже для облачной версии. Для коробки принцип тот же, но пути в меню могут отличаться.


Пошаговая настройка

Шаг 1: Найди свой домен

Домен — это адрес твоего портала Bitrix24.

Примеры:

  • company.bitrix24.ru
  • mycompany.bitrix24.ru

Просто посмотри в адресной строке браузера, когда заходишь в Bitrix24.

Шаг 2: Создай входящий webhook

Входящий webhook нужен, чтобы CallMeAI мог запрашивать данные у Bitrix24.

  1. Зайди в Bitrix24 как администратор
  2. Открой Приложения (в левом меню)
  3. Перейди в WebhooksВходящие webhooks
  4. Нажми «Добавить webhook»
  5. В разделе Права выбери:
    • telephony — доступ к телефонии
    • disk — доступ к файлам (нужен для записей)
  6. Нажми «Сохранить»
  7. Скопируй полученный URL
Webhook URL выглядит примерно так: https://company.bitrix24.ru/rest/1/abc123xyz/Из этого URL тебе нужен токен — часть после последнего слеша перед слешем (в примере: abc123xyz).

Шаг 3: Найди Member ID и User ID

Member ID — идентификатор портала. Найти можно:

  1. В URL входящего webhook (часть после /rest/)
  2. В НастройкиИнформация о портале

User ID — твой ID пользователя. Найти можно:

  1. В ПрофильИнформация (обычно написано ID: 1)
  2. В URL твоего профиля
Обычно Member ID и User ID — это числа. Если не уверен — напиши в поддержку Bitrix24 или нам.

Шаг 4: Настрой интеграцию в CallMeAI

  1. Открой Интеграции
  2. Найди карточку Bitrix24 → нажми «Настроить»
  3. Заполни форму:
ПолеЧто вводить
ДоменАдрес портала (например, company.bitrix24.ru)
Webhook токенТокен из входящего webhook
Member IDID портала
User IDТвой ID пользователя
Папка критериевВыбери критерии для анализа
  1. Нажми «Сохранить»

Шаг 5: Создай исходящий webhook в Bitrix24

Исходящий webhook отправляет нам данные о завершенных звонках.

  1. В Bitrix24 открой ПриложенияWebhooksИсходящие webhooks
  2. Нажми «Добавить webhook»
  3. Настрой:
ПолеЗначение
URL обработчикаhttps://callmeai.ru/api/bitrix/webhook
СобытиеONVOXIMPLANTCALLEND
  1. Сохрани
Событие обязательно:ONVOXIMPLANTCALLEND — это завершение звонка в телефонии. Без него ничего не будет работать.

Шаг 6: Проверь, что всё работает

  1. Позвони через телефонию Bitrix24
  2. Поговори 2-3 минуты (запись должна сохраниться)
  3. Заверши звонок
  4. Подожди 3-5 минут
  5. Проверь Банк звонков

Если звонок появился — интеграция работает!


Про телефонию Voximplant

Bitrix24 использует Voximplant для телефонии. Убедись, что:

Телефония активирована

  1. В Bitrix24 открой Телефония (в левом меню)
  2. Если пишет «Подключите телефонию» — нужно сначала её настроить

Запись разговоров включена

  1. ТелефонияНастройкиЗапись разговоров
  2. Должно быть включено

Записи сохраняются

  1. После звонка в карточке должна появляться запись
  2. Если записей нет — проверь настройки или тариф (на бесплатном тарифе запись может быть ограничена)

Что может пойти не так

Webhook не срабатывает

Webhook создан, но звонки не приходятПроверь:
  1. Событие ONVOXIMPLANTCALLEND выбрано?
  2. URL правильный? https://callmeai.ru/api/bitrix/webhook
  3. Webhook активен (не отключен)? ::

Ошибка авторизации

«Ошибка авторизации» или «Доступ запрещен»
  1. Перепроверь webhook токен — скопируй заново
  2. Убедись, что webhook имеет права на telephony и disk
  3. Проверь Member ID и User ID ::

Нет записи звонка

Звонок был, но записи нет
  1. Запись разговоров включена в настройках телефонии?
  2. Тариф поддерживает запись?
  3. Звонок был достаточно длинным? (короткие могут не записываться)
  4. Подожди — запись может сохраняться с задержкой ::

Voximplant не записывает

Телефония работает, но записи не создаютсяЭто проблема на стороне Bitrix24. Проверь:
  1. Настройки телефонии в Bitrix24
  2. Лимиты на тарифе
  3. Свободное место на диске
  4. Напиши в поддержку Bitrix24 ::

Совместимость с тарифами

Тариф Bitrix24Запись звонковИнтеграция работает
БесплатныйОграниченаЧастично
БазовыйДаДа
СтандартныйДаДа
ПрофессиональныйДаДа
EnterpriseДаДа
На бесплатном тарифе запись может быть ограничена по времени хранения или количеству. Уточни в Bitrix24.

Частые вопросы

Можно анализировать старые звонки?

Нет, интеграция работает только с новыми звонками. Старые записи можно скачать из Bitrix24 и загрузить вручную.

Работает ли с внешней телефонией?

Если телефония подключена через Voximplant — да. Если через другого провайдера (Mango, Sipuni и т.д.) — нужна отдельная интеграция с этим провайдером.

Как узнать, что webhook работает?

В Bitrix24 в разделе исходящих webhooks видны логи вызовов. Там можно посмотреть статусы отправки.

Можно подключить несколько порталов?

Пока нет. Один портал — одна интеграция.


Что дальше?