Bitrix24 интеграция

Кратко

Интеграция с Bitrix24 -- основной способ подключения платформы поддержки к инфраструктуре компании. Платформа ставится как приложение Bitrix24 и получает доступ к справочнику сотрудников, CRM, задачам и телефонии портала. Это обеспечивает единую точку авторизации, импорт сотрудников и компаний и вкладку «Поддержка» прямо в карточках CRM.

Кто имеет доступ

Где найти

Настройка: Настройки -- Интеграции -- Bitrix24.

Использование: вход через Bitrix24, вкладка «Поддержка» в карточках CRM и задач, уведомления в Bitrix24.

Как работает

Подключение приложения

Платформа подключается к порталу как приложение Bitrix24:

• Если интеграция не подключена, в настройках показывается кнопка «Установить из Marketplace» -- приложение ставится из маркетплейса Bitrix24.
• Для ручной установки локального приложения в блоке «Локальная установка» приведены значения для формы Bitrix24 (адрес обработчика и первичной установки).
• Если портал просит привязать его к вашей компании, используйте «Код привязки» из того же экрана.

После подключения показываются статус «Подключено», адрес портала, лицензия, число сотрудников и список «Разрешения API», выданных приложению. Кнопка обновления рядом со статусом проверяет соединение.

Синхронизация справочника пользователей

Сотрудники портала загружаются кнопкой «Импортировать сотрудников»; «Синхронизировать кэш» обновляет уже загруженные данные. При включённой «Автосинхронизации сотрудников при входе» данные обновляются при каждом входе. Раз в сутки платформа также сверяет активность сотрудников с порталом.

Пользователи B24 могут авторизоваться в платформе поддержки без отдельной регистрации.

Связь с CRM

При установке приложение добавляет вкладку «Поддержка» в карточки сделки, лида, контакта, компании, счёта и задачи Bitrix24, а также пункт в левое меню портала. В разделе «Сделки» настроек интеграции можно включить создание сделки в Bitrix24 -- сразу при появлении заявки либо при выбранном статусе -- и задать соответствие стадий.

Синхронизация компаний и контактов из CRM

Раздел Настройки → Интеграции → Bitrix24 содержит инструменты синхронизации справочников. Что делает каждый:

Пошагово — как синхронизировать грамотно:

1. Компании и их контакты — нажмите «Импортировать компании из CRM». Перенесёт компании и привязанные к ним контакты. Уже импортированная компания узнаётся по её ID в Bitrix24, поэтому повторный запуск не создаёт дубликатов (название уже импортированной компании при этом не меняется).
2. Сотрудников портала — «Импортировать сотрудников» (операторы и сотрудники компании-владельца).
3. Поддерживать актуальность — включите «Автосинхронизация при входе», чтобы изменения в Bitrix24 (имя, телефон, фото) подтягивались сами. Либо периодически нажимайте «Синхронизировать кэш».

Импорт сопоставляет записи по трём ключам в порядке надёжности: ID Bitrix24 → email → телефон. Подробно о том, как импортированные контакты находятся при обращении клиента, — в статье Контакты клиента.

Если часть записей не сошлась. Контакты из переписки (мессенджеры) и импортированные из CRM связываются только при совпадении ключа. Мессенджеры передают лишь телефон/email (не ID Bitrix24), поэтому клиент из WhatsApp/Telegram сопоставляется с CRM-карточкой по телефону. Когда номер в CRM другой или отсутствует, записи остаются раздельными. Свести их можно:

• вручную — в разделе «Контакты» объединить две карточки или назначить контакту компанию;
• через CRM — добавить в карточку Bitrix24 номер, с которого пишет клиент, и повторить импорт (как в целом строится переписка в WhatsApp через карточки CRM — см. WhatsApp в CRM).

Создание задач в Bitrix24

Администратор выбирает, когда автоматически заводить задачу: при создании заявки либо при переходе в конкретный статус. Для тенанта отдельно задаются проект и ответственный по умолчанию. После создания ссылка на задачу появляется в заявке.

Карта состояний работает в обе стороны: настроенное состояние задачи может менять статус заявки, а статус заявки — состояние задачи. Дополнительно можно закрывать связанную задачу вместе с заявкой. Все вызовы выполняются в подключённый Bitrix24-портал текущего тенанта.

SIP-телефония (реальные звонки)

При наличии подключённой телефонии в Bitrix24 (Voximplant/SIP connector):

• В карточке заявки появляется секция "Звонок на телефон" с номерами контактов
• Оператор может позвонить клиенту одним кликом прямо из заявки
• Два режима работы:
  • Диалер (по умолчанию) — открывается VoIP-диалер Bitrix24, оператор говорит через микрофон компьютера
  • Обратный звонок — Bitrix24 звонит оператору на SIP-телефон, затем соединяет с клиентом
• Режим настраивается в настройках телефонии (раздел «Интеграции», переключатель «Обратный звонок (без окна Битрикс24)»)
• Входящие звонки от клиентов отображаются с привязкой к заявке
• Запись о звонке сохраняется в чате заявки; общий обзор того, как подключить телефонию к CRM, — в статье Телефония в CRM

Уведомления в Bitrix24

Уведомления платформы могут доставляться во внутренний мессенджер Bitrix24. Какие события и куда присылать, каждый сотрудник выбирает в своих настройках уведомлений (ссылка «Уведомления» в блоке «Связанные настройки»).

Вкладки в Bitrix24

Вкладка «Поддержка» в карточках CRM и задач и пункт левого меню регистрируются автоматически при установке приложения; отдельной настройки для них нет.

Настройка

Первичное подключение

1. Перейдите в Настройки -- Интеграции -- Bitrix24
2. Нажмите «Установить из Marketplace» и установите приложение на своём портале (либо заведите локальное приложение со значениями из блока «Локальная установка»)
3. Если портал попросит, введите «Код привязки»
4. Вернитесь в настройки: статус изменится на «Подключено»
5. Нажмите «Импортировать сотрудников», затем при необходимости «Импортировать компании из CRM»

Настройка уведомлений

Уведомления в Bitrix24 настраиваются в личных настройках уведомлений сотрудника; в настройках интеграции на них ведёт ссылка «Уведомления» в блоке «Связанные настройки».

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

OAuth токен истёк и не обновляется.

Токены обновляются автоматически. Если обновление не происходит: (1) проверьте доступность портала Bitrix24, (2) убедитесь, что приложение не отозвано администратором портала, (3) переподключите интеграцию.

Пользователи B24 не отображаются в списке операторов.

Нажмите «Импортировать сотрудников» (Настройки -- Интеграции -- Bitrix24). Проверьте, что пользователи активны в B24.

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

Одна компания подключается к одному порталу. Для нескольких порталов используйте разные компании платформы.

Связанные статьи

• Операторы и роли -- управление командой из B24
• Профиль компании -- данные компании
• Реквизиты -- импорт реквизитов из B24
• Уведомления -- каналы доставки уведомлений