Битрикс24

Search…
Битрикс24
Подключаем бота к CRM Битрикс, учимся создавать кастомные поля
Конструктор не умеет получать данные из Битрикс 24, но вы можете передавать данные вызвав из Битрикс 24 наши методы апи, которые описаны в API конструктора​
Так же для работы с Битрикс24 есть методы,описанные в разделе АПИ в калькуляторе: https://docs.salebot.pro/peremennye-1/api-v-kalkulyatore#api-bitriks24​
​Как подключить Битрикс​
​Как задать режим работы​
​Как заполнить поля сделок и лидов​
​Как создать пользовательское поле​
​Как подключить открытые линии Bitix24​
​Как назначить ответственного при создании лида открытой линией​
​Возможные ошибки подключения​
​Как убрать сообщения от Битрикс24​
​Как написать первым в Whatsapp​
​Как настроить Webhook в Bitrix24​
​Как запустить бота при смене статуса сделки​
​Как отправить сообщения клиенту при смене этапа Сделки/Лида​
​Как запустить бота роботом битрикс​
​Функции (API) для работы с Битрикс​
Как подключить Битрикс
Вначале нужно установить приложение в битрикс и после этого подключить в сейлбот. Если сделать наоборот то не появляется карточка в контакт-центре.
Для интеграции с 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: Простой и Классический
Could not load image
При первом подключении битрикса к проекту в настройках проекта -> Общие переменные, добавится переменная со значением включенного у вас режима CRM bitrix_crm_mode
Could not load image
1 - классический режим (режим работы с Лидами)
2 - простой режим (без Лидов)
Если после подключения битрикс в сейлбот, вы изменили режим CRM в битрикс, то в обязательном порядке измените его и в настройках проекта в сейлбот (bitrix_crm_mode)
Как заполнить поля сделок и лидов
Вы также можете заполнить пользовательские поля битрикса, а также встроенные у сделок и лидов. 
Каждое поле указывается с новой строки. Сначала идет код поля в 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​
Столбец Поле
Could not load image
Записать поля по имени можно только те, у которых тип 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 → Настройки → Настройки форм и отчетов → Пользовательские поля → Лид (Список поле);
Could not load image
Could not load image
в списке найти ваше поле и перейти в него;
Could not load image
в поисковой строке, в конце url, вы увидите значение UF_CRM_XXXXXXXXXX
Could not load image

https://ваш-домен.bitrix24.ru/crm/configs/fields/CRM_LEAD/edit/UF_CRM_XXXXXXXXXX/ Здесь UF_CRM_XXXXXXXXXX — это и есть ID
Если у вас нет еще пользовательского поля, то для начала вам необходимо его создать, после чего Вы сможете узнать его ID.
Как создать пользовательское поле
Для создания вашего пользовательского поля, необходимо:
открыть Ваш Bitrix 24;
перейти в раздел CRM → Настройки → Настройки форм и отчетов → Пользовательские поля → Лид (Добавить поле);
задать название поля;
поставить галочку для «Показывать в списке»;
желательно использовать тип поля «Строка»;
сохранить
Could not load image
Только после того как вы создадите пользовательское поле можно узнать его ID.
Примеры записи кастомных полей Битрикс показаны на рисунке ниже
Как подключить открытые линии Bitix24
Вы можете общаться с клиентами из открытых линий. Для этого в окне подключения необходимо включить переключатель "Подключить к открытым линиям"
Название открытой линии менять запрещено! Произойдут невозвратные изменения
При работе в расширенном режиме переменные будут записываться в поле сделки, в которой происходит диалог, а не в лид. Как это происходит в расширенном режиме без открытых линий.
Обратите внимание, что новый лид будет создан только при получении информации, необходимой для обратного обращения к клиенту. Если клиент обратился через соцсеть или внешний мессенджер (т.е. когда есть, куда обратно написать ответ), Лид будет создан. Если при подключении онлайн-чата на сайте клиент напишет в линию и не укажет какие-либо данные о себе, а потом уйдет с сайта, то обратно клиенту уже не написать, он просто никак не получит сообщение, поэтому такой Лид CRM не зафиксирует
Если вы переходите на Salebot с другой платформы, то старые диалоги не будут работать, так как открытая линия создана прошлой платформой. Вам необходимо будет написать первым заново, для создания диалога через Salebot
Could not load image
Рисунок 9
Больше настраивать ничего не нужно. Ниже представлены скрины, демонстрирующие работу.
Could not load image
Could not load image
Как назначить ответственного при создании лида открытой линией
Переходим в Контакт-Центр, находим Salebot и выбираем открытую линию Линия для подключения Salebot.pro 
В открывшемся окне настраиваем ответственных.
Название открытой линии менять запрещено! Произойдут невозвратные изменения
После отправки данных желтым или красным блоком в salebot, ответственным станет тот, чей идентификатор указан в настройках подключения битрикс24 в сейлбот
Так же ответственного можно изменять с помощью методов в калькуляторе:
​https://docs.salebot.pro/peremennye-1/api-v-kalkulyatore#kak-izmenit-otvetstvennogo​
Возможные ошибки подключения
Название открытой линии менять запрещено! Произойдут невозвратные изменения
Если у вас дубли сообщений из битрикс, то нужно сделать следующее
1. Отключить битрикс во всех проектах Salebot.
2. Отключить интеграцию Salebot в битрикс.
3. Salebot заново интегрировать в битрикс.
4. Подключить битрикс к одному проекту Salebot.

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

Как написать первым в Whatsapp
Этот функционал может подключить только администратор Bitrix24
Заполняем обязательный поля Имя, Фамилия, ну и нам конечно нужен номер телефона:

Could not load image
Нажимаем Сохранить.
Далее кликаем два раза на контакте, которому нужно написать и справа в меню нажимаем на появившуюся кнопку "Написать в Whatsapp":

По нажатию на которую, откроется меню приложения Salebot:
Could not load image
Если у контакта больше одного номера телефона, то приложение от Salebot предложит выбрать один из них.
Если у Вас подключено несколько WhatsApp номеров в проекте на Salebot, у вас также есть выбор с какого из них написать.
После ввода сообщения и выбора нужного нужных параметров, нажимаем кнопку "Отправить сообщение".
После успешной отправки получаем во кладке с приложением сообщение:
Сообщение отправлено! Закройте эту вкладку и перейдите в диалог с клиентом.
А справа вверху получим всплывающее сообщение, что открыта новая линия с контактом, по нажатию на которое переходим в чат с клиентом.

Could not load image
Писать первым из Битрикс24 можно только в WhatsApp.
Как настроить Webhook в Bitrix24
Все нужные нам вебхуки настраиваются в роботах
Could not load image
Далее нажимаем любую из кнопок Добавить
Далее либо добавляем вебхук, либо редактируем существующий
Для передачи каких-либо данных из битрикс в сейлбот используются роботы
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 Название стадии
Остальные данные запишутся клиенту:
Could not load image
Далее вы можете использовать данное сообщение как условие у блока в редакторе и отправить пользователю сообщение, соответствующее такому переходу.
Как отправить сообщения клиенту при смене этапа Сделки/Лида
Для других событий делается аналогичным образом
Сообщения настраиваются в меню “роботы”
Could not load image
На нужном этапе нажимаем кнопку 
Добавить -> Для связи с клиентом -> Сообщение в Открытую линию
Пишем шаблон сообщения, также справа по нажатию на три точки, можно вставить нужные данные, например имя.
После того как сообщение подготовлено, нажимаем два раза Сохранить.
Теперь при переходе в этот этап клиенту будет отправлено ваше сообщение.
Как запустить бота роботом Битрикс
Для запуска бота из битрикс в сейлбот используются роботы. Для этого на нужном этапе в битрикс нужно настроить робота.
Работает только для WhatsApp
Could not load image
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)
Could not load image
Структура переменной в урл адресе следующая:
&phone={{Контакт: Рабочий телефон}}
& - знак амперсанда, для указания браузеру, что дальше название переменной
phone - название переменной
= - указание на то, что дальше значение переменной
{{Контакт: Рабочий телефон}} - значение переменной
То есть, если вам не нужно передавать, например текст, то нужно удалить из урл-адреса вот эту часть: &text=start
Чтобы вставить нужное значение (переменную) из битрикс
Could not load image
1.Поставить курсор в место, куда будет вставлена переменная
2.Нажать троеточие, для вызова меню
3.Выбрать нужную переменную
Когда все настроено, в воронке можно настроить отправку сообщение на полученное уведомление. Например если из битрикс вы отправляете стандартный текст уведомления, то можно настроить следующим образом:
Функции (API) для работы с Битрикс
Функции (API) в калькуляторе
Salebot.pro