Настройка и работа интеграции Битрикс24 (Bitrix24)

В данной статье мы разберём работу и настройки интеграциу вашего бота с системой Битрикс24 (Bitrix24) и её возможности.
В этой статье

В данной статье мы разберём работу и настройку интеграции вашего бота с системой Битрикс24 (Bitrix24) и её возможности.

 

Подключение

df689aa142970e9dfcb4973e3d1f8cbf.png

1. Войдите или зарегистрируйтесь в Битрикс24 и скопируйте ссылку на свой личный кабинет, пример: https://*******.bitrix24.ru/

88bb01037af9116d4eb890467499b17f.png

2. Перейдите к настройкам интеграции в личном кабинете: Бот — Настройки — Интеграции — Битрикс24 — Настроить интеграцию.

e53ffe2cbf1cc8890a110d0baebd6abe.png

3. Вставьте скопированную ссылку на личный кабинет Битрикс24 в поле ввода первого шага и нажмите кнопку "Сохранить".

f5305c934ebbfa3cc0a388011455c13a.png7e813da1b6009571fd361a1526c5b89a.png

4. По кнопке во втором шаге или по ссылке https://www.bitrix24.ru/apps/app/puzzlebot.puzzlebot/ перейдите в личный кабинет Битрикс24 и установите приложение PuzzleBot.

6033a9f8a227c97c38b07f36e98846f0.jpg

5. По окончанию установки отобразится окно приложения с результатом связки аккаунтов.

96bbb1e0be4d0cb06b05e84d0828f749.png

6. Вернитесь в личный кабинет PuzzleBot и нажмите “Продолжить”.

7f84bb0e1563f32edd6cb7c5d1b5a267.png

7. Укажите нужные поля и переменные для записи Telegram User ID пользователя и Имени или оставьте всё как есть и нажмите “Подключить интеграцию”.

 

Настройки

Разберём настройки интеграции по подвкладкам.

Важно! Все действия с контактами, лидами и сделками происходят на основе Telegram User ID пользователя, в случае изменения данного поля в Битрикс24 — действие не будет выполнено.

Контакты

На подкладке можно:

  1. Настроить синхронизацию контактов Битрикс24 и пользователей вашего бота.
  2. Разово добавить пользователей бота в клиентов Битрикс24
  3. Разово добавить клиентов Битрикс24 в пользователей бота
08e85be01d2862beb84648ea6aa36e96.png

Перед перечисленными выше действиями необходимо связать переменные PuzzleBot с полями контакта в Битрикс24.

Вы можете задать названия несуществующих полей и они будут созданы автоматически. 

Важно! Связанные переменные и поля при активной синхронизации будут заменять информацию на актуальную где бы она не была изменена, то есть изменив значение в поле Битрикс24 — значение переменной PuzzleBot будет изменено тоже и наоборот. Исключением являются связки со стрелками.

738490fe4add8167b596427d50f7a8b4.png

Для активации синхронизации необходимо нажать на соответствующую кнопку. Синхронизации будет активна вплоть до отмены или смены ссылки на личный кабинет Битрикс24. 

Сделки и Лиды

c6e37c7422fa5e2b04a00bcefc247354.png

Финальные стадии / этапы — настройка позволяет определить с какой стадии или этапа система может игнорировать сделки и лиды. 
Например: проверка на наличие сделки пришлёт отрицательный ответ, если сделка перешла в финальную стадию.

Несколько Сделок / Лидов от одного пользователя — разрешает создавать 2 и более Сделки / Лида от одного пользователя. 

Игнорировать Сделки / Лиды в финальном стадии / этапе — работает в паре с настройкой финальных стадий, разрешает или запрещает игнорирование.

3c96a5cde04145a5762b6373d60416b6.png

Уведомление о смене стадии / этапа — позволяет настроить отправку команды при переходе Сделки / Лида из одной студии / этапа в другой.

Важно! При включении функции Игнорировать Сделки / Лиды в финальном этапе уведомление на финальные этапы / стадии отправлено не будет.

 

Действия

Разберём виды доступных действий для работы с Битрикс24.

f40c4dccba4b263ba36afdcd49e5f3bc.png

Сделки и Лиды

Доступны следующие типы:

  1. Создать лид / сделку
  2. Изменить поле лида / сделки
  3. Изменить статус лида / сделки
  4. Удалить лид / сделки

Большая часть настроек понятны, разберём особенные:

a325bd8ccd88487e2a13028b9374d37d.png

Запись в поле — записывает значение указанное со стороны PuzzleBot :// в указанное поле внутри лида или сделки. Со стороны PuzzleBot :// в строку ввода может быть указан текст, число, формула или переменная.

Важно! Нельзя указывать запись в несуществующие поля лида или сделки.

ef6feefb74e4549f07c55f6993b7b629.png

Привязка к пользователю — определяет кто будет указан в информации о лиде / сделки контакт или Telegram User ID пользователя.

Важно! При выборе “По контакту” контакт должен быть предварительно создан в Битрикс24, при активной синхронизации это делается автоматически.

aaa87877fab95307b27bc86d1da04483.png

Активный лид / сделка — определяет с каким лидом или сделкой работать. Актуально при включении функции в настройках “Несколько лидов / сделок от одного пользователя”.

Контакт

Доступны следующие типы:

  1. Создать контакт
  2. Удалить контакт

 

Проверки

Разберём виды доступных проверок для работы с Битрикс24.

bb50988857ba74cc2a73b61163374976.png

Сделки и Лиды

Доступны следующие типы:

  1. Наличие лида / сделки
  2. Статус лида / сделки
  3. Значение поля лида / сделки

Контакты

Доступны следующие типы:

  1. Наличие контакта
  2. Значение поля контакта