# Telegram-бот

> Сохраняйте заметки в MMW и задавайте вопросы памяти из Telegram через бота @mmwhub_bot.

Из этой страницы вы узнаете, как привязать Telegram к аккаунту MMW, как сохранять заметки и искать в памяти через бота @mmwhub_bot и что происходит с вашими сообщениями.

## Что вы получите

- Заметка, отправленная боту, сохраняется в вашу память с источником `telegram`.
- На вопрос бот находит ответ в памяти: до 3 записей, с датой и источником.
- Пересланное сообщение сохраняется вместе с автором.
- Те же записи видят ваши ассистенты: Claude, ChatGPT, Cursor и другие клиенты с ключом того же аккаунта.

## Что нужно

- Аккаунт MMW с активной подпиской — см. [Быстрый старт](/start/quickstart/).
- Telegram. Бот работает только в личных чатах.

## Привязка

1. Откройте кабинет [app.mmwhub.ru](https://app.mmwhub.ru) → «Интеграции».

2. Нажмите «Подключить Telegram», затем «Открыть бота». Telegram откроет @mmwhub_bot, и привязка пройдёт автоматически.

3. Если открыть бота по кнопке не получилось, скопируйте код из кабинета и отправьте боту:

   ```text
   /link КОД
   ```

   Код одноразовый и действует 10 минут.

4. Бот ответит «Готово, аккаунт MMW подключён».

## Как пользоваться

Просто пишите боту — он сам разберёт, заметка это или вопрос:

```text
Лыжи на балконе
```

Бот сохранит заметку.

```text
Где лыжи?
```

Бот найдёт запись и ответит по ней, указав дату и источник.

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

| Команда | Что делает |
|---|---|
| `/save текст` | Точно сохранить текст как заметку. |
| `/find вопрос` | Точно искать в памяти. |
| `/undo` | Отменить последнюю запись. |
| `/unlink` | Отключить бота от аккаунта. Действует сразу. |
| `/help` | Подсказка по командам. |

Ответы на вопросы формулирует модель GigaChat по найденным в памяти записям.

## Проверка

1. Отправьте боту: `Поставщик Альфа даёт скидку 7% при оплате до 15-го`.

2. Отправьте: `Какая скидка у Альфы?` — бот должен ответить по сохранённой записи, с датой и источником.

3. Откройте кабинет, раздел «База знаний»: там видна запись с источником `telegram`.

4. Спросите любого подключённого ассистента: «Какие условия у поставщика Альфа? Посмотри в MMW» — он найдёт ту же запись.

## Чат поддержки

Оператор поддержки может написать вам в бот или предложить открыть чат поддержки. Чат открывается **только после вашего согласия** — бот покажет кнопки «Да» и «Нет».

- Пока чат поддержки открыт, ваши сообщения идут оператору и **не попадают в память**.
- Чат закрывается сам после 24 часов тишины или командой `/unlink`.

## Приватность

- Сообщения идут через сервер-ретранслятор в Германии. Он не хранит тексты и не пишет их в журнал, у него нет базы данных и ключей MMW.
- Каждое сообщение заново проверяет привязку, поэтому `/unlink` срабатывает мгновенно.
- Повторно доставленное Telegram сообщение не создаёт вторую запись.
- Секреты в заметках вычищаются, как и при любой записи в MMW (Memory Guard).

## Типичные проблемы

Код действует 10 минут и только один раз. Получите новый: кабинет → «Интеграции» → «Подключить Telegram».

После нескольких неверных кодов привязка временно блокируется. Подождите 15 минут и получите новый код.

Бот работает только в личных чатах. Напишите ему напрямую.

Для одной заметки в боте действует ограничение длины — 4 000 символов. Длинный документ лучше сохранить через ассистента.

## Что дальше
