Интеграция с Битрикс24
Конструктор не умеет получать данные из Битрикс 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.
Жмем на кнопку "Подключить Bitrix24". На этом интеграция закончена, все очень просто.
Рассмотрим пример работы. Для примера создадим воронку, которая запрашивает у человека адрес и отправляет заявку в битрикс (Рисунок 3)
И пройдем по воронке в любом мессенджере (Рисунок 4)
И эта заявка автоматически отправляется в битрикс. Создается лид, потом битриксом создается сделка на основании этого лида.(Рисунок 5)
Дополнительно можно настроить уведомления на электронную почту (Рисунок 6)
И уведомления придут на почту (рисунок 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 уже созданного Вами поля, необходимо:
открыть Ваш 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
Вы можете общаться с клиентами из открытых линий. Для этого в окне подключения необходимо включить переключатель "Подключить к открытым линиям"
При работе в расширенном режиме переменные будут записываться в поле сделки, в которой рпоисходит диалог, а не в лид. Как это происходит в расширенном режиме без открытых линий.
Если вы переходите на Salebot с другой платформы, то старые диалоги не будут работать, так как открытая линия создана прошлой платформой. Вам необходимо будет написать первым заново, для создания диалога через Salebot
Больше настраивать ничего не нужно. Ниже представлены скрины, демонстрирующие работу.
Если в диалоге с клиентом вы обнаружили сообщения типа "Вам ответит первый освободившийся оператор." или "Оцените качество обслуживания", то надо внести изменения в настройки открытой линии.
Для этого в меню Битрикс24 найдите пункт Контакт-центр. Пройдите в этот раздел и кликните по значку Salebot:
Внутри выберите Линия для подключения Salebot и кликните Настроить:
В настройках этой линии отключите ненужные пункты и подключите нужные вам:
Этот функционал может подключить только администратор Bitrix24
Заполняем обязательный поля Имя, Фамилия, ну и нам конечно нужен номер телефона:
Нажимаем Сохранить.
Далее кликаем два раза на контакте, которому нужно написать и справа в меню нажимаем на появившуюся кнопку "Написать в Whatsapp":
По нажатию на которую, откроется меню приложения Salebot:
Если у контакта больше одного номера телефона, то приложение от Salebot предложит выбрать один из них.
Если у Вас подключено несколько WhatsApp номеров в проекте на Salebot, у вас также есть выбор с какого из них написать.
После ввода сообщения и выбора нужного нужных параметров, нажимаем кнопку "Отправить сообщение".
После успешной отправки получаем во кладке с приложением сообщение: Сообщение отправлено! Закройте эту вкладку и перейдите в диалог с клиентом.
А справа вверху получим всплывающее сообщение, что открыта новая линия с контактом, по нажатию на которое переходим в чат с клиентом.
Писать первым из Битрикс24 можно только в WhatsApp.
Все нужные нам вебхуки настраиваются в роботах
Далее нажимаем любую из кнопок Настроить роботов
Далее добавляем вебхук либо редактируем существующий
Для передачи каких-либо данных из битрикс в сейлбот используются роботы
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 Название стадии
Остальные данные запишутся клиенту:
Далее вы можете использовать данное сообщение как условие у блока в редакторе и отправить пользователю сообщение, соответствующее такому переходу.
