В Еноте есть возможность подключения Телеграм бота и синхронизации его с программой для выполнения различных команд (например, рассылка уведомлений, загрузка архива данных по животному и т. д.). Боты в Telegram — это разновидность чат-ботов. По своей сути – это те же пользовательские аккаунты, которыми вместо людей управляют программы.  Рассмотрим ниже порядок создания, подключения и настройки Телеграм бота для Енота.

СОЗДАНИЕ БОТА

Для создания бота необходимо в мессенджере «Telegram» добавить пользователя «@BotFather» и выполнить команду «Запустить/Начать» (Рис. 1):

Рис. 1. Создание бота

Выполнить команду «/newbot» (см. Рис. 2). Далее по инструкции указываем имя бота, имя пользователя. После успешной регистрации в сообщении будет указан токен бота.

Обратите внимание! Существует ограничение на имя — в конце оно должно оканчиваться на «bot». На одну базу программы используется один бот, соответственно — один токен.

Рис. 2. Имя и токен бота

НАСТРОЙКИ БОТА

Доступ к настройки бота доступен пользователям с ролью «СервисСлужба1С» или «Администратор базы» или «ВебСервисы». Настройки бота выполняются в справочнике «Подключаемое оборудование» (Рис. 3).

Рис. 3. Настройки бота

Сервер – указываем «api.telegram.org»

Токен – указываем из сообщения от @BotFather

Пользователь – пользователь информационной базы ( у пользователя должна быть роль «СервисСлужба1С» или «АдминистраторБазы» или «ВебСервисы»).

Для включения/выключения синхронизации с сервером «Telegram» необходимо установить флаг «Устройство используется» и нажать на ссылку синхронизации.

При нажатии ссылки синхронизации открывается окно, где пользователь может включить синхронизацию, отключить и посмотреть текущий её статус (Рис. 4):

Рис. 4. Синхронизация

СПРАВОЧНИКИ

Пользователи телеграм

Для подключения пользователя достаточно добавить новый элемент справочника «Пользователи телеграм», указать набор команд (создаем набор) и  номер телефона — указывается так же, как и в визитке Telegram, без специальных знаков, только цифры. Флаг «Авторизован» устанавливать не нужно.

Рис. 5. Пользователи телеграм

Рис. 6. Создание пользователя

Пользователь должен добавить созданного бота себе в мессенджер и пройти авторизацию. После прохождения авторизации будет установлен флаг «Авторизован».

Рис. 7. Авторизация

Команды сервисов

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

Справочник может быть одним из трех типов (Рис. 8):

Рис. 8. Типы сервисов

— Команда (кнопка меню) — команда, которая будет отображаться в чате с ботом в виде кнопки (Рис. 9):

Рис. 9. Кнопка меню

— Действие по расписанию — будет выполняться отправка ботом сообщения по заданному расписанию

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

Шаблон наименования — наименование команды, которое будет отображаться в диалоге с пользователем (доступно только для типа сервиса «Команда (кнопка меню)»). В шаблоне наименования доступны произвольные параметры. Все параметры начинаются с символов «&&» (Рис. 10).

Рис. 10. Шаблон наименования

Шаблон сообщения. В шаблоне доступны произвольные параметры. Все параметры начинаются с символов «&&». Также доступны предопределенные переменные:

ТекстСообщения — текст сообщения, которое будет отправлено пользователю.

ОтправлятьСообщение — булево (значение по умолчанию — Истина)

СсылкаНаОбъект — ссылкой на объект может быть любой справочник, документ или задача. Доступен, если тип сервиса равен «По событию».

Например, при указании таких настроек (Рис. 11), ссылкой на объект будет элемент справочника «Клиенты»:

Рис. 11. Действие при записи справочника

При создании нового элемента справочника «Команды сервисов», автоматически будет сформирован текст шаблона сообщения (Рис. 12):

Рис. 12. Создание команды сервиса

Наборы сервисов

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

Во вкладке «Меню команд» указывается иерархия команд (кнопок), которые будут доступны пользователю в чате с ботом (Рис. 13):

Рис. 13. Набор сервисов

Команда «Добавить ряд кнопок» — группирует кнопки в горизонтальный ряд, в противном случае кнопки будут группироваться вертикально (Рис. 14).

Рис. 14. Добавление кнопок

Команда «Добавить подменю» — добавляет подменю кнопок.

Рис. 15. Подменю кнопок

Значение параметров

Значение параметров указываются для каждого пользователя отдельно (в справочнике «Пользователи телеграм»). Параметры заполняются автоматически, после выбора набора сервисов, при открытия элемента справочника «Пользователи телеграм». Значения параметров указывает пользователь (сначала выбираем тип значения (в данном случае это валюта), затем значение).

Рис. 16. Параметры

Для команд с типом «Действие по событию» можно указать дополнительный фильтр. Например, при записи задачи выполнять команду нужно только по указанному исполнителю (Рис. 17):

Рис. 17. Отбор по событиям

Для команд с типом «Действие по расписанию» можно указать расписание (Рис. 18):

Рис. 18. Действие по расписанию

Проверка расписаний производится предопределенным регламентным заданием «Телеграм регламентное задание», которое периодически (по умолчанию 5 мин) проверяет необходимость выполнения команд по расписанию.

Все параметры и команды в справочнике «Пользователей телеграм» заполняются автоматически при открытии из справочника «Наборы сервисов».

Важно: При изменении токена (смена бота), необходимо для всех пользователей снять флажки авторизации

ФУНКЦИИ

 

Версия для печати


Top