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

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

Вначале нужно установить приложение в битрикс и после этого подключить в сейлбот. Если сделать наоборот то не появляется карточка в контакт-центре.
Для интеграции с CRM Битрикс, необходимо выполнить настройки как на стороне самой CRM, так и на стороне Salebot.
Установите приложение Salebot из маркетплейса. Ссылка на приложение: https://www.bitrix24.ru/apps/?app=salebot.chatter
Поиск приложения
Приложение Salebot - Установить
Окно установки

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

Домен необходимо взять из адресной строки битрикса, он уникальный для каждой CRM. Например, http://testsalebot.bitrix24.ru, нас интересует здесь текст "testsalebot".
Далее переходим в раздел "Интеграции с CRM" на сайте salebot.pro. Вводим наш домен и региональную зону, как показано на рисунках ниже.
Где найти интеграцию с Битрикс
Жмем на кнопку "Подключить Bitrix24". На этом интеграция закончена, все очень просто.

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

Рассмотрим пример работы. Для примера создадим воронку, которая запрашивает у человека адрес и отправляет заявку в битрикс
И пройдем по воронке в любом мессенджере
И эта заявка автоматически отправляется в битрикс. Создается лид, потом битриксом создается сделка на основании этого лида.
Дополнительно можно настроить уведомления на электронную почту
И уведомления придут на почту:
Имя клиента записывается в его контакт, если в диалоге заполнится поле ввода с названием phone или email, то они также пойдут в контакт.

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

В битриксе есть два режима работы CRM: Простой и Классический
При первом подключении битрикса к проекту в настройках проекта -> Общие переменные, добавится переменная со значением включенного у вас режима CRM bitrix_crm_mode
1 - классический режим (режим работы с Лидами) 2 - простой режим (без Лидов)
Если после подключения битрикс в сейлбот, вы изменили режим CRM в битрикс, то в обязательном порядке измените его и в настройках проекта в сейлбот (bitrix_crm_mode)

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

Вы также можете заполнить пользовательские поля битрикса, а также встроенные у сделок и лидов. Каждое поле указывается с новой строки. Сначала идет код поля в Bitrix24, затем название переменной в Salebot, которая запишется в него. Для встроенного поля просто укажите его имя, например UTM_SOURCE
Список стандартных полей битрикс, можно посмотреть:
Столбец Поле
Записать поля по имени можно только те, у которых тип 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

Вы можете общаться с клиентами из открытых линий. Для этого в окне подключения необходимо включить переключатель "Подключить к открытым линиям"
Название открытой линии менять запрещено! Произойдут невозвратные изменения
При работе в расширенном режиме переменные будут записываться в поле сделки, в которой происходит диалог, а не в лид. Как это происходит в расширенном режиме без открытых линий.
Обратите внимание, что новый лид будет создан только при получении информации, необходимой для обратного обращения к клиенту. Если клиент обратился через соцсеть или внешний мессенджер (т.е. когда есть, куда обратно написать ответ), Лид будет создан. Если при подключении онлайн-чата на сайте клиент напишет в линию и не укажет какие-либо данные о себе, а потом уйдет с сайта, то обратно клиенту уже не написать, он просто никак не получит сообщение, поэтому такой Лид CRM не зафиксирует
Если вы переходите на Salebot с другой платформы, то старые диалоги не будут работать, так как открытая линия создана прошлой платформой. Вам необходимо будет написать первым заново, для создания диалога через Salebot
Could not load image
Рисунок 9
Больше настраивать ничего не нужно. Ниже представлены скрины, демонстрирующие работу.
Could not load image
Could not load image

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

Переходим в Контакт-Центр, находим Salebot и выбираем открытую линию Линия для подключения Salebot.pro
В открывшемся окне настраиваем ответственных.
Название открытой линии менять запрещено! Произойдут невозвратные изменения
После отправки данных желтым или красным блоком в salebot, ответственным станет тот, чей идентификатор указан в настройках подключения битрикс24 в сейлбот
Так же ответственного можно изменять с помощью методов в калькуляторе:

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

Название открытой линии менять запрещено! Произойдут невозвратные изменения
Если у вас дубли сообщений из битрикс, то нужно сделать следующее
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

Все нужные нам вебхуки настраиваются в роботах
Далее нажимаем любую из кнопок Добавить
Далее либо добавляем вебхук, либо редактируем существующий
Для передачи каких-либо данных из битрикс в сейлбот используются роботы
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 и более параметра, то приоритет следующий:
  1. 1.
    line
  2. 2.
    contact_id
  3. 3.
    lead_id
  4. 4.
    deal_id
например одновременно переданы deal_id и contact_id, система будет искать пользователя по contact_id, так как приоритет у него выше, а deal_id просто проигнорирует.
Это обязательная часть, чтоб определить от кого пришел колбек, далее можно отправить нужные вам данные, которые добавятся к сделке в salebot.
Данные передаются следующим образом: &имя_переменной={{значение}}
Пример ссылки, передающей переменные: https://chatter.salebot.pro/bitrix_webhook/b24-b4qrod..{{Контакт: Контакт Открытая линия}}&stage={{Стадия сделки}}&maker={{Создатель сделки}}
Внимательно посмотрите на пример с передачей стадии Лида или Сделки в сейлбот.
Имена переменных, которые зарезервированы системой: line, lead_id, deal_id, bitrix_lead_id, bitrix_deal_id, bitrix_contact_id
Так передаваемые переменные называть нельзя, данные просто не запишутся.

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

Для других событий делается аналогичным образом
Для получения уведомлений о смене статуса лида или сделки необходимо установить в настройках роботов Webhook, для нужного этапа.
К адресу дописываем переменную: &stage={{Статус}} - она добавит клиенту в сейлбот переменную stage с названием стадии.
Пример для работы с лидами:
Обязательно нажимаем на обе кнопки сохранить!
Пример работы со сделками:
Данный вебхук необходимо скопировать в каждую стадию, информацию о которой вы хотите видеть в переписке и в переменных
После изменения статуса проекта придет уведомление с текстом, будто это написал клиент(но это сообщение будет видно только в интерфейсе salebot.pro): bitrix_stage Название стадии
Остальные данные запишутся клиенту:
Далее вы можете использовать данное сообщение как условие у блока в редакторе и отправить пользователю сообщение, соответствующее такому переходу.

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

Для других событий делается аналогичным образом
Сообщения настраиваются в меню “роботы”
На нужном этапе нажимаем кнопку Добавить -> Для связи с клиентом -> Сообщение в Открытую линию
Пишем шаблон сообщения, также справа по нажатию на три точки, можно вставить нужные данные, например имя.
После того как сообщение подготовлено, нажимаем два раза Сохранить. Теперь при переходе в этот этап клиенту будет отправлено ваше сообщение.

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

Для запуска бота из битрикс в сейлбот используются роботы. Для этого на нужном этапе в битрикс нужно настроить робота.
Работает только для 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

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

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

Функции (API) для работы с Битрикс

Функции (API) в калькуляторе
Salebot.pro
Last modified 5mo ago
Copy link
On this page
Как подключить Битрикс
Авторизуйтесь на сайте.
Пример работы
Как задать режим работы
Как заполнить поля сделок и лидов
Как узнать ID пользовательского поля
Как создать пользовательское поле
Как подключить открытые линии Bitix24
Как назначить ответственного при создании лида открытой линией
Возможные ошибки подключения
Как убрать сообщения от Битрикс24
Как написать первым в Whatsapp
Как настроить Webhook в Bitrix24
Как запустить бота при смене статуса сделки
Как отправить сообщения клиенту при смене этапа Сделки/Лида
Как запустить бота роботом Битрикс
Функции (API) для работы с Битрикс