Настройки telegram

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

Где искать: Модули → Система → Настройки → Настройки telegram

Что делает бот

Переписка. Каждый, кто напишет боту, получает карточку в регистре Telegram. Сообщения ложатся в чат этой карточки, и из того же чата на них отвечают.
Копии входящих. Каждое входящее сообщение бот пересылает людям со вкладки «Пользователи» этой настройки — с подписью, от кого оно.
Уведомления о задачах. Уведомления с типом Telegram и кнопки утверждения задачи бот отправляет исполнителю задачи — в ту карточку Telegram, где в поле «Пользователь» стоит его логин.
Команды. /list_tasks — незакрытые задачи, /find_task — утвердить задачу по номеру, /ts — табель. Команды действуют от имени пользователя, указанного в карточке Telegram в поле «Пользователь».

Описание полей

Токен — токен бота, который выдаёт BotFather (как создать бота — в инструкции). Поле только для записи: прочитать сохранённый токен не может никто. После сохранения поле показывает маску. Не трогайте его — токен останется; наберите новый — он заменит старый; очистите поле — токен сотрётся при сохранении, и бот остановится.
Комментарий — произвольная заметка.
Пользователи (вкладка) — кому пересылать копии входящих сообщений. id Телеграма выбирается из карточек регистра Telegram, поэтому человек должен сначала сам написать боту. Комментарий — заметка к строке.

Как запустить бота

Создайте бота в BotFather и скопируйте токен.
Вставьте его в поле «Токен» и сохраните. Бот запускается на сервере сразу после сохранения. Система предложит обновить страницу — согласитесь, чтобы открытые окна увидели бота.
Напишите боту что угодно — в регистре Telegram появится ваша карточка. Заполните в ней «Пользователь» (для уведомлений о задачах и команд) и «Сотрудник» (для напоминаний о днях рождения и табеле).

Типовые ситуации

Бот отвечает на команду «❗ Select user for your telegram record in ERPJS!». В карточке Telegram этого человека не заполнено поле «Пользователь». Заполните его логином того, от чьего имени будет действовать бот.

Бот отвечает «⛔ This user is not allowed to login». Пользователь из карточки Telegram закрыт или ему запрещён вход. Для бота действуют те же правила, что и для входа в систему.

Уведомления о задачах не приходят в Telegram. В карточке Telegram нет «Пользователь» с логином исполнителя задачи — или человек ещё ни разу не писал боту, и карточки нет совсем.

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

Несколько компаний в базе. Бот в базе работает один, поэтому токен указывают только в одной компании.