docs: пул приветствий оператора вместо объяснения про передачу

hermes committed 2026-10-11 15:59:41 +02:00
1 parent 70275a3e16
commit 6139319180
4 files changed
+38 -5

No files matched your search

+1
@@ -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) |
**Правила:**
+1
@@ -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» пересоздаёт топик |
+33 -3
@@ -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 на иконке топика |
---
+3 -2
@@ -69,8 +69,9 @@
В режимах «Обучение» и «Генерация» отправь голосовое — бот расшифрует его (STT) и обработает как обычный текст.
### Написать в поддержку
В режиме «Помощь» нажми **«🆘 Поддержка»** (или введи `/support`) и опиши проблему — можно приложить
фото, документ или голосовое. Сообщение уйдёт оператору, он ответит прямо в этом чате.
В режиме «Помощь» нажми **«🆘 Поддержка»** (или введи `/support`). Придёт приветствие оператора —
опиши проблему ответным сообщением, можно приложить фото, документ или голосовое.
Оператор ответит прямо в этом чате.
Пока обращение открыто, внизу остаётся только кнопка «Главное меню». Можно отвлечься на другие
режимы и вернуться: обращение продолжится в том же топике с сохранённой историей.