# Бот для Telegram

> Спілкуйся віч-на-віч в особистому чаті, додавай персонажів у групи, ділися ними в рядку або відкривай Mini App.

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

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

## Налаштування \[#set-it-up]

### Прив'яжи свій акаунт \[#link-your-account]

Кожному, хто говорить із персонажем, потрібен акаунт Reverie, прив'язаний до акаунта Telegram (вистачить безкоштовного). Один акаунт Telegram відповідає рівно одному акаунту Reverie.

* **З сайту.** У застосунку перейди в **Лабораторія → Боти для Discord і Telegram** і натисни **Прив'язати в Telegram** на картці Telegram. Telegram відкриє чат із ботом; натисни **Start** — і тебе буде прив'язано до акаунта, у якому ти зараз. Сторінка оновиться сама.
* **З Telegram.** Відкрий бота й надішли `/start`. **Продовжити з Telegram** створює безкоштовний акаунт Reverie через Mini App, без електронної пошти. **У мене вже є акаунт** натомість надсилає одноразове посилання, дійсне **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`               | —                            | обидва                             | Відкриває Mini 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 — навіть там, де бота немає, — введи @username бота, а за ним ім'я персонажа, і вибери персонажа зі списку. З'явиться картка з кнопкою, яка відкриває чат віч-на-віч із цим персонажем у боті. Пропонуються лише публічні персонажі без позначки 18+.

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

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

Якщо бот відповідає, що застосунок недоступний, Mini App не ввімкнено — натомість відкрий Reverie у браузері.

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

`/buy` проводить усю покупку всередині Telegram. Якщо підписки немає, ти вибираєш між тарифом і пакетом кредитів; якщо підписка вже є, ти одразу переходиш до пакетів кредитів із застосованим бонусом підписника. Після вибору з'являється нативний рахунок Stars із кнопкою **Сплатити**.

`/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/uk/docs/chatting/proactive-messages). **Також надсилати сюди** визначає, які зі сповіщень Reverie додатково надходитимуть тобі в особистий чат; спочатку ввімкнено лише **Акаунт і оплата** — див. [Сповіщення](https://reverie.im/uk/docs/account/notifications). Панель інтеграцій пропонує ті самі варіанти.

`/daily` отримує винагороду за [щоденний вхід](https://reverie.im/uk/docs/rewards/daily-check-in) — той самий, що й на сайті, — і відкриває розіграш у Mini App.

## Ліміти \[#limits]

| Ліміт                                  | Значення       |
| -------------------------------------- | -------------- |
| Персонажів на чат                      | 5              |
| Довжина повідомлення                   | 4 096 символів |
| Розмір голосового введення             | 25 МБ          |
| Повідомлень у черзі на чат             | 3              |
| Результатів пошуку, які показує `/add` | 8              |

Кілька повідомлень поспіль від однієї людини, надісланих швидко, об'єднуються в один хід.

## Відв'язування \[#unlinking]

Відв'яжи акаунт на панелі інтеграцій кнопкою **Відв'язати акаунт**.

> Блокування бота в Telegram не відв'язує твій акаунт. Видалення бота з групи
> лише деактивує персонажів цієї групи. Скористайся кнопкою **Відв'язати
> акаунт** у застосунку.

## Пов'язане \[#related]

* [Бот для Discord](https://reverie.im/uk/docs/integrations/discord-bot) — ті самі персонажі на сервері Discord
* [Reverie Labs](https://reverie.im/uk/docs/integrations/labs) — де розміщено панель інтеграцій
* [Кредити](https://reverie.im/uk/docs/billing/credits) — скільки коштує повідомлення
* [Підписки](https://reverie.im/uk/docs/billing/subscriptions) — що входить у тариф