Каталог решений - «БИП: Бизнес-Процессы». Интеграция с Telegram и Конструктор чат-ботов

Всем здравствуйте!

Это продолжение предыдущих частей Часть №1, Часть №2, Часть №3, Часть №4 и Часть №5, в которых речь шла о различных вариантах и аспектах использования системы «БИП: Бизнес-Процессы».

• Часть №1: «БИП: Бизнес-Процессы». Примеры использования. Часть №1.
• Часть №2: «БИП: Бизнес-Процессы». Примеры использования. Часть №2.
• Часть №3: «БИП: Бизнес-Процессы». Примеры использования. Часть №3. Права и связи.
• Часть №4: «БИП: Бизнес-Процессы». Примеры использования. Часть №4. Графика.
• Часть №5: «БИП: Бизнес-Процессы». Примеры использования. Часть №5. Система оповещений.

Программный продукт «БИП: Бизнес-Процессы» предназначен для настройки произвольных бизнес-процессов в пользовательском режиме в любых конфигурациях 1С, работающих на технологической платформе «1С:Предприятие 8.3» в режиме управляемого приложения. Продукт может использоваться как отдельная конфигурация для моделирования бизнес-процессов, как дополнение для встраивания в существующие конфигурации и как расширение. Каждый вариант сертифицирован и имеет официальный статус «1С:Совместимо!».

Программный продукт предлагается в 2 вариантах:

• Основная поставка «БИП: Бизнес-Процессы»;
• Базовая версия Расширение для настройки бизнес-процессов «Зодиак».

Система автоматических оповещений устанавливается как отдельное расширение «Сигнал» и позволяет отправлять автоматические и ручные сообщения пользователям следующими способами:

•  в штатной системе взаимодействия,
•  по электронной почте,
•  в Telegram.

Эта часть будет посвящена мессенджеру Telegram и его использованию в рамках системы «БИП: Бизнес-Процессы» (или её базовой версии «Зодиак»), начиная с версии 1.0.3.6.

Содержание

1. Общие сведения
2. Пример использования Telegram для автоматических оповещений
3. Пример использования Telegram для отправки сообщений вручную
4. Пример использования чат-бота в Telegram для взаимодействия с системой
5. Конструктор чат-ботов
6. Настройка интеграции с Telegram
7. Дополнение: программный код
8. Заключение

Общие сведения

Для демонстрации примеров, приведенных в данной статье, нам потребуется:

• «БИП: Бизнес-Процессы» (или её базовая версия «Зодиак»),
• Расширение для автоматических оповещений «Сигнал» (входит в комплект основной поставки),
• Telegram-клиент (мобильная версия или версия для компьютера).

Для демонстрации примеров подсистема «БИП: Бизнес-Процессы» подключена к типовой конфигурации «1С:Управление Торговлей», ред. 11.4. Это могла бы быть любая другая типовая (или нетиповая) конфигурация. Механизмы настройки и использования одинаковы для всех конфигураций.

Подробное описание подключения и настройки расширения для автоматических оповещений «Сигнал» приводится в статье «БИП: Бизнес-Процессы». Примеры использования. Часть №5. Система оповещений. В настоящей статье приводятся только нюансы, непосредственно связанные с Telegram.

↑Наверх

Пример использования Telegram для автоматических оповещений

Для примера создадим самый простой сценарий, состоящий из 1 шага. Это будет шаг — «Согласование договора».

Для процесса и задачи по нему укажем сроки выполнения (это необязательно, но сроки выполнения мы позже увидим в полученных сообщениях):

Исполнителя для задачи указывать не будем. В этом случае исполнителем будет назначен пользователь, запустивший новый процесс.

В рамках данного примера этого вполне достаточно.

Сценарий к использованию готов. Теперь по нему можно в любое время запускать новые процессы «согласования договоров».

Теперь осталось научить программу, чтобы по данному сценарию она отправляла сообщения в Telegram.

Для этого откроем настройки оповещений по текущему сценарию и добавим 2 оповещения:

• Telegram-оповещение при запуске процесса с текстом сообщения «Запущен новый процесс». Получатель сообщения — Автор процесса (пользователь, запустивший новый процесс по сценарию).
• Telegram-оповещение при создании новой задачи с текстом сообщения «Вам поставлена новая задача». Получатель сообщения — Исполнитель задачи (в нашем случае это тот же пользователь, который запустил процесс).

Всё готово.

После того, как пользователь запустит новый процесс (или процесс будет запущен автоматически), указанные в настройках оповещений пользователи получат сообщения в Telegram.

В зависимости от Telegram-клиента, точнее от его версии (для компьютера или для смартфона) и платформы (Windows, Android, iOS) форматирование сообщений может незначительно отличаться. При этом, текстовое наполнение будет одним и тем же.

В настройках оповещения, при вводе текста сообщения, доступно форматирование, а также использование эмодзи.

Полученное в данном случае сообщение будет иметь жирную подчеркнутую строку «Важно! Обратите внимание на срок выполнения».

↑Наверх

Пример использования Telegram для отправки сообщений вручную

Кроме автоматических оповещений в рамках расширения «Сигнал» доступно ручное создание и отправка сообщений в Telegram.

Для этого, в списке сообщений следует добавить новое сообщение, указать получателя, выбрать тип оповещения Telegram и написать сообщение.

Для немедленной отправки следует нажать . Сообщение будет отправлено.

Если требуется отложенная отправка сообщения, то в новом сообщении следует указать дату и время, когда сообщение должно быть отправлено.

Сообщение будет отображаться в общем списке с отметкой об отложенной отправке.

В указанное время сообщение будет отправлено получателю автоматически.

↑Наверх

Пример использования чат-бота в Telegram для взаимодействия с системой

Кроме использования настроенного ранее чат-бота для отправки автоматических уведомлений и ручных сообщений, этот чат-бот может использоваться, также, и для ряда дополнительных функций.

Пользователь данного чат-бота может выполнять следующие функции, находясь в мессенджере Telegram:

• Создавать новую задачу для себя или для другого исполнителя,
• Запускать новый процесс по выбранному сценарию,
• Видеть список своих задач,
• Отмечать выполнение своих задач.

Рассмотрим эти функции по порядку.

Для того, чтобы начать работу с этими функциями пользователь должен написать команду Меню.

После этого появится 3 новых кнопки: Мои задачи, Новая задача, Новый процесс.

При нажатии кнопки Новая задача, бот предложит ввести данные о новой задаче в формате [Описание], [Исполнитель], [Срок], [Важная].

Срок, при этом, можно указывать в различных вариантах: 06.02 14:00, 06.02.21 14:00, 06.02.2021 14:00, 6.2 14:00, 6.2. Если указать число — количество дней, то срок будет рассчитан от текущей даты по указанному количеству дней.

После ввода данных, в основной базе будет создана новая задача.

Информация о созданной задаче будет показана в окне сообщений…

…, а в базе данных появится новая задача для выполнения.

Пользователь, который был назначен исполнителем новой задачи, также, получит уведомление в Telegram о новой задаче и о том, кто её создал.

Следующим пунктом меню является пункт создания и запуска новых процессов.

При нажатии кнопки Новый процесс, бот предложит выбрать один из доступных сценариев и ввести дополнительное описание для запускаемого процесса.

После этого в системе будет автоматически запущен новый процесс по выбранному сценарию.

Информация о новом процессе будет показана в окне сообщений…

…, а в базе данных появится новый активный процесс.

Если в настройках сценария включена настройка «Ручной старт новых процессов», то новый процесс не будет запущен, а будет только записан в статусе «Создан». И сообщение будет содержать не строку «Создан и запущен новый процесс», а «Создан новый процесс».

Следующий пункт меню — создание новых задач.

При нажатии кнопки Мои задачи, бот покажет список задач, которые необходимо выполнить текущему пользователю.

При выборе задачи будет предложено 2 кнопки: Подробнее… и Выполнена.

При нажатии кнопки Подробнее… будет показана подробная информация о задаче.

При нажатии кнопки Выполнена бот предложит ввести комментарий по задаче, после чего задача будет выполнена.

Этот функционал похож на функционал выполнения задач по электронной почте, который, также, доступен в рамках расширения «Сигнал».

В том случае, если по задаче, кроме комментария, требуется ввести дополнительные данные, то бот сообщит об этом.

Общий список команд, доступных в чат-боте (для расширения «Сигнал» версии 1.0.1.3):

• /Start, Старт,
• Мой ключ, мк,
• Ме ню,
• Без меню, бм,
• Мои задачи, мз, Задачи,
• Новая задача, нз,
• Новый процесс, нп.

↑Наверх

Настройка интеграции с Telegram

Инструкция по настройке расширения «Сигнал» для использования с Telegram — Настройка системы «Сигнал» для использования с Telegram.pdf, входит в комплект основной поставки.

Для настройки интеграции потребуется не более 30 минут.

Порядок настройки следующий:

• Создание нового чат-бота в Telegram,
• Настройка подключения чат-бота в расширении «Сигнал»,
• Запуск чат-бота,
• Подключение пользователей к чат-боту.

Подробности настройки по каждому пункту доступны в инструкции.

Здесь будут приведены только скриншоты настройки на примере Telegram-клиента для Windows:

1. Создание нового чат-бота и получение токена

2. Ввод токена в настройках расширения «Сигнал» и проверка токена

3. Получение ключа пользователя

4. Ввод ключа пользователя в расширении «Сигнал»

↑Наверх

Конструктор чат-ботов

Выше была продемонстрирована работа основного чат-бота, предназначенного для рассылки автоматических уведомлений, для отправки ручных сообщений, а также для базовой работы с задачи и процессами.

Но, кроме основного чат-бота, в системе могут быть созданы дополнительные произвольные чат-боты для решения различных задач коммуникации как внутри организации, так и с внешним миром.

Для ведения списка чат-ботов предназначен отдельный справочник Чат-боты.

Для примера создадим самый простой чат-бот и попробуем его чему-нибудь научить.

Перед этим получим токен нового чат-бота. О том, как получить новый токен было написано выше.

Укажем токен нашего чат-бот и его описание.

Т.к. чат-бот ещё ничего не умеет, на закладке Дополнительно заполним поле Ответ на неизвестный запрос.

Этими словами чат-бот будет отвечать всегда, когда не будет знать, что ответить.

В своём минимальном исполнении новый чат-бот системы «Сигнал» готов.

Можно его проверить.

Откроем любой Telegram-клиент, найдём наш чат-бот и напишем /Start или Старт.

Чат-бот нас поприветствовал и сообщил информацию о себе.

Но, пока, он ничего не умеет и не знает. И на любое наше сообщение, наш запрос или вопрос, называть можно как угодно, он отвечает одно и тоже.

Перед тем, как чему-нибудь научить нашего чат-бота, настроим для него авторизацию. Чтобы пользоваться им могли только те, кому мы сами позволим.