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

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

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

Подключение

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

Для интеграции с 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, то они также пойдут в контакт.

Заполнение полей сделок и лидов

Вы также можете заполнить пользовательские поля битрикса, а также встроенные у сделок и лидов. Каждое поле указывается с новой строки. Сначала идет код поля в 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

Столбец Поле

Как узнать 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

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

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

Если вы переходите на 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:

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}}

Это обязательная часть, чтоб определить от кого пришел колбек, далее можно отправить нужные вам данные, которые добавятся к сделке в 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 Название стадии

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

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