Работа с чат-ботом поддержки в Telegram

Общая информация

• Главный администратор: задаётся через переменную окружения env. Имеет неограниченные права.

• Супер-группа: группа для управления пользователями и тикетами. Задаётся через переменную окружения env.

• Клиентские группы: группы пользователей, в которых создаются тикеты. Бот должен быть добавлен в них суперпользователем, администратором или модератором.

---

1. Команды в Супер-группе (для администраторов)

• /start

  • Назначение: Регистрация и обновление данных пользователя в системе.

  • Действие: Обновляет ID и username пользователя в базе данных.

• /admin @username1 @username2

  • Назначение: Назначение прав администратора(Появляются права назначать/удалять модераторов и добавлять бота в группы).

  • Действие: Добавляет указанным пользователям (через их username) права администратора.

• /moderate @username1 @username2

  • Назначение: Назначение прав модератора (Появляются права добавлять бота в группы).

  • Действие: Добавляет указанным пользователям права модератора.

• /remove @username1 @username2

  • Назначение: Снятие прав.

  • Действие: Удаляет права администратора или модератора у указанных пользователей.

• /tickets

  • Назначение: Просмотр активных обращений.

  • Действие: Выводит список всех открытых тикетов.

• /close 123, 456

  • Назначение: Закрытие тикетов.

  • Действие: Закрывает тикеты с указанными ID (можно перечислять через запятую).

• /help

  • Назначение: Справка.

  • Действие: Показывает список всех доступных команд и справку по их использованию.

---

2. Логика работы в Клиентских группах

• Добавление бота:

  • Бота может добавить в группу только суперпользователь, администратор или модератор.

  • Если бота добавляет пользователь без прав, он (бот) автоматически покидает группу.

• Создание тикета:

  • Тикет создаётся автоматически, когда пользователь пишет первое сообщение в группе, при условии, что у него ещё нет активного (открытого) тикета в этой группе.

  • Все последующие сообщения от пользователя (включая файлы и медиа) добавляются в историю этого тикета (Сопоставить можно по времени отправки сообщения и айди чата, явной привязки сообщения к тикету нет).

• Команды:

  • /close

    • Назначение: Закрытие тикета.

    • Действие: Закрывает текущий активный тикет в этой группе.

---

ВАЖНО: Требования к правам бота

Для корректной работы бота необходимо наделить его правами администратора как в Супер-группе, так и во всех Клиентских группах. В противном случае бот не будет видеть поступающие сообщения и не сможет выполнять свои функции.