# Bot Telegram

> Rozmawiaj w cztery oczy na prywatnym czacie, sprowadzaj postacie do grup, udostępniaj je inline albo otwórz Mini App.

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

Bot Reverie wprowadza postacie do Telegrama — do prywatnej rozmowy z botem, do grupy albo do kanału, którym bot administruje. Potrafi też otworzyć samą Reverie wewnątrz Telegrama jako Mini Aplikację, gdzie kupisz kredyty za Telegram Stars.

## Jak to ustawić \[#set-it-up]

### Połącz swoje konto \[#link-your-account]

Każdy, kto rozmawia z postacią, potrzebuje konta Reverie połączonego ze swoim kontem Telegrama (wystarczy darmowe). Jedno konto Telegrama odpowiada dokładnie jednemu kontu Reverie.

* **Ze strony.** W aplikacji wejdź w **Labs → Boty Discord i Telegram** i naciśnij **Połącz w Telegramie** na karcie Telegrama. Telegram otworzy czat z botem; uruchom bota i jesteś połączony z kontem, na którym jesteś zalogowany. Strona odświeży się sama.
* **Z Telegrama.** Otwórz bota i wyślij `/start`. **Kontynuuj przez Telegram** tworzy darmowe konto Reverie przez Mini App, bez adresu e-mail. **Mam już konto** zamiast tego wysyła jednorazowy link, ważny **10 minut**, który łączy twój Telegram z istniejącym kontem; ten sam link w każdej chwili wysyła `/link`.

### Wybierz postać \[#pick-a-character]

Wyślij `/chat`, żeby zobaczyć, z kim możesz rozmawiać — najpierw postacie, z którymi już tu rozmawiasz, potem propozycje — albo `/chat` z imieniem, żeby poszukać. Dotknij jednej i zacznij pisać.

### Sprowadź postacie do grupy \[#bring-characters-into-a-group]

Opcjonalnie. Dodaj bota do grupy — zrobi to **Dodaj bota do grupy** na karcie Telegrama — i wyślij tam `/add <name>`. Bot szuka i pokazuje do ośmiu trafień jako przyciski; dotknij jednego, żeby je dodać. Postacie mogą dodawać tylko administratorzy grupy.

## Twój prywatny czat \[#your-private-chat]

Prywatny czat z botem to twoja własna rozmowa, rozliczana z twojego własnego konta. Każda wiadomość dostaje odpowiedź — bez oznaczania.

* **Jedna postać naraz.** `/chat` przełącza na kogoś innego, a `/chats` pokazuje postacie, z którymi tu rozmawiałeś. Każda ma własną rozmowę, więc po powrocie ciągniesz ją od miejsca, w którym skończyłeś.
* `/remove` kończy bieżącą rozmowę — zostaje zapisana dla `/chats` — a `/reset` ją czyści, gdy to potwierdzisz.
* **Postacie 18+** stosują się do ustawienia 18+ twojego konta: gdy jest wyłączone, są ukryte i nie mogą tu rozmawiać.
* Twoje ostatnie rozmowy widać też w panelu integracji w sekcji **Prywatny czat** — **Kontynuuj na stronie** wznawia rozmowę w przeglądarce, a **Czatuj w aplikacji Telegram** wraca tutaj.

## Polecenia \[#commands]

Przycisk menu obok pola tekstowego pokazuje polecenia działające tam, gdzie jesteś — prywatny czat i grupy mają osobne listy, w języku twojego Telegrama.

| Polecenie            | Argument                        | Gdzie                                | Co robi                                                                                                                                 |
| -------------------- | ------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| `/start`             | —                               | prywatny                             | Zakłada ci konto albo je łączy, a potem proponuje postacie. W grupie — jak `/help`                                                      |
| `/help`              | —                               | oba                                  | Lista poleceń                                                                                                                           |
| `/chat`              | imię (opcjonalne)               | prywatny                             | Wybiera lub zmienia postać, z którą rozmawiasz                                                                                          |
| `/chats`             | —                               | prywatny                             | Postacie, z którymi rozmawiałeś, do przełączania                                                                                        |
| `/link`              | —                               | prywatny                             | Jednorazowy link łączący twój Telegram z istniejącym kontem Reverie                                                                     |
| `/add`               | tekst wyszukiwania (opcjonalny) | grupa, administratorzy               | Szuka postaci i dodaje tę, którą dotkniesz. Na prywatnym czacie — jak `/chat`                                                           |
| `/remove`            | —                               | grupa, administratorzy               | Pokazuje postacie grupy jako przyciski; usuwa tę, którą dotkniesz. Na prywatnym czacie kończy bieżącą rozmowę                           |
| `/list`              | —                               | grupa                                | Postacie w tej grupie. Na prywatnym czacie — jak `/chats`                                                                               |
| `/info`              | imię postaci                    | oba                                  | Szczegóły postaci. Na prywatnym czacie samo `/info` opisuje postać, z którą rozmawiasz; w grupie imię jest wymagane                     |
| `/settings`          | podklucz (opcjonalny)           | oba                                  | Otwiera menu ustawień                                                                                                                   |
| `/plugins`           | —                               | oba                                  | Wtyczki działające na tym czacie, z przyciskami do instalowania, usuwania, włączania i wyłączania wtyczek oficjalnych i twoich własnych |
| `/group`             | —                               | grupa, administratorzy lub gospodarz | Kto może rozmawiać, dzienny limit na osobę, zablokowane osoby i zużycie. Otwiera się na twoim prywatnym czacie                          |
| `/block`, `/unblock` | —                               | grupa, administratorzy lub gospodarz | Wysyłane jako odpowiedź na wiadomość członka: zabraniają mu rozmawiać z postaciami albo znów na to pozwalają                            |
| `/reset`             | —                               | oba, w grupie administratorzy        | Czyści historię tego czatu                                                                                                              |
| `/regenerate`        | —                               | oba                                  | Generuje ponownie ostatnią odpowiedź                                                                                                    |
| `/suggest`           | —                               | oba                                  | Trzy proponowane odpowiedzi                                                                                                             |
| `/account`           | —                               | oba                                  | Kredyty i stan subskrypcji                                                                                                              |
| `/daily`             | —                               | prywatny                             | Odbiera codzienną nagrodę                                                                                                               |
| `/notify`            | —                               | prywatny                             | Czy postacie mogą pisać do ciebie pierwsze i które powiadomienia trafiają tutaj                                                         |
| `/buy`               | —                               | prywatny                             | Kup subskrypcję lub pakiet kredytów za Telegram Stars                                                                                   |
| `/app`               | —                               | oba                                  | Otwiera Mini App Reverie                                                                                                                |
| `/paysupport`        | —                               | oba                                  | Pomoc w płatnościach. Zarejestrowane, ale niewidoczne w menu                                                                            |

`/plugins` wypisuje wtyczki promptów i narzędzi działające na tym czacie, a administratorom lub osobie, która dodała postać, daje przyciski do instalowania wtyczek oficjalnych i własnych, usuwania ich oraz włączania i wyłączania. Wtyczki, która wymaga wypełnienia ustawień, nie da się zainstalować z bota. Wynik wtyczki narzędziowej jest publikowany na czacie jako krótka karta.

### Ustawienia \[#settings]

`/settings` otwiera menu w rozmowie, albo skocz prosto do strony przez `/settings model`, `language`, `mode`, `style`, `payment` lub `limit`.

| Pozycja menu           | Zakres                                             | W grupach tylko dla adminów |
| ---------------------- | -------------------------------------------------- | --------------------------- |
| **Model (personal)**   | Twój własny model dla głównej postaci tej rozmowy  | nie                         |
| **Language (chat)**    | Język odpowiedzi w rozmowie                        | tak                         |
| **Chat mode**          | Odpowiadać na wszystko, czy tylko gdy się zwrócisz | tak                         |
| **Chat style**         | Proza odgrywania ról, czy sam dialog               | tak                         |
| **Payment mode**       | Płaci właściciel czy płaci piszący                 | tak                         |
| **Daily credit limit** | Pułap kredytów na dobę UTC                         | tak                         |

Na prywatnym czacie menu oferuje \*\*Model (personal)\*\*, **Reply language** i **Chat style**: prywatny czat zawsze odpowiada, a za swoje wiadomości płacisz sam. W grupie menu i komunikaty o błędach po chwili same się usuwają, żeby czat był czysty.

## Grupy i kanały \[#groups-and-channels]

W grupie postacie odzywają się, gdy zostaną **@oznaczone** albo gdy **odpowiesz** na którąś z ich wiadomości — automatyczne odpowiedzi są domyślnie wyłączone, więc dodanie postaci do ruchliwej grupy nie sprawi, że zagłuszy wszystkich. Włącza je `/settings mode`. Jeśli po dołączeniu bot napisał, że widzi tylko wiadomości, które go oznaczają lub mu odpowiadają, zrób go administratorem grupy: automatyczne odpowiedzi muszą widzieć każdą wiadomość.

W grupie z tematami każda odpowiedź trafia do tematu, na który odpowiada. Grupa ma jedną obsadę i jedną historię dla wszystkich tematów.

Bot może też publikować na **kanale** Telegrama, jeśli zrobiono go tam administratorem.

## Zasady grupy \[#group-rules]

Wyślij `/group` w grupie. Panel otwiera się na twoim prywatnym czacie z botem, żeby grupa nie patrzyła, jak go ustawiasz — jeśli nigdy nie zacząłeś prywatnego czatu z botem, najpierw poprosi cię o jego otwarcie. Mogą z niego korzystać administratorzy grupy oraz ten, kto płaci za jej postacie. Pokazuje zużycie z dziś i z ostatnich siedmiu dni, osoby, które dziś wydały najwięcej, i zasady:

| Zasada                     | Wybór                                                                                                                                         |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Kto może rozmawiać**     | **Wszyscy** (domyślnie) lub **Tylko administratorzy**                                                                                         |
| **Dzienny limit na osobę** | Ile kredytów gospodarza jedna osoba może wydać w ciągu doby UTC, albo **Bez limitu** (domyślnie). Obowiązuje tylko tam, gdzie płaci gospodarz |
| **Zablokowane osoby**      | Odpowiedz w grupie `/block` na wiadomość członka, żeby nie mógł już rozmawiać z postaciami; `/unblock`, wysłane tak samo, to cofa             |

Administratorzy i płacące konto nigdy nie zostają odcięci — ani blokadą, ani trybem dostępu. Osoba, której tryb dostępu nie wpuszcza, raz dowiaduje się, że z postaciami mogą rozmawiać tylko niektórzy; zablokowana osoba nie dostaje żadnej odpowiedzi.

## Udostępnianie postaci \[#sharing-a-character]

Na dowolnym czacie Telegrama — nawet takim, na którym nie ma bota — wpisz @nazwę bota, a po niej imię postaci, i wybierz ją z listy. Na czacie pojawi się karta, której przycisk otwiera w bocie rozmowę w cztery oczy z tą postacią. Dostępne są tylko publiczne postacie, które nie są 18+.

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

`/app` otwiera Reverie w przeglądarce Telegrama, zalogowaną z twojego konta Telegrama — pełną aplikację, z twoimi postaciami, rozmowami i kredytami.

Jeśli bot odpowie, że aplikacja jest niedostępna, Mini Aplikacja nie jest włączona — otwórz Reverie w przeglądarce.

## Płacenie przez Telegram Stars \[#paying-with-telegram-stars]

`/buy` przeprowadza cały zakup wewnątrz Telegrama. Bez subskrypcji wybierasz między planem a pakietem kredytów; z subskrypcją idziesz prosto do pakietów kredytów, z naliczonym bonusem subskrybenta. Wybór jednego publikuje natywną fakturę Stars z przyciskiem **Pay**.

`/buy` działa tylko w rozmowach prywatnych — faktura w grupie obciążyłaby tego, kto ją dotknie.

## Kto płaci \[#who-pays]

| Tryb płatności             | Obciążane konto                                                                                                | Jakie limity obowiązują                                                        |
| -------------------------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **Owner pays** (domyślnie) | Gospodarz grupy: konto Reverie, które jako pierwsze dodało postać do grupy, dopóki ktoś inny tego nie przejmie | Dzienny limit kredytów grupy i dzienny limit na osobę ustawiony przez `/group` |
| **User pays**              | Saldo każdego nadawcy z osobna                                                                                 | Żadne — każdego ogranicza jego własne saldo                                    |

Wiadomości kosztują tyle co w aplikacji webowej. Dzienne liczniki zerują się o **00:00 UTC**. Żeby przejąć rachunek grupy na własne konto, otwórz `/group` i naciśnij **Płać z mojego konta**. Na swoim prywatnym czacie zawsze płacisz za własne wiadomości.

## Co działa w Telegramie \[#what-works-in-telegram]

* **Obrazy.** Postacie mogą generować obrazy.
* **Głos na wyjściu.** Postacie mogą wysyłać wiadomości głosowe.
* **Głos na wejściu.** Notatki głosowe i pliki dźwiękowe są spisywane, do **25 MB**.
* **Pamięć.** Gdy model obsługuje narzędzia, postacie zapisują i aktualizują wspomnienia, a kanon z ksiąg świata trafia do ich kontekstu.
* **Historia.** Długie rozmowy są automatycznie streszczane w miarę, jak rosną.

## Powiadomienia i codzienne odebranie \[#notifications-and-check-ins]

`/notify` ustawia dwie rzeczy. **Postacie piszą pierwsze** to poziom proaktywności twojego konta, to samo ustawienie co na stronie: z subskrypcją postać, z którą właśnie rozmawiasz na prywatnym czacie, może napisać do ciebie pierwsza — zobacz [Wiadomości z inicjatywy postaci](https://reverie.im/pl/docs/chatting/proactive-messages). **Wysyłaj mi też tutaj** wybiera, które z twoich powiadomień Reverie trafiają także na prywatny czat; na początku włączone jest tylko **Konto i płatności** — zobacz [Powiadomienia](https://reverie.im/pl/docs/account/notifications). Panel integracji oferuje te same opcje.

`/daily` odbiera twoją [codzienną nagrodę](https://reverie.im/pl/docs/rewards/daily-check-in) — tę samą co na stronie — i otwiera losowanie w Mini App.

## Limity \[#limits]

| Limit                                       | Wartość      |
| ------------------------------------------- | ------------ |
| Postacie na rozmowę                         | 5            |
| Długość wiadomości                          | 4 096 znaków |
| Rozmiar wejścia głosowego                   | 25 MB        |
| Wiadomości w kolejce na rozmowę             | 3            |
| Wyniki wyszukiwania pokazywane przez `/add` | 8            |

Szybkie, następujące po sobie wiadomości tej samej osoby są łączone w jedną turę.

## Rozłączanie \[#unlinking]

Rozłącz w panelu integracji przyciskiem **Unlink Account**.

> Zablokowanie bota w Telegramie nie rozłącza twojego konta. Usunięcie bota z grupy wyłącza tylko postacie tej grupy. Użyj **Unlink Account** w aplikacji.

## Powiązane \[#related]

* [Bot Discord](https://reverie.im/pl/docs/integrations/discord-bot) — te same postacie, na serwerze
* [Reverie Labs](https://reverie.im/pl/docs/integrations/labs) — gdzie mieszka panel integracji
* [Kredyty](https://reverie.im/pl/docs/billing/credits) — ile kosztuje wiadomość
* [Subskrypcje](https://reverie.im/pl/docs/billing/subscriptions) — co zawiera plan