Битрикс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 уже созданного Вами поля, необходимо:
- открыть Ваш 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.
Примеры записи кастомных полей Битрикс показаны на рисунке ниже
Вы можете общаться с клиентами из открытых линий. Для этого в окне подключения необходимо включить переключатель "Подключить к открытым линиям"
Название открытой линии менять запрещено! Произойдут невозвратные изменения
При работе в расширенном режиме переменные будут записываться в поле сделки, в которой происходит диалог, а не в лид. Как это происходит в расширенном режиме без открытых линий.
Обратите внимание, что новый лид будет создан только при получении информации, необходимой для обратного обращения к клиенту. Если клиент обратился через соцсеть или внешний мессенджер (т.е. когда есть, куда обратно написать ответ), Лид будет создан. Если при подключении онлайн-чата на сайте клиент напишет в линию и не укажет какие-либо данные о себе, а потом уйдет с сайта, то обратно клиенту уже не написать, он просто никак не получит сообщение, поэтому такой Лид CRM не зафиксирует
Если вы переходите на Salebot с другой платформы, то старые диалоги не будут работать, так как открытая линия создана прошлой платформой. Вам необходимо будет написать первым заново, для создания диалога через Salebot
Рисунок 9
Больше настраивать ничего не нужно. Ниже представлены скрины, демонстрирующие работу.
Переходим в Контакт-Центр, находим Salebot и выбираем открытую линию Линия для подключения Salebot.pro
В открывшемся окне настраиваем ответственных.
Название открытой линии менять запрещено! Произойдут невозвратные изменения
После отправки данных желтым или красным блоком в salebot, ответственным станет тот, чей идентификатор указан в настройках подключения битрикс24 в сейлбот
Так же ответственного можно изменять с помощью методов в калькуляторе:
Название открытой линии менять запрещено! Произойдут невозвратные изменения
Если у вас дубли сообщений из битрикс, то нужно сделать следующее
1. Отключить битрикс во всех проектах Salebot.
2. Отключить интеграцию Salebot в битрикс.
3. Salebot заново интегрировать в битрикс.
4. Подключить битрикс к одному проекту Salebot.
Если подключение идет в 2 и более проекта 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 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.line
- 2.contact_id
- 3.lead_id
- 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
https://chatter.salebot.pro/bitrix_webhook/domain.bitrix24.ru/robots_webhook?callback=1&lead_id={{ID}}&phone={{Рабочий телефон}}&name={{Название лида}}&whatsapp_id=19786&text=start
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.Поставить курсор в место, куда будет вставлена переменная
- 2.Нажать троеточие, для вызова меню
- 3.Выбрать нужную переменную
Когда все настроено, в воронке можно настроить отправку сообщение на полученное уведомление. Например если из битрикс вы отправляете стандартный текст уведомления, то можно настроить следующим образом:
Last modified 9mo ago