Bitrix24

Интеграция с Bitrix24 — самая полная из доступных. Она забирает звонки из таймлайна CRM вместе с привязкой к лиду, сделке или контакту, синхронизирует пользователей, отделы, статусы и поля, а после анализа может записать в CRM транскрипт, резюме, задачи и значения полей.

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

• Права администратора в вашем Bitrix24, чтобы создать входящий вебхук.
• Доступ к разделу «Интеграции» в вашей команде.

Шаг 1. Создайте входящий вебхук в Bitrix24

1. В Bitrix24 откройте раздел для разработчиков и создайте входящий вебхук.
2. Отметьте права (scope). Обязательные: crm и user. Рекомендуемые: telephony, task, disk, department — без них часть возможностей будет недоступна (например, загрузка записей, создание задач или загрузка отделов).
3. Сохраните вебхук и скопируйте его URL. Он выглядит так: https://ваша-компания.bitrix24.ru/rest/1/abc123xyz456/.

URL вебхука даёт доступ к данным вашего портала — храните его так же бережно, как пароль.

Шаг 2. Добавьте интеграцию

1. Откройте «Интеграции» → «CRM».
2. У Bitrix24 нажмите «Добавить».
3. Заполните поля:

4. Нажмите «Проверить доступ». В блоке «Необходимые права» будет видно, какие права подтверждены. Если чего-то не хватает, появится подсказка «Предоставьте недостающие права в Bitrix24 для этого вебхука» — добавьте права в настройках вебхука и проверьте снова.
5. Нажмите «Сохранить», затем откройте интеграцию и нажмите «Sync», чтобы загрузить пользователей, отделы, статусы и поля.
6. Для финальной проверки нажмите «Проверить интеграцию» — платформа найдёт последние звонки и проверит доступность записи.

Режим «Webhook live»

В этом режиме звонки попадают в платформу сразу после завершения, без ожидания расписания.

1. На карточке интеграции скопируйте URL вебхука.
2. В Bitrix24 создайте исходящий вебхук, укажите этот URL как адрес обработчика и подпишите его на события добавления и обновления дел CRM и завершения звонка телефонии. Дополнительно можно подписаться на события изменения пользовательских полей — тогда каталог полей будет обновляться автоматически.
3. Скопируйте из настроек исходящего вебхука токен приложения и вставьте его в поле «Токен приложения» интеграции. По нему платформа проверяет, что события пришли именно с вашего портала.

Что загружается из Bitrix24

• Звонки — дела типа «звонок» из таймлайна CRM с записью разговора, направлением, номером и оператором.
• Связи с CRM — лид, сделка или контакт, к которому относится звонок. В карточке звонка появляется ссылка «Открыть в CRM».
• Пользователи и отделы — для привязки звонков к операторам (подраздел «Операторы»).
• Статусы и стадии лидов и сделок — используются в фильтрах автоматизаций («Статус CRM») и отчётах. Обновляются автоматически раз в сутки и по кнопке «Sync».
• Поля лидов, сделок, контактов и компаний — для сопоставления полей и переноса значений в звонки.

Переносимые поля

На странице «Интеграции» → «CRM» есть блок «Переносимые поля». Отметьте пользовательские поля CRM (лида, сделки, контакта или компании), значения которых нужно сохранять в каждом звонке. Они появятся в карточке звонка и станут доступны как фильтры и группировки в отчётах. Выбор применяется к звонкам, загруженным после него. Не выбирайте лишнего: каждое поле увеличивает нагрузку при выгрузке из CRM.

Запись результатов обратно в Bitrix24

Запись настраивается в автоматизации рабочего пространства: «Автоматизация» → откройте автоматизацию → шаг «Синхронизация».

1. Нажмите «Добавить интеграцию» и выберите Bitrix24 в поле «Синхронизировать в интеграцию».
2. Включите «Включить синхронизацию данных».
3. В блоке «Основные данные» выберите, что отправлять:
   • «Прикрепить транскрипт с ролями к звонку» — транскрипт появится в звонке Bitrix24;
   • «Включить резюме в описание активности» — краткое резюме разговора в описании дела;
   • «Дополнительные поля описания» — любые ответы карточек, которые добавятся под резюме строками «Метка: значение».
4. «Создать задачи в CRM из обязательств» — выберите «Только задачи оператора» или «Все обязательства (оператор + клиент + другие)». В поле «Создавать в Bitrix как» выберите один вариант — «Дело в таймлайне» или «Задача», чтобы не дублировать задачи, которые менеджеры ставят вручную. Можно также «Пропускать обязательства старше (дней)». Статусы созданных задач периодически сверяются с CRM, поэтому выполненные задачи отмечаются и в платформе.
5. «Сопоставление полей» — нажмите «Добавить сопоставление», выберите исходное значение (ответ карточки анализа, «Итоговый балл», «Длительность», «Направление» и т. п.) и поле CRM. Доступные преобразования: «Прямое значение», «Таблица значений», «Шаблон», «Автосопоставление опций CRM», «Разрешение матрицы» и «Балл → Да/Нет (порог 75)». Флажок «Перезаписывать если заполнено» решает, менять ли уже заполненное поле.
6. «Смарт-процессы» — можно создавать дочернюю запись смарт-процесса (например, карточку оценки качества) и переносить в неё ответы выбранной карточки анализа.
7. Для первого запуска включите «Режим симуляции (без отправки)»: данные подготовятся, но в CRM не уйдут. Проверьте результат во вкладке модулей звонка, затем выключите симуляцию.

Связать отдельный вопрос карточки анализа с полем CRM можно и прямо в редакторе карточки — кнопка «Связать с полем CRM». См. Карточки анализа.

Другие возможности с Bitrix24

• Словари из CRM — словарь можно автоматически заполнить из поля-списка CRM («Синхронизировать с интеграцией»), например из каталога продуктов. См. Словари и плейбуки.
• Отслеживание визитов — платформа отмечает, состоялся ли визит, назначенный в звонке, по истории стадий в CRM. См. Задачи и визиты.

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

Проверка показывает «Проверка выполнена с ограничениями». Обычно это значит, что не выданы необязательные права. Интеграция работает, но часть функций будет недоступна — добавьте права вебхуку.

Звонки не появляются. Убедитесь, что интеграция активна (переключатель на карточке), в рабочем пространстве создана автоматизация с источником Bitrix24, а её фильтры не отсекают звонки. Запустите «Проверить интеграцию».