# Бот для Telegram

> Общайтесь один на один в личном чате, приводите персонажей в группы, делитесь ими через инлайн-режим или откройте мини-приложение.

Source: https://reverie.im/ru/docs/integrations/telegram-bot
Language: ru

Бот Reverie приводит персонажей в Telegram — в личный чат с ботом, в группу или в канал, где он администратор. Ещё он умеет открывать сам Reverie прямо внутри Telegram как Mini App, где можно купить кредиты за Telegram Stars.

## Настройка \[#set-it-up]

### Привяжите аккаунт \[#link-your-account]

Каждому, кто разговаривает с персонажем, нужен аккаунт Reverie, привязанный к его аккаунту Telegram (хватит и бесплатного). Один аккаунт Telegram соответствует ровно одному аккаунту Reverie.

* **С сайта.** В приложении откройте **Labs → Боты для Discord и Telegram** и нажмите **Привязать в Telegram** на карточке Telegram. Telegram откроет чат с ботом; нажмите «Запустить» — и вы привязаны к аккаунту, в который вошли. Страница обновится сама.
* **Из Telegram.** Откройте бота и отправьте `/start`. **Продолжить через Telegram** создаёт бесплатный аккаунт Reverie через мини-приложение, без почты. **У меня уже есть аккаунт** вместо этого присылает одноразовую ссылку, действующую **10 минут**, которая связывает ваш Telegram с существующим аккаунтом; ту же ссылку в любой момент присылает `/link`.

### Выберите персонажа \[#pick-a-character]

Отправьте `/chat`, чтобы увидеть, с кем можно поговорить — сначала персонажи, с которыми вы уже общаетесь здесь, потом предложения, — или `/chat` с именем, чтобы найти нужного. Нажмите на персонажа и начинайте писать.

### Приведите персонажей в группу \[#bring-characters-into-a-group]

Необязательно. Добавьте бота в группу — это делает кнопка **Добавить бота в группу** на карточке Telegram — и отправьте там `/add <name>`. Бот ищет и показывает до восьми совпадений кнопками; нажмите на одно, чтобы добавить. Добавлять персонажей могут только администраторы группы.

## Ваш личный чат \[#your-private-chat]

Личный чат с ботом — ваш собственный разговор, и оплачивается он с вашего аккаунта. На каждое сообщение приходит ответ — упоминать никого не нужно.

* **Один персонаж за раз.** `/chat` переключает на другого, а `/chats` показывает персонажей, с которыми вы здесь говорили. У каждого свой разговор, так что, вернувшись, вы продолжаете с того же места.
* `/remove` завершает текущий разговор — он сохраняется для `/chats`, — а `/reset` удаляет его, спросив подтверждение.
* **Персонажи 18+** следуют настройке 18+ вашего аккаунта: если она выключена, они скрыты и не могут здесь общаться.
* Недавние разговоры видны и в панели интеграций в разделе **Личный чат**: **Продолжить на сайте** открывает разговор в браузере, а **Чат в Telegram** возвращает сюда.

## Команды \[#commands]

Кнопка меню рядом с полем ввода показывает команды, которые работают там, где вы находитесь: у личного чата и у групп свои списки, на языке вашего Telegram.

| Команда              | Аргумент                     | Где                                        | Что делает                                                                                                                           |
| -------------------- | ---------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| `/start`             | —                            | личный                                     | Регистрирует или привязывает вас, затем предлагает персонажей. В группе — как `/help`                                                |
| `/help`              | —                            | оба                                        | Список команд                                                                                                                        |
| `/chat`              | имя (необязательно)          | личный                                     | Выбирает или меняет персонажа, с которым вы говорите                                                                                 |
| `/chats`             | —                            | личный                                     | Персонажи, с которыми вы говорили, — чтобы переключаться между ними                                                                  |
| `/link`              | —                            | личный                                     | Одноразовая ссылка, связывающая ваш Telegram с существующим аккаунтом Reverie                                                        |
| `/add`               | текст поиска (необязательно) | группа, администраторы                     | Ищет персонажей и добавляет того, на кого вы нажали. В личном чате — как `/chat`                                                     |
| `/remove`            | —                            | группа, администраторы                     | Показывает персонажей группы кнопками и убирает того, на кого вы нажали. В личном чате завершает текущий разговор                    |
| `/list`              | —                            | группа                                     | Персонажи этой группы. В личном чате — как `/chats`                                                                                  |
| `/info`              | имя персонажа                | оба                                        | Сведения о персонаже. В личном чате `/info` без имени рассказывает о персонаже, с которым вы говорите; в группе имя обязательно      |
| `/settings`          | подраздел (необязательно)    | оба                                        | Открывает меню настроек                                                                                                              |
| `/plugins`           | —                            | оба                                        | Плагины, работающие в этом чате, с кнопками для установки, удаления, включения и выключения официальных плагинов и ваших собственных |
| `/group`             | —                            | группа, администраторы или тот, кто платит | Кто может общаться, дневной лимит на участника, заблокированные участники и расход. Открывается в вашем личном чате                  |
| `/block`, `/unblock` | —                            | группа, администраторы или тот, кто платит | Отправляются ответом на сообщение участника: запрещают ему говорить с персонажами или снова разрешают                                |
| `/reset`             | —                            | оба, в группе — администраторы             | Стирает историю этого чата                                                                                                           |
| `/regenerate`        | —                            | оба                                        | Перегенерирует последний ответ                                                                                                       |
| `/suggest`           | —                            | оба                                        | Три варианта ответа                                                                                                                  |
| `/account`           | —                            | оба                                        | Кредиты и статус подписки                                                                                                            |
| `/daily`             | —                            | личный                                     | Забирает ежедневную награду                                                                                                          |
| `/notify`            | —                            | личный                                     | Могут ли персонажи писать вам первыми и какие уведомления приходят сюда                                                              |
| `/buy`               | —                            | личный                                     | Купить подписку или пакет кредитов за Telegram Stars                                                                                 |
| `/app`               | —                            | оба                                        | Открывает мини-приложение Reverie                                                                                                    |
| `/paysupport`        | —                            | оба                                        | Поддержка по оплате. Зарегистрирована, но в меню не показывается                                                                     |

`/plugins` показывает плагины промптов и инструментов, работающие в этом чате, а администраторам или тому, кто добавил персонажа, даёт кнопки для установки официальных и собственных плагинов, их удаления и включения или выключения. Плагин, которому нужны заполненные настройки, нельзя установить из бота. Результат плагина-инструмента публикуется в чате короткой карточкой.

### Настройки \[#settings]

`/settings` открывает встроенное меню, а можно сразу перейти к нужной странице: `/settings model`, `language`, `mode`, `style`, `payment` или `limit`.

| Пункт меню             | Область действия                                          | В группах только админам |
| ---------------------- | --------------------------------------------------------- | ------------------------ |
| **Model (personal)**   | Ваша собственная модель для главного персонажа этого чата | нет                      |
| **Language (chat)**    | Язык ответов в чате                                       | да                       |
| **Chat mode**          | Отвечать на всё или только когда обращаются               | да                       |
| **Chat style**         | Ролевая проза или только реплики                          | да                       |
| **Payment mode**       | Платит владелец или платит отправитель                    | да                       |
| **Daily credit limit** | Потолок кредитов на сутки UTC                             | да                       |

В личном чате в меню есть \*\*Model (personal)\*\*, **Reply language** и **Chat style**: личный чат отвечает всегда, а свои сообщения оплачиваете вы. В группе меню и сообщения об ошибках через некоторое время удаляются сами, чтобы не засорять чат.

## Группы и каналы \[#groups-and-channels]

В группе персонажи отвечают, когда их **@упомянули** или когда вы **ответили** на их сообщение — автоответ по умолчанию выключен, так что персонаж, добавленный в оживлённую группу, не перекрикивает всех. Включает его `/settings mode`. Если при входе бот сказал, что видит только сообщения, которые упоминают его или отвечают ему, сделайте его администратором группы: автоответу нужно видеть каждое сообщение.

В группе с темами каждый ответ попадает в ту тему, на сообщение из которой он отвечает. Состав персонажей и история у группы общие для всех тем.

Бот может писать и в **канал** Telegram, если его сделали там администратором.

## Правила группы \[#group-rules]

Отправьте `/group` в группе. Панель откроется в вашем личном чате с ботом, чтобы группа не наблюдала, как вы её настраиваете; если вы ни разу не начинали личный чат с ботом, он сначала попросит его открыть. Пользоваться ею могут администраторы группы и тот, кто платит за её персонажей. В ней видно расход за сегодня и за последние семь дней, участников, потративших больше всех сегодня, и правила:

| Правило                        | Варианты                                                                                                                                          |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Кто может общаться**         | **Все** (по умолчанию) или **Только администраторы**                                                                                              |
| **Дневной лимит на участника** | Сколько кредитов хозяина один участник может потратить за сутки UTC, или **Без лимита** (по умолчанию). Действует только там, где платит хозяин   |
| **Заблокированные участники**  | Ответьте в группе `/block` на сообщение участника, чтобы он больше не мог говорить с персонажами; `/unblock`, отправленная так же, снимает запрет |

Администраторов и платящий аккаунт никогда не отсекают — ни блокировка, ни режим доступа. Участнику, которого не пропускает режим доступа, один раз сообщают, что с персонажами могут говорить только некоторые; заблокированный участник не получает ответа вовсе.

## Поделиться персонажем \[#sharing-a-character]

В любом чате Telegram — даже там, где бота нет, — наберите @имя бота, а за ним имя персонажа, и выберите его из списка. В чат уйдёт карточка, кнопка которой открывает в боте разговор один на один с этим персонажем. Предлагаются только публичные персонажи без пометки 18+.

## Mini App \[#the-mini-app]

`/app` открывает Reverie внутри браузера Telegram, уже под вашим аккаунтом Telegram — полноценное приложение с вашим списком персонажей, чатами и кредитами.

Если бот отвечает, что приложение недоступно, значит Mini App не включён — откройте Reverie в браузере.

## Оплата через Telegram Stars \[#paying-with-telegram-stars]

`/buy` проводит всю покупку внутри Telegram. Без подписки вы выбираете между тарифом и пакетом кредитов; с подпиской сразу попадаете к пакетам кредитов с уже учтённым бонусом подписчика. После выбора появляется встроенный счёт Stars с кнопкой **Pay**.

`/buy` работает только в личных чатах — счёт в группе списал бы деньги с того, кто по нему нажал.

## Кто платит \[#who-pays]

| Режим оплаты                  | С кого списывают                                                                                                        | Какие лимиты действуют                                                          |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Owner pays** (по умолчанию) | Хозяин группы: аккаунт Reverie, который первым добавил персонажа в группу, пока кто-то другой не возьмёт оплату на себя | Дневной лимит кредитов группы и дневной лимит на участника, заданный в `/group` |
| **User pays**                 | Баланс самого отправителя                                                                                               | Никакие — каждого участника ограничивает его собственный баланс                 |

Сообщения стоят столько же, сколько в веб-приложении. Дневные счётчики обнуляются в **00:00 UTC**. Чтобы перевести оплату группы на свой аккаунт, откройте `/group` и нажмите **Платить с моего аккаунта**. В личном чате вы всегда оплачиваете свои сообщения сами.

## Что работает в Telegram \[#what-works-in-telegram]

* **Изображения.** Персонажи умеют генерировать картинки.
* **Голос наружу.** Персонажи могут отправлять голосовые сообщения.
* **Голос внутрь.** Голосовые заметки и аудиофайлы расшифровываются, до **25 МБ**.
* **Память.** Когда модель поддерживает инструменты, персонажи сохраняют и обновляют воспоминания, а канон из книг мира попадает в их контекст.
* **История.** Длинные чаты автоматически сворачиваются в сводки по мере роста.

## Уведомления и ежедневная награда \[#notifications-and-check-ins]

`/notify` настраивает две вещи. **Персонажи пишут первыми** — это уровень проактивности вашего аккаунта, та же настройка, что на сайте: с подпиской персонаж, с которым вы сейчас говорите в личном чате, может написать вам первым — см. [Сообщения по инициативе персонажа](https://reverie.im/ru/docs/chatting/proactive-messages). **Также присылать сюда** выбирает, какие из ваших уведомлений Reverie будут приходить ещё и в личный чат; сначала включено только **Аккаунт и оплата** — см. [Уведомления](https://reverie.im/ru/docs/account/notifications). В панели интеграций есть те же варианты.

`/daily` забирает вашу [ежедневную награду](https://reverie.im/ru/docs/rewards/daily-check-in) — ту же, что на сайте, — и открывает розыгрыш в мини-приложении.

## Ограничения \[#limits]

| Ограничение                                   | Значение       |
| --------------------------------------------- | -------------- |
| Персонажей на чат                             | 5              |
| Длина сообщения                               | 4 096 символов |
| Размер голосового ввода                       | 25 МБ          |
| Сообщений в очереди на чат                    | 3              |
| Результатов поиска, которые показывает `/add` | 8              |

Быстрые сообщения подряд от одного человека объединяются в один ход.

## Как отвязать \[#unlinking]

Отвязать можно в панели интеграций кнопкой **Unlink Account**.

> Блокировка бота в Telegram аккаунт не отвязывает. Удаление бота из группы всего лишь отключает персонажей этой группы. Используйте **Unlink Account** в приложении.

## Смежное \[#related]

* [Бот для Discord](https://reverie.im/ru/docs/integrations/discord-bot) — те же персонажи, но на сервере
* [Reverie Лаборатория](https://reverie.im/ru/docs/integrations/labs) — где находится панель интеграций
* [Кредиты](https://reverie.im/ru/docs/billing/credits) — сколько стоит сообщение
* [Подписки](https://reverie.im/ru/docs/billing/subscriptions) — что входит в тариф