Как подключить сотрудника к Telegram-боту¶
Кому доступно: указать телефон в карточке сотрудника — нужна роль с правом «Настройки, пользователи»; видеть список подключённых — право «Настройки, справочники». Сам сотрудник подключается со своего телефона.
Бот присылает сотруднику уведомления о событиях в системе прямо в Telegram — новый заказ клиента, подписанный акт, отправка ведомости в оплату. На вход в кабинет и права бот не влияет: это только канал уведомлений (как устроен доступ).
Когда это нужно¶
Сотрудник не сидит в кабинете весь день, но должен узнавать о событиях сразу: координатор — о новых заказах, бухгалтер — об оплате ведомости и пополнении баланса.
Шаги¶
- Откройте Настройки → Пользователи и заполните поле «Телефон телеграмм пользователя» — номер, на который зарегистрирован Telegram сотрудника. Это можно сделать в карточке сотрудника (при создании или редактировании) или прямо в таблице: щёлкните по ячейке в этой колонке, введите номер и нажмите Enter. Указывайте номер начиная с 7 (например, 79261234567): именно в таком виде его передаёт Telegram, номер с 8 не совпадёт.
- Сотрудник открывает бота в Telegram и отправляет команду /start. Имя бота — @msk_office_bot (оно же указано в подсказке на странице «Telegram-пользователи»).
- Бот предложит кнопки с названиями организаций — сотрудник выбирает вашу организацию.
- Бот попросит номер — сотрудник нажимает кнопку «Отправить номер телефона» (Telegram передаст номер сам, вводить руками не нужно).
- Ответ «Спасибо, теперь Вы сможете получать сообщения от бота» означает, что подключение сработало. Сотрудник появится в списке Настройки → Telegram-пользователи.
Чтобы отключить сотрудника от уведомлений, удалите его запись на странице Настройки → Telegram-пользователи.
Какие уведомления он будет получать¶
Зависит от прав роли сотрудника — каждое право включает свой поток уведомлений (права добавляются в роль в Настройки → Роли, как настроить роль):
| Право в роли | О чём приходят уведомления |
|---|---|
| Телеграм, обработка заявок | События по заказам: новые заказы (в том числе при импорте), отметки и фото исполнителей по адресам, изменения и отмены адресов и заявок |
| Телеграм, регистрация исполнителей | Оформление исполнителей: новые фото документов на верификацию, привязка к «Мой налог» |
| Верификатор, проверка и одобрение исполнителей | Новые исполнители ожидают верификации, обновлённые фото |
| Телеграм, уведомление о подписании акта | Исполнитель подписал акт (с суммой) |
| Телеграм, уведомление о проведении платежа | Ведомость в оплате: сколько актов ушло в банк, сколько ждут подписи исполнителей |
| Телеграм, уведомление о пополнении баланса | Баланс компании пополнен, новый остаток |
Суперпользователи получают все уведомления независимо от прав.
Что ещё умеет бот¶
- /invite <номер> — отправляет исполнителю СМС-приглашение в приложение.
- /help — присылает ссылки «Добавить фото рабочего / договора / табеля»; они ведут на страницы загрузки фото в кабинете.
Если что-то пошло не так¶
- Бот ответил, что номер не найден или что привязать пользователя не удалось — в обоих случаях причина одна: номер в карточке пользователя не совпадает с номером Telegram. Проверьте формат (с 7, без +7 и 8) и что пользователь активен: неактивных бот не подключает.
- Уведомления не приходят — в роли сотрудника нет нужного права из таблицы выше. Добавьте право в роль.
- Бот не реагирует после выбора организации — у аккаунта Telegram должно быть задано имя пользователя (@username): бот различает сотрудников по нему.