Битрикс24

Подключаем бота к CRM Битрикс, учимся создавать кастомные поля

В Битрикс24 удален виджет Salebot, подключить интеграцию не получится.

Переходите на SalebotCRM — не пожалеете.

Также для работы с Битрикс24 есть методы, описанные в разделе АПИ в калькуляторе: https://docs.salebot.pro/peremennye-1/api-v-kalkulyatore#api-bitriks24

Конструктор не умеет получать данные из Битрикс 24, но вы можете передавать данные, вызвав из Битрикс 24 наши методы апи, которые описаны в API конструктора

Страница с CRM-интеграциями

Чтобы перейти на соответствующую страницу с CRM-интеграциями, воспользуйтесь ссылкой https://salebot.pro/projects/{ID ПРОЕКТА}/crm_integrations, где вместо {ID ПРОЕКТА} - передайте ID вашего проекта, в котором необходимо подключить интеграцию.

Чтобы найти ID проекта, кликните по адресной строке, где вы увидите ID после конструкции https://salebot.pro/projects/:

Как подключить Битрикс

Вначале нужно установить приложение в битрикс и после этого подключить в Salebot. Если сделать наоборот то, не появляется карточка в контакт-центре.

Для интеграции с CRM Битрикс, необходимо выполнить настройки как на стороне самой CRM, так и на стороне Salebot.

Установите приложение Salebot из маркетплейса. Ссылка на приложение -> здесь.

Далее авторизуйтесь на сайте.

Домен необходимо взять из адресной строки битрикса, он уникальный для каждой CRM.

Например, http://testsalebot.bitrix24.ru, нас интересует здесь текст "testsalebot".

Далее переходим в раздел "Интеграции с CRM" на сайте salebot.pro. Вводим наш домен и региональную зону, как показано на рисунках ниже.

Жмем на кнопку "Подключить Bitrix24". На этом интеграция закончена, все очень просто.

Пример работы

Рассмотрим пример работы. Для примера создадим воронку, которая запрашивает у человека адрес и отправляет заявку в битрикс

И пройдем по воронке в любом мессенджере

И эта заявка автоматически отправляется в битрикс. Создается лид, потом битриксом создается сделка на основании этого лида.

Дополнительно можно настроить уведомления на электронную почту

И уведомления придут на почту:

Имя клиента записывается в его контакт, если в диалоге заполнится поле ввода с названием phone или email, то они также пойдут в контакт.

Как задать режим работы

В битриксе есть два режима работы CRM: Простой и Классический

При первом подключении битрикса к проекту в настройках проекта -> Общие переменные, добавится переменная со значением включенного у вас режима CRM bitrix_crm_mode

1 - классический режим (режим работы с Лидами) 2 - простой режим (без Лидов)

Если после подключения битрикс в Salebot, вы изменили режим CRM в битрикс, то в обязательном порядке измените его и в настройках проекта в Salebot (bitrix_crm_mode)

Как заполнить поля сделок и лидов

Вы также можете заполнить пользовательские поля битрикса, а также встроенные - у сделок и лидов. Каждое поле указывается с новой строки. Сначала идет код поля в Bitrix24, затем название переменной в Salebot, которая запишется в него. Для встроенного поля просто укажите его имя, например UTM_SOURCE

Список стандартных полей битрикс, можно посмотреть:

для лидов: https://dev.1c-bitrix.ru/rest_help/crm/leads/crm_lead_fields.php

для сделок: https://dev.1c-bitrix.ru/rest_help/crm/cdeals/crm_deal_fields.php

для контактов: https://dev.1c-bitrix.ru/rest_help/crm/contacts/crm_contact_fields.php

Столбец Поле

Записать поля по имени можно только те, у которых тип String

Поля: TITLE, COMMENTS, NAME, LAST_NAME, SOURCE_ID, ASSIGNED_BY_ID, STAGE_ID, TYPE_ID, IS_RETURN_CUSTOMER, CONTACT_ID - являются служебными и их заполнение происходит автоматически

Как узнать ID пользовательского поля

Для того, чтобы узнать ID уже созданного Вами поля, необходимо:

открыть Ваш Bitrix 24;
перейти в раздел CRM → Настройки → Настройки форм и отчетов → Пользовательские поля → Лид (Список поле);

в списке найти ваше поле и перейти в него;

в поисковой строке, в конце url, вы увидите значение UF_CRM_XXXXXXXXXX

https://ваш-домен.bitrix24.ru/crm/configs/fields/CRM_LEAD/edit/UF_CRM_XXXXXXXXXX/, где UF_CRM_XXXXXXXXXX — это и есть ID

Если у вас нет еще пользовательского поля, то для начала вам необходимо его создать, после чего Вы сможете узнать его ID.

Как создать пользовательское поле

Для создания вашего пользовательского поля, необходимо:

открыть Ваш Bitrix 24;
перейти в раздел CRM → Настройки → Настройки форм и отчетов → Пользовательские поля → Лид (Добавить поле);
задать название поля;
поставить галочку для «Показывать в списке»;
желательно использовать тип поля «Строка»;
сохранить

Только после того как вы создадите пользовательское поле можно узнать его ID.

Примеры записи кастомных полей Битрикс показаны на рисунке ниже

Как подключить открытые линии Bitix24

Вы можете общаться с клиентами из открытых линий. Для этого в окне подключения необходимо включить переключатель "Подключить к открытым линиям"

Название открытой линии менять запрещено! Произойдут необратимые изменения

Обращаем внимание! Пользователям, с которыми планируется работа в Б24, нужно дать доступ в настройках открытой линии и в приложении в маркете.

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

Обратите внимание, что новый лид будет создан только при получении информации, необходимой для обратного обращения к клиенту. Если клиент обратился через соцсеть или внешний мессенджер (т.е. когда есть, куда обратно написать ответ), Лид будет создан. Если при подключении онлайн-чата на сайте клиент напишет в линию и не укажет какие-либо данные о себе, а потом уйдет с сайта, то обратно клиенту уже не написать, он просто никак не получит сообщение, поэтому такой Лид CRM не зафиксирует

Если вы переходите на Salebot с другой платформы, то старые диалоги не будут работать, так как открытая линия создана прошлой платформой. Вам необходимо будет написать первым заново, для создания диалога через Salebot

Больше настраивать ничего не нужно. Ниже представлены изображения, демонстрирующие работу.

Как назначить ответственного при создании лида открытой линии

Переходим в Контакт-Центр, находим Salebot и выбираем открытую линию -> Линия для подключения Salebot.pro

В открывшемся окне настраиваем ответственных.

Название открытой линии менять запрещено! Произойдут необратимые изменения

После отправки данных желтым или красным блоком в Salebot, ответственным станет тот, чей идентификатор указан в настройках подключения битрикс24 в Salebot.

Также ответственного можно изменять с помощью методов в калькуляторе: прочитать можно здесь.

Возможные ошибки подключения

Название открытой линии менять запрещено! Произойдут необратимые изменения

Если у вас дубли сообщений из битрикс, то нужно сделать следующее

1. Отключить битрикс во всех проектах Salebot.

2. Отключить интеграцию Salebot в битрикс.

3. Salebot заново интегрировать в битрикс.

4. Подключить битрикс к одному проекту Salebot.

Если подключение идет в 2 и более проекта Salebot - возможны дубли и проблемы с заявками

Как убрать сообщения от Битрикс24

Если в диалоге с клиентом вы обнаружили сообщения типа "Вам ответит первый освободившийся оператор." или "Оцените качество обслуживания", то надо внести изменения в настройки открытой линии.

Для этого в меню Битрикс24 найдите пункт Контакт-центр. Пройдите в этот раздел и кликните по значку Salebot:

Внутри выберите Линия для подключения Salebot и кликните Настроить:

В настройках этой линии отключите ненужные пункты и подключите нужные вам:

Как написать первым в Whatsapp

Этот функционал может подключить только администратор Bitrix24

Заполняем обязательный поля Имя, Фамилия, номер телефона:

Нажимаем Сохранить.

Далее кликаем два раза на контакте, которому нужно написать, и справа в меню нажимаем на появившуюся кнопку "Написать в Whatsapp":

После нажатия на кнопку откроется меню приложения Salebot:

Если у контакта больше одного номера телефона, то приложение от Salebot предложит выбрать один из них.

Если у Вас подключено несколько WhatsApp номеров в проекте на Salebot, у вас также есть выбор с какого из них написать.

После ввода сообщения и выбора нужного нужных параметров, нажимаем кнопку "Отправить сообщение".

После успешной отправки получаем во кладке с приложением сообщение: Сообщение отправлено! Закройте эту вкладку и перейдите в диалог с клиентом.

А справа вверху получим всплывающее сообщение, что открыта новая линия с контактом, по нажатию на которое переходим в чат с клиентом.

Писать первым из Битрикс24 можно только в WhatsApp.

Как настроить Webhook в Bitrix24

Все нужные нам вебхуки настраиваются в роботах

Далее нажимаем любую из кнопок Добавить

Далее либо добавляем вебхук, либо редактируем существующий

Для передачи каких-либо данных из битрикс в Salebot используются роботы

domain.bitrix24.ru - заменить на ваш домен в битрикс.

Если у вас включена работа с открытыми линиями, то:

URL webhook для Лидов: https://chatter.salebot.pro/bitrix_webhook/domain.bitrix24.ru/robots_webhook?line={{Контакт Открытая линия}}

URL webhook для Сделок (до передачи данных в битрикс желтым блоком): https://chatter.salebot.pro/bitrix_webhook/domain.bitrix24.ru/robots_webhook?line={{Контакт: Контакт Открытая линия}}

URL webhook для Сделок (после передачи данных в битрикс желтым блоком): https://chatter.salebot.pro/bitrix_webhook/domain.bitrix24.ru/robots_webhook?contact_id={{Контакт: ID}}

Если открытые линии выключены, то используем следующие url:

URL webhook для Лидов: https://chatter.salebot.pro/bitrix_webhook/domain.bitrix24.ru/robots_webhook?lead_id={{ID}}

URL webhook для Сделок: https://chatter.salebot.pro/bitrix_webhook/domain.bitrix24.ru/robots_webhook?deal_id={{ID}} Или https://chatter.salebot.pro/bitrix_webhook/domain.bitrix24.ru/robots_webhook?contact_id={{Контакт: ID}}

Внимание! Если по какой-то причине переданы одновременно 2 и более параметра, то приоритет следующий:

line
contact_id
lead_id
deal_id

например одновременно переданы deal_id и contact_id, система будет искать пользователя по contact_id, так как приоритет у него выше, а deal_id просто проигнорирует.

Это обязательная часть, чтобы определить, от кого пришел колбек. Далее можно отправить нужные вам данные, которые добавятся к сделке в Salebot.

Данные передаются следующим образом: &имя_переменной={{значение}}

Пример ссылки, передающей переменные: https://chatter.salebot.pro/bitrix_webhook/b24-b4qrod..{{Контакт: Контакт Открытая линия}}&stage={{Стадия сделки}}&maker={{Создатель сделки}}

Внимательно посмотрите на пример с передачей стадии Лида или Сделки в Salebot.

Имена переменных, которые зарезервированы системой: line, lead_id, deal_id, bitrix_lead_id, bitrix_deal_id, bitrix_contact_id

Так передаваемые переменные называть нельзя, данные просто не запишутся.

Как запустить бота при смене статуса сделки

Для других событий делается аналогичным образом

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

К адресу дописываем переменную: &stage={{Статус}} - она добавит клиенту в сейлбот переменную stage с названием стадии.

Пример для работы с лидами:

Обязательно нажимаем на обе кнопки сохранить!

Пример работы со сделками:

Данный вебхук необходимо скопировать в каждую стадию, информацию о которой вы хотите видеть в переписке и в переменных

После изменения статуса проекта придет уведомление с текстом, словно это написал клиент (но это сообщение будет видно только в интерфейсе Salebot.pro): bitrix_stage Название стадии

Остальные данные запишутся клиенту:

Далее вы можете использовать данное сообщение как условие у блока в редакторе и отправить пользователю сообщение, соответствующее такому переходу.

Как отправить сообщения клиенту при смене этапа Сделки/Лида

Для других событий делается аналогичным образом

Сообщения настраиваются в меню “роботы”

На нужном этапе нажимаем кнопку Добавить -> Для связи с клиентом -> Сообщение в Открытую линию

Пишем шаблон сообщения, также справа по нажатию на три точки можно вставить нужные данные, например имя.

После того как сообщение подготовлено, нажимаем два раза Сохранить. Теперь при переходе в этот этап клиенту будет отправлено ваше сообщение.

Как запустить бота роботом Битрикс

Для запуска бота из битрикс в Salebot используются роботы. Для этого на нужном этапе в битрикс нужно настроить робота.

Работает только для WhatsApp

URL webhook для Лидов (Классическая CRM - с Лидами):

https://chatter.salebot.pro/bitrix_webhook/domain.bitrix24.ru/robots_webhook?callback=1&lead_id={{ID}}&phone={{Рабочий телефон}}&name={{Название лида}}&whatsapp_id=19786&text=start

URL webhook для Сделок (Простая CRM - режим без лидов):

https://chatter.salebot.pro/bitrix_webhook/domain.bitrix24.ru/robots_webhook?callback=1&deal_id={{ID}}&contact_id={{Контакт: ID}}&phone={{Контакт: Рабочий телефон}}&name={{Контакт: Имя}}&whatsapp_id=19786&text=start

Обязательные данные:

callback - оставляем как есть lead_id - оставляем как есть или deal_id и contact_id - оставляем как есть

domain.bitrix24.ru - заменить на ваш домен в битрикс phone - переменная, где находится номер клиента, в примере берется рабочий номер телефона {{Контакт: Рабочий телефон}} whatsapp_id - идентификатор whatsapp бота (в примере 19786)

Необязательные переменные:

name - запишется как имя клиента в Salebot (если не передать, то запишется номер телефона) text - текст уведомления, который придет в диалог (если не передать, то по умолчанию callback bitrix robot)

Структура переменной в урл адресе следующая:

&phone={{Контакт: Рабочий телефон}} & - знак амперсанда, для указания браузеру, что дальше название переменной phone - название переменной = - указание на то, что дальше значение переменной {{Контакт: Рабочий телефон}} - значение переменной То есть, если вам не нужно передавать, например текст, то нужно удалить из урл-адреса вот эту часть: &text=start

Чтобы вставить нужное значение (переменную) из битрикс

Поставить курсор в место, куда будет вставлена переменная
Нажать троеточие для вызова меню
Выбрать нужную переменную

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