diff --git a/Deployment.md b/Deployment.md index a8874c4..e76d553 100644 --- a/Deployment.md +++ b/Deployment.md @@ -79,6 +79,7 @@ INFO:aiogram.dispatcher:Run polling for bot @post_master_bot id=2201652808 - 'М | `DEV_CHAT_ID` | чат для уведомлений о новой версии | | `SUPPORT_GROUP_ID` | id группы операторов (супергруппа с темами); без неё поддержка выключена | | `SUPPORT_NOTE_PREFIX` | префикс внутренней заметки (default `//`) | +| `SUPPORT_GREETINGS` | пул приветствий оператора, разделитель `|` | | `SUPPORT_TOPIC_EMOJI_ID` | custom emoji id на топике обращения (optional) | **Правила:** diff --git a/Developer-Guide.md b/Developer-Guide.md index 4faec4f..68b87cf 100644 --- a/Developer-Guide.md +++ b/Developer-Guide.md @@ -189,6 +189,7 @@ update_tone_from_image → _handle_image_message | `set_active` / `is_support_active` | Флаг открытого обращения | | `get_user_by_thread` | Обратный поиск пользователя по `thread_id` | | `topic_title` | «Имя · @username» (без username — «Имя · id»), лимит 128 | +| `support_greeting` (activity_phrases) | Случайная фраза начала диалога; пул переопределяется `SUPPORT_GREETINGS` | | `send_profile_card` | Аватарка (`get_user_profile_photos`) + сводка профиля как первое сообщение топика (один раз) | | `ensure_topic` | Создаёт топик при первом обращении, переиспользует существующий | | `relay_user_message` | `copy_message` в топик; при «thread not found» пересоздаёт топик | diff --git a/Support.md b/Support.md index 252f5e4..065e267 100644 --- a/Support.md +++ b/Support.md @@ -16,9 +16,11 @@ 1. Режим «📖 Помощь» → кнопка **«🆘 Поддержка»** (или команда `/support`). 2. Бот пишет: что случилось, опиши проблему прямо здесь, оператор ответит. -3. Пользователь пишет текстом, присылает фото, документ или голосовое — всё уходит оператору. -4. Оператор отвечает в топике — ответ приходит пользователю в личку. -5. **«🏠 Главное меню»** завершает обращение: бот снова работает как обычно. +3. В ответ приходит **приветствие оператора** — случайная фраза из пула, например + «Здравствуйте! На связи поддержка. Расскажите, что случилось — разберёмся». +4. Пользователь пишет текстом, присылает фото, документ или голосовое — всё уходит оператору. +5. Оператор отвечает в топике — ответ приходит пользователю в личку. +6. **«🏠 Главное меню»** завершает обращение: бот снова работает как обычно. Отдельного режима (FSM) нет. Обращение — расширение режима «Помощь», поэтому пользователь может уйти в «Генерацию», потом вернуться через «Помощь → Поддержка» и продолжить разговор: @@ -49,6 +51,33 @@ --- +## Приветствие оператора + +Бот **не говорит** пользователю, что «передаст сообщение оператору» — это сразу разрушает +ощущение живого диалога. Вместо этого бот показывает одну случайную фразу из пула +`activity_phrases.SUPPORT_GREETINGS`: + +- «Здравствуйте! На связи поддержка. Расскажите, что случилось — разберёмся.» +- «Добрый день! Слушаю вас: опишите проблему, и постараемся помочь.» +- «Приветствую! Чем могу помочь? Опишите ситуацию подробнее.» +- «Добрый день! На связи. Напишите, что не работает, — посмотрим.» + +и ещё шесть вариантов в `activity_phrases.py`. + +**Требования к формулировкам:** +- без «я», «бот», «оператор» — фраза должна звучать от человека и не спорить с голосом бота; +- без лишних обещаний — только приветствие и приглашение описать проблему. + +**Переопределение без деплоя:** переменная `SUPPORT_GREETINGS` в Coolify, разделитель `|`: + +``` +Здравствуйте! Чем помочь?|Добрый день! Опишите проблему. +``` + +Пустые элементы отбрасываются; если пул пуст — используется встроенный. + +--- + ## Данные профиля в карточке Собирает `user_store.support_profile_summary()`: @@ -101,6 +130,7 @@ |---|---|---| | `SUPPORT_GROUP_ID` | да | id группы операторов. Без неё поддержка выключена (fail-closed) | | `SUPPORT_NOTE_PREFIX` | нет | префикс внутренней заметки, default `//` | +| `SUPPORT_GREETINGS` | нет | пул приветствий оператора, разделитель `|` | | `SUPPORT_TOPIC_EMOJI_ID` | нет | custom emoji id на иконке топика | --- diff --git a/User-Guide.md b/User-Guide.md index a27e109..2177e95 100644 --- a/User-Guide.md +++ b/User-Guide.md @@ -69,8 +69,9 @@ В режимах «Обучение» и «Генерация» отправь голосовое — бот расшифрует его (STT) и обработает как обычный текст. ### Написать в поддержку -В режиме «Помощь» нажми **«🆘 Поддержка»** (или введи `/support`) и опиши проблему — можно приложить -фото, документ или голосовое. Сообщение уйдёт оператору, он ответит прямо в этом чате. +В режиме «Помощь» нажми **«🆘 Поддержка»** (или введи `/support`). Придёт приветствие оператора — +опиши проблему ответным сообщением, можно приложить фото, документ или голосовое. +Оператор ответит прямо в этом чате. Пока обращение открыто, внизу остаётся только кнопка «Главное меню». Можно отвлечься на другие режимы и вернуться: обращение продолжится в том же топике с сохранённой историей.