docs: пул приветствий оператора вместо объяснения про передачу
1 parent
70275a3e16
commit
6139319180
4 files changed
+38
-5
No files matched your search
@@ -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) |
|
||||
|
||||
**Правила:**
|
||||
|
||||
@@ -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`). Придёт приветствие оператора —
|
||||
опиши проблему ответным сообщением, можно приложить фото, документ или голосовое.
|
||||
Оператор ответит прямо в этом чате.
|
||||
|
||||
Пока обращение открыто, внизу остаётся только кнопка «Главное меню». Можно отвлечься на другие
|
||||
режимы и вернуться: обращение продолжится в том же топике с сохранённой историей.
|
||||
|
||||
Reference in new issue
Block a user