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 (Рисунок 1)
3. Авторизуйтесь на сайте.
Домен необходимо взять из адресной строки битрикса, он уникальный для каждой CRM. Например, http://testsalebot.bitrix24.ru, нас интересует здесь текст "testsalebot".
Далее переходим в раздел "Интеграции с CRM" на сайте salebot.pro. Вводим наш домен и региональную зону, как показано на рисунке 2.
Рисунок 2
Жмем на кнопку "Подключить Bitrix24". На этом интеграция закончена, все очень просто.
Рассмотрим пример работы. Для примера создадим воронку, которая запрашивает у человека адрес и отправляет заявку в битрикс (Рисунок 3)
Рисунок 3
И пройдем по воронке в любом мессенджере (Рисунок 4)
Рисунок 4
И эта заявка автоматически отправляется в битрикс. Создается лид, потом битриксом создается сделка на основании этого лида.(Рисунок 5)
Рисунок 5
Дополнительно можно настроить уведомления на электронную почту (Рисунок 6)
Рисунок 6
И уведомления придут на почту (рисунок 7)
Рисунок 7
Имя клиента записывается в его контакт, если в диалоге заполнится поле ввода с названием 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.
Примеры записи кастомных полей Битрикс показаны на рисунке 8
Рисунок 8

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

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

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

Если в диалоге с клиентом вы обнаружили сообщения типа "Вам ответит первый освободившийся оператор." или "Оцените качество обслуживания", то надо внести изменения в настройки открытой линии.
Рисунок 12
Для этого в меню Битрикс24 найдите пункт Контакт-центр. Пройдите в этот раздел и кликните по значку Salebot:
Рисунок 13
Внутри выберите Линия для подключения Salebot и кликните Настроить:
Рисунок 14
В настройках этой линии отключите ненужные пункты и подключите нужные вам:
Рисунок 15
Рисунок 16
Рисунок 17

Как написать первым в 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.
    Выбрать нужную переменную
Когда все настроено, в воронке можно настроить отправку сообщение на полученное уведомление. Например если из битрикс вы отправляете стандартный текст уведомления, то можно настроить следующим образом:
Last modified 23d ago