Интеграция Битрикс24

ОмниЧат работает внутри вашего Битрикс24: менеджер открывает карточку сделки и видит переписку клиента из WhatsApp или Telegram, может ответить и написать первым. Здесь — где ОмниЧат появляется в Битрикс24 и что настроить администратору, чтобы всё работало без сбоев.

Что заводить в Битрикс24 на новое обращение (лид, сделку), описано в статье «Правила работы с CRM».

Где ОмниЧат в Битрикс24

• Левое меню портала — пункт ОмниЧат открывает диалоги, пункт «ОмниЧат: настройки» — настройки кабинета.
• Вкладка ОмниЧат в карточке — в лиде, сделке, контакте, компании, счёте и в смарт-процессах.
• Поле ОмниЧат в карточке — короткий блок с телефоном, ником и перепиской клиента в лиде, сделке и контакте.
• Лента карточки — записи с перепиской.
• Открытые линии — если вы выбрали режим «Гибрид».
• Мобильное приложение Битрикс24 — пункт ОмниЧат в меню «Приложения» чата.

Вкладка ОмниЧат в карточке

Откройте сделку, лид или контакт и перейдите на вкладку ОмниЧат. Там переписки этого клиента во всех мессенджерах. Можно ответить, не уходя из карточки, или начать новый чат по номеру из карточки.

Вкладки ставятся сами при установке приложения. Есть ли они, видно в «Настройках», в разделе «Поведение и сообщения»: карточка «Подключённый портал», строка «Вкладки в карточках».

Смарт-процесс, который вы создали после установки, вкладку сам не получает. Администратор портала добавляет её кнопкой «Добавить вкладку» — см. ниже.

Поле ОмниЧат и значок в ленте

Поле ОмниЧат показывает прямо в карточке телефон и ник клиента и его переписки. Значок чата открывает переписку, «+» — новый чат.

Ставит поле администратор портала, один раз:

1. Откройте ОмниЧат внутри Битрикс24 под учётной записью администратора портала.
2. Перейдите в «Настройки», в раздел «Поведение и сообщения».
3. В карточке «ОмниЧат в карточках CRM» в строке «Поле в карточках» нажмите «Подключить».
4. В строке «Смарт-процессы» нажмите «Добавить вкладку», если там написано «без вкладки».
5. В строке «Значок в ленте» нажмите «Поставить значок ОмниЧат».

Убрать поле — кнопка «Убрать» там же.

Переписка в ленте карточки

Сообщения из WhatsApp, Telegram и MAX попадают в ленту карточки клиента записью: кто написал, когда и что. Пока разговор идёт, сообщения собираются в одну запись. После паузы в час начинается новая. Кнопка «Открыть в ОмниЧат» в записи открывает этот диалог.

• Запись попадает в карточку контакта и во все его открытые сделки и лиды. Пока у клиента нет контакта — в его лид.
• Заметки для команды и недоставленные сообщения в ленту не попадают.
• Включается и выключается в «Настройках», в разделе «Поведение и сообщения», в строке «Переписка в карточке CRM».
• В режиме «Гибрид» по умолчанию выключено: переписку уже ведёт Открытая линия.

Подробнее — в статье «Поведение и сообщения».

Открытые линии

Открытые линии — чат с клиентами внутри самого Битрикс24. Если ваши менеджеры привыкли отвечать там, выберите режим «Гибрид»: «Настройки», раздел «Правила работы с CRM», карточка «Режим работы с Битрикс24».

Что происходит в «Гибриде»:

• Сообщение клиента приходит и в ОмниЧат, и в Открытую линию.
• Менеджер может ответить из Открытой линии или из ОмниЧат — клиент получит ответ в свой мессенджер.
• Ответ из ОмниЧат появляется в линии с жирной подписью первой строкой: «Отправлено из приложения — имя сотрудника». Ответ, отправленный с телефона, — «Отправлено с телефона — канал «…»».
• Лиды и сделки заводит сам Битрикс24 по настройкам линии, правила ОмниЧат не действуют.
• Диалог линии виден во всех открытых сделках и лидах клиента.

Какая линия принимает сообщения канала, выбирают на странице канала, в карточке «Открытая линия в Битрикс24»: «Использовать линию аккаунта» или «Своя линия». Пока линия не выбрана, сообщения канала в Открытые линии не уходят.

Мобильное приложение Битрикс24

ОмниЧат можно открыть с телефона, прямо из чата Битрикс24.

1. Откройте чат в мобильном приложении Битрикс24.
2. Над полем ввода нажмите «Приложения».
3. Выберите ОмниЧат.

Куда ведёт пункт:

• Из чата Открытой линии — сразу в этот диалог с клиентом в ОмниЧат.
• Из чата сделки, лида, контакта или компании — в переписки этого клиента.
• Из любого другого чата — в список диалогов.

ОмниЧат откроется отдельной страницей поверх чата. Отвечайте клиенту там: вставить текст в поле ввода чата Битрикс24 ОмниЧат не может.

Кнопку «Приложения» Битрикс24 показывает не на всех порталах. Если кнопка есть, а пункта ОмниЧат в ней нет, напишите в поддержку.

Авторизация администратора

ОмниЧат работает с Битрикс24 от имени сотрудника портала. Если этот доступ «плавает» между сотрудниками, могут пропадать уведомления и работа в фоне. Авторизация закрепляет доступ за администратором портала.

1. Под учётной записью администратора портала откройте «Настройки», раздел «Интеграция Битрикс24».
2. Нажмите «Авторизоваться в Битрикс24».
3. В открывшемся окне дождитесь надписи «Доступ зафиксирован».
4. Обновите страницу настроек. Должно появиться «Авторизовано».

Входы других сотрудников этот доступ не сбрасывают. Если сменился администратор или приложение переустановили, нажмите «Переавторизоваться».

Авторизация нужна и для чат-бота уведомлений в Битрикс24 — см. статью «Уведомления и долгое ожидание ответа».

Ключ доступа

Ключ доступа — специальная ссылка из вашего Битрикс24 (в Битрикс24 она называется «входящий вебхук»). С ней работа с CRM не зависит от того, кто из сотрудников последним открыл приложение. Ключ необязателен, но делает работу надёжнее.

1. В Битрикс24 под администратором откройте «Приложения», затем «Разработчикам» и «Другое». Выберите «Входящий вебхук».
2. Отметьте права: «CRM (crm)» и «Уведомления (im)» — обязательно. «Открытые линии (imopenlines)» — желательно: нужно, чтобы переносить историю прошлых диалогов Открытых линий.
3. Скопируйте адрес вида https://ваш-портал.bitrix24.ru/rest/1/xxxxxxxx/.
4. В ОмниЧат откройте раздел «Интеграция Битрикс24» в «Настройках» и вставьте адрес в поле «Адрес ключа доступа».
5. Нажмите «Сохранить и проверить».

Ключ хранится зашифрованным: после сохранения видна только часть адреса. Кнопка «Удалить ключ» вернёт работу через доступ приложения.

Не хватает прав

После проверки рядом с ключом видны его права: зелёные есть, жёлтые с крестиком не хватает.

1. В Битрикс24 откройте тот же входящий вебхук.
2. Отметьте недостающие права и сохраните его.
3. В ОмниЧат вставьте адрес ещё раз и нажмите «Сохранить и проверить».

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

В карточке нет вкладки ОмниЧат. Если это смарт-процесс — администратору нужно нажать «Добавить вкладку» (см. «Поле ОмниЧат и значок в ленте»). Если вкладок нет нигде — проверьте строку «Вкладки в карточках» в «Поведение и сообщения» и напишите в поддержку.

Пропали уведомления в Битрикс24. Откройте «Интеграция Битрикс24» и посмотрите на авторизацию администратора. Написано «Нужна авторизация» — нажмите «Авторизоваться в Битрикс24».

У записи в ленте значок мессенджера, а не ОмниЧат. Значок ставит администратор портала кнопкой «Поставить значок ОмниЧат».