Опция Уведомление в Telegram | Документация Ведок

Необходимые требования

наличие лицензии - опция уведомления в Telegram.
доступ в Интернет с компьютера, на котором установлен Ведок.
данная опция доступна в Ведок начиная с версии 1.5.0.

Настройка опции

В приложении Telegram:

Откройте диалог с ботом @BotFather.
Отправьте команду /newbot.
Введите название бота. Например, Company Notifications. Рекомендуем использовать название вашей организации.
Введите имя пользователя для бота. Оно должно оканчиваться сочетанием «bot». Например, Сompanynotifybot. В ответном сообщении Telegram выдаст сообщение о создании нового бота для вашей организации (его имя или ссылка на него потребуется в дальнейшем для подключения пользователей) и значение токена (сохраните для внесения в настройки программы Ведок).

В системе Ведок:

Выполняется пользователем с правами администратора.
Установите значение «Свойства приложения» в ветке license\license.telegramBotEnable в true.

В значение «Свойства приложения» в ветке telegrambot\telegrambot.botToken внесите полученный на предыдущем шаге токен бота.

Активируйте задания для подтверждения пользователей и отправки сообщений. Пункт меню «Администрирование» - «Назначенные задания» - установите флаг Active.

Добавить пользователю Ведок пользователя Telegram.

Ниже приведен пример с добавленным и прошедшим проверку пользователем:

Кнопка добавления служит для добавления пользователя Telegram, с которым будет связан пользователь Ведок.

После нажатия кнопки добавления станет доступно поле для ввода имени пользователя Telegram.

В поле для ввода указывается имя пользователя Telegram.

Иконка подтверждения пользователя Telegram отображает, подтвержден ли пользователь Telegram по введенному имени.

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

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

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

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

Для мониторинга процесса отправки сообщений в Telegram воспользуйтесь пунктом меню «Администрирование» - «История сообщений Telegram».

На нём отображается список сообщений, их содержание, статус, время и количество попыток отправки.

Активация лицензии опции

Работа с опцией недоступна для пользователей если не активирована временная или постоянная лицензия на опцию.

Получение постоянной (бессрочной) лицензии на опцию доступно после ее приобретения.

Получение временной (1-3 месяца) ознакомительной лицензии возможно по письменному запросу, направленному на адрес sales@cs-consult.ru

Ключ запроса лицензии можно сформировать на экране Управление лицензиями, доступном в главном меню. Процедура формирования и активации лицензии описана в Ведок. Руководстве администратора глава "Работа с лицензионными ключами".

Отключение отправки уведомлений через Telegram.

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

Установить значение false свойству приложения license.telegramBotEnable. При установке свойства сообщения на отправку не будут создаваться.
Деактивировать назначенное задание с именем бина telegrambot_SendMessageTB.

Удалить с помощью соответствующей кнопки имя пользователя Telegram у пользователя Ведок. При наступлении события оповещения сообщения на отправку не будут создаваться. В лог будут писаться сообщения с заголовком «Exception while queuing».
Удалить из настроек пользователя способ уведомления о стандартных событиях через Telegram.