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

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

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

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

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

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

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

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

Обратите внимание! Доступ к настройкам бота доступен пользователям с ролью «СервисСлужба1С» или «Администратор базы» или «ВебСервисы».

Настройки бота выполняются в справочнике «Подключаемое оборудование» (Рис. 3).

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

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

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

Токен – указываем из сообщения от @BotFather полученого в Телеграмм.

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

Wed адрес базы — адрес Вашей информационной базы, получить можем следующим образом (Рис.4):

Рис. 4 Wed адрес базы

Рис.4 Wed адрес базы

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

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

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

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

СПРАВОЧНИКИ

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

Для подключения пользователя достаточно добавить новый элемент справочника «Пользователи телеграмм». Для этого переходим в «Настройки» (Рис.6),

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

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

открывается форма настроек телеграм, выбираем — «Пользователи телеграм» (Рис.7):

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

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

Указываем набор команд (создаем набор) и  номер телефона — указывается так же, как и в визитке Telegram, без специальных знаков, только цифры. Флаг «Авторизован» устанавливать не нужно (Рис.8):

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

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

После этого пользователь должен добавить созданного бота себе в мессенджер и пройти авторизацию (Рис.9, 9.1)

Рис.9

Рис.9

 

Рис. 9.1

Рис. 9.1

После  авторизации в Еноте на против пользователя, которого добавляли будет установлен флаг «Авторизован»

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

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

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

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

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

Рис. 9.3 Открываем раздел "команда сервисов"

Рис. 9.3 Открываем раздел «команда сервисов»

Создание команды сервисов доступно пользователю с ролью «СервисСлужба1С» или «АдминистраторБазы» или «ВебСервисы».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Команда «Добавить подменю» — добавляет подменю кнопок (Рис.16):

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

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


Top