Битрикс24

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