# Bot Discord

> Rozmawiaj z postaciami w cztery oczy w wiadomościach prywatnych albo dodaj je na serwer i zdecyduj, kto może z nimi rozmawiać i kto płaci.

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

Bot Reverie sprowadza postacie w dwa miejsca Discorda: do twoich **wiadomości prywatnych** z botem — na rozmowy w cztery oczy — i na **kanały serwerów**, gdzie każda postać mówi pod własnym imieniem i awatarem. Każdy, kto rozmawia z postacią, potrzebuje konta Reverie połączonego ze swoim kontem Discorda (wystarczy darmowe), a każda odpowiedź obciąża w kredytach jakieś konto Reverie.

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

Jedno konto Discorda odpowiada dokładnie jednemu kontu Reverie. Połączy je dowolny z tych sposobów:

* **Z panelu integracji.** W aplikacji wejdź w **Labs → Boty Discord i Telegram** i naciśnij **Połącz przez Discord** na karcie Discorda. Potwierdzasz na Discordzie i od razu wracasz.
* **Logując się przez Discord.** Logowanie do Reverie przez Discord łączy też bota — chyba że odłączyłeś go w panelu; wtedy zostaje odłączony, dopóki sam nie połączysz go ponownie.
* **Z Discorda.** Wykonaj `/link-account` na serwerze albo w wiadomościach prywatnych z botem. Odpowiedź widzisz tylko ty: przycisk **Połącz moje konto**, który działa raz i wygasa po **10 minutach**. Otwórz go, zaloguj się i konta są połączone.

## Rozmowy w cztery oczy w wiadomościach prywatnych \[#chat-one-on-one-in-your-dms]

Napisz do bota wiadomość prywatną albo wykonaj `/chat` na dowolnym serwerze, na którym jest bot — rozmowa przenosi się do twoich wiadomości prywatnych, gdzie widzisz ją tylko ty. Samo `/chat` proponuje postacie do wyboru; dopisz imię, żeby którejś poszukać.

* **Jedna postać naraz.** `/chat` przełącza na kogoś innego, a `/chats` pokazuje postacie, z którymi rozmawiałeś w wiadomościach prywatnych. Każda ma własną rozmowę, więc po powrocie ciągniesz ją od miejsca, w którym skończyłeś.
* **Każda wiadomość dostaje odpowiedź**, publikowaną przez bota z imieniem postaci małym drukiem nad nią. Obrazy, wiadomości głosowe i pamięć działają tak jak na kanale.
* **Płacisz za własne wiadomości.** Tryby płatności i limity serwera tu nie obowiązują.
* **Postacie 18+** stosują się do ustawienia 18+ twojego konta: gdy jest wyłączone, są ukryte i nie mogą rozmawiać w wiadomościach prywatnych.
* `/remove-character` kończy bieżącą rozmowę — zostaje zapisana dla `/chats` — a `/reset-chat` ją czyści, gdy to potwierdzisz.
* Spośród podpoleceń `/settings` w wiadomościach prywatnych działają tylko `model`, `language` i `chat-style`.

Jeśli bot mówi, że nie mógł do ciebie napisać, zezwól w ustawieniach prywatności Discorda na wiadomości prywatne od członków serwera i spróbuj ponownie. Twoje ostatnie rozmowy prywatne widać też w panelu integracji w sekcji **Prywatny czat**, gdzie **Kontynuuj na stronie** wznawia rozmowę w przeglądarce.

## Dodaj bota do serwera \[#add-the-bot-to-a-server]

### Zaproś bota \[#invite-the-bot]

Naciśnij **Dodaj bota do serwera** na karcie Discorda w panelu integracji i wybierz serwer. Zostaw zaznaczone wszystkie żądane uprawnienia — tabela poniżej wyjaśnia, po co jest każde z nich. Po dołączeniu bot publikuje krótki poradnik na start tam, gdzie serwer pokazuje wiadomości o nowych członkach.

### Dodaj postać do kanału \[#add-a-character-to-a-channel]

Na kanale tekstowym wykonaj `/add-character` i wybierz postać z autouzupełniania — obejmuje postacie publiczne i twoje własne prywatne. Potrzebujesz uprawnienia **Manage Channels** i połączonego konta. Bot tworzy webhook, żeby postać mogła pisać pod własnym imieniem, i wysyła powitanie.

### Ustal zasady \[#set-the-rules]

Opcjonalnie. `/settings` decyduje, jak odpowiadają postacie na kanale i kto za nie płaci; `/server` decyduje, kto w ogóle może z nimi rozmawiać. Oba opisano niżej.

## Uprawnienia, o które prosi zaproszenie \[#permissions-the-invite-requests]

| Uprawnienie         | Po co jest potrzebne                                                              |
| ------------------- | --------------------------------------------------------------------------------- |
| **View Channels**   | Czytanie kanału, na którym bot jest używany                                       |
| **Send Messages**   | Publikowanie odpowiedzi i wyników poleceń                                         |
| **Manage Messages** | Usuwanie odpowiedzi postaci, gdy skasowana zostaje wiadomość, która je wywołała   |
| **Embed Links**     | Wyniki poleceń i ogłoszenia losowania społeczności są osadzone                    |
| **Manage Roles**    | Przyznawanie roli używanej przez losowanie społeczności na serwerze samej Reverie |
| **Manage Webhooks** | **Obowiązkowe.** Postacie mówią przez webhooki, po jednym na postać               |

Bez **Manage Webhooks** polecenie `/add-character` zawodzi i postać nie zostaje dodana.

## Polecenia \[#commands]

Na serwerze polecenia oznaczone **Manage Channels** lub **Manage Server** są dostępne tylko dla członków z tym uprawnieniem Discorda. Odpowiedzi na polecenia konta i zarządzania widzisz tylko ty.

| Polecenie            | Opcje                   | Gdzie                                | Co robi                                                                                                                                                                                                                        |
| -------------------- | ----------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `/help`              | —                       | serwer, DM                           | Pokazuje listę poleceń, tylko tobie                                                                                                                                                                                            |
| `/link-account`      | —                       | serwer, DM                           | Publikuje jednorazowy link łączący twoje konta Discorda i Reverie                                                                                                                                                              |
| `/chat`              | `name` (opcjonalne)     | serwer, DM                           | Wybiera lub zmienia postać w wiadomościach prywatnych. Na serwerze wysyła wybór do twoich wiadomości prywatnych                                                                                                                |
| `/chats`             | —                       | serwer, DM                           | Postacie, z którymi rozmawiałeś w wiadomościach prywatnych, do przełączania                                                                                                                                                    |
| `/add-character`     | `name` (wymagane)       | serwer · Manage Channels             | Dodaje postać do tego kanału i każe jej się przywitać                                                                                                                                                                          |
| `/remove-character`  | `name` (wymagane)       | serwer · Manage Channels, DM         | Usuwa postać i kasuje jej webhook. W wiadomościach prywatnych kończy bieżącą rozmowę                                                                                                                                           |
| `/list-characters`   | —                       | serwer                               | Lista postaci tego kanału, każda z przyciskiem usuwania                                                                                                                                                                        |
| `/character-info`    | `name` (wymagane)       | serwer, DM                           | Bio, obrazy, wiek, płeć, ocena, kategorie, tagi i oznaczenie NSFW, z linkiem do strony postaci. Z połączonym kontem pokazuje też przyciski oceny 1–5★, gdy dostałeś już kilka odpowiedzi od postaci, a jej recenzje są otwarte |
| `/reset-chat`        | —                       | serwer · Manage Channels, DM         | Usuwa wiadomości i podsumowania kanału i podaje ich liczbę. W wiadomościach prywatnych czyści bieżącą rozmowę po potwierdzeniu                                                                                                 |
| `/regenerate-reply`  | `model` (opcjonalne)    | serwer, DM                           | Generuje ponownie ostatnią odpowiedź postaci, jeśli chcesz — innym modelem na tę próbę                                                                                                                                         |
| `/reply-suggestions` | —                       | serwer, DM                           | Trzy proponowane odpowiedzi jako przyciski; dotknięta zostaje wysłana jako twoja wiadomość                                                                                                                                     |
| `/settings`          | podpolecenie (wymagane) | serwer, DM                           | Ustawienia kanału i osobiste                                                                                                                                                                                                   |
| `/plugins`           | podpolecenie (wymagane) | serwer, DM                           | Pokazuje działające tu wtyczki; instaluje, usuwa, włącza i wyłącza wtyczki oficjalne i twoje własne                                                                                                                            |
| `/server`            | —                       | serwer · Manage Server lub gospodarz | Kto może rozmawiać z postaciami, dzienny limit na osobę, zablokowane osoby i zużycie                                                                                                                                           |
| `/my-account`        | —                       | serwer, DM                           | Kredyty, wykorzystanie planu, data odnowienia, liczba czatów                                                                                                                                                                   |
| `/daily`             | —                       | serwer, DM                           | Odbiera codzienną nagrodę                                                                                                                                                                                                      |
| `/notify`            | —                       | serwer, DM                           | Czy postacie mogą pisać do ciebie pierwsze i które powiadomienia trafiają do twoich wiadomości prywatnych                                                                                                                      |

`/plugins` przyjmuje `list`, `install`, `remove`, `enable` lub `disable`. Dostępne są tylko wtyczki oficjalne i twoje własne, i tylko wtyczki promptów i narzędzi; wtyczki, która wymaga wypełnienia ustawień, nie zainstalujesz z bota. Wynik wtyczki-narzędzia pojawia się jako krótka karta pod imieniem postaci. Na kanale zmiana wtyczek wymaga **Manage Channels** albo tego, żebyś dodał postać do kanału, a listę może zobaczyć każdy; w wiadomościach prywatnych decydujesz ty.

Samo `/settings` nie jest poprawnym poleceniem — zawsze przyjmuje jedno z sześciu podpoleceń:

| Podpolecenie             | Opcja                         | Wymaga          | Skutek                                                                                                                                |
| ------------------------ | ----------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `/settings model`        | `model` (opcjonalne)          | —               | **Twój** model dla głównej postaci tego kanału. Puste pokazuje bieżący albo go resetuje. Zaawansowane modele mogą wymagać subskrypcji |
| `/settings language`     | `language` (opcjonalne)       | Manage Channels | Język odpowiedzi na kanale. Puste przywraca angielski                                                                                 |
| `/settings channel-mode` | `mode`: `auto` albo `mention` | Manage Channels | Czy postacie odpowiadają na każdą wiadomość, czy tylko gdy się do nich zwrócisz                                                       |
| `/settings chat-style`   | `style`: `RP` albo `NORMAL`   | Manage Channels | Proza odgrywania ról z opisem działań albo sam dialog                                                                                 |
| `/settings payment-mode` | `mode`: `owner` albo `user`   | Manage Channels | Kogo obciążać                                                                                                                         |
| `/settings daily-limit`  | `credits` (wymagane, ≥ 0)     | Manage Channels | Pułap kredytów na dobę UTC. `0` oznacza bez limitu                                                                                    |

Te same ustawienia są w panelu webowym, osobno dla każdego kanału, jako **Payment mode**, **Daily credit limit**, **Chat style**, **Reply mode**, **Response language** i **Your model**. Język i model pozostają tam wyłączone, dopóki ktoś nie wyśle wiadomości na kanale.

## Kiedy postać odpowiada \[#when-a-character-replies]

Postać odzywa się, gdy zostanie **@oznaczona**, gdy ktoś **odpowie** na którąś z jej wiadomości albo gdy kanał jest w trybie automatycznych odpowiedzi. Automatyczne odpowiedzi są **domyślnie wyłączone**, więc świeżo dodana postać milczy, dopóki się do niej nie odezwiesz.

Gdy na jednym kanale jest kilka postaci, kanał zachowuje się jak jeden czat grupowy: jedno zapytanie wymienia wszystkie obecne postacie, a model decyduje, kto zabierze głos. Wymienienie imienia to wskazówka idąca razem z twoją wiadomością, a nie przełącznik zmuszający tę postać do odpowiedzi. [Czaty grupowe →](https://reverie.im/pl/docs/chatting/group-chats)

## Wątki \[#threads]

Wątek na kanale tekstowym rozmawia z postaciami tego kanału i trzyma się jego trybu płatności, trybu odpowiedzi i stylu czatu, ale prowadzi własną historię — miejsce na poboczną scenę, która nie zaśmieca kanału. Zaczyna w języku odpowiedzi kanału; `/settings language` i `/settings model` użyte w wątku działają tylko na niego. To, co wyda wątek, wlicza się do dziennego limitu kanału. Polecenia zmieniające obsadę lub pozostałe ustawienia kanału, takie jak `/add-character`, `/list-characters`, `/plugins` czy `/settings chat-style`, odsyłają cię do kanału nadrzędnego. Posty na forach i inne rodzaje wątków nie mają postaci.

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

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

Wiadomości kosztują tyle co w aplikacji webowej: za token, pomnożone przez mnożnik kredytowy modelu. Dzienne liczniki zerują się o **00:00 UTC**, a okno ustawień kanału w panelu pokazuje dzisiejsze zużycie na tle limitu.

Żeby przejąć rachunek na własne konto — na przykład gdy osoba, która skonfigurowała bota, odeszła — otwórz `/server` i naciśnij **Płać z mojego konta**. Dotyczy to każdego kanału na serwerze, na którym płaci gospodarz.

## Zasady serwera \[#server-rules]

`/server` otwiera panel, który widzisz tylko ty. Mogą go otworzyć członkowie z **Manage Server** oraz ten, kto płaci za postacie serwera. Pokazuje zużycie z dziś i z ostatnich siedmiu dni, osoby, które dziś wydały najwięcej, i trzy zasady:

| Zasada                     | Wybór                                                                                                                                         |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Kto może rozmawiać**     | **Wszyscy** (domyślnie), **Tylko administratorzy** lub **Członkowie z wybranymi rolami** — role wybiera się w drugim menu                     |
| **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**      | Wybrane tu osoby nie mogą rozmawiać z postaciami nigdzie na serwerze                                                                          |

Administrator to tu członek z **Manage Server**. Administratorzy i płacące konto nigdy nie zostają odcięci — ani blokadą, ani trybem dostępu — a dopóki nie wybrano żadnej roli, **Członkowie z wybranymi rolami** pozwala rozmawiać tylko im. 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.

## Postacie z ograniczeniem wiekowym \[#age-restricted-characters]

Postać 18+ odpowiada tylko na kanale z ograniczeniem wiekowym, na kanale w kategorii z ograniczeniem wiekowym albo gdziekolwiek na serwerze ustawionym jako 18+ — wątek podąża za swoim kanałem. Gdzie indziej bot zamiast odpowiedzi wyjaśnia powód. W wiadomościach prywatnych postacie 18+ stosują się natomiast do ustawienia 18+ twojego konta.

## Co działa na kanale \[#what-works-in-a-channel]

* **Obrazy.** Postacie mogą generować obrazy na Discordzie.
* **Głos na wyjściu.** Postacie mogą wysyłać wiadomości głosowe.
* **Głos na wejściu.** Wysłane przez ciebie wiadomości głosowe są spisywane, do **25 MB**.
* **Pamięć.** Gdy model obsługuje narzędzia, postacie zapisują, aktualizują i kasują wspomnienia, a kanon z ksiąg świata trafia do ich kontekstu.
* **Historia.** Długie kanały są automatycznie streszczane w miarę, jak rosną.
* Dodanie drugiej postaci do kanału przejmuje jego styl rozmowy, tryb płatności i dzienny limit.

## 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 w wiadomościach prywatnych, 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 do wiadomości prywatnych; 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 podaje link do losowania.

## Edytowanie i kasowanie wiadomości \[#editing-and-deleting-messages]

Edycja twojej najnowszej wiadomości uruchamia odpowiedź na nią od nowa.

> Skasowanie wiadomości na Discordzie usuwa tę wiadomość **i każdą wiadomość po niej** z historii postaci, razem ze wspomnieniami i załącznikami powstałymi po tym momencie. Odpowiedzi postaci też znikają z kanału. Tego nie da się cofnąć.

## Co bot czyta \[#what-the-bot-reads]

Bot dostaje każdą wiadomość z kanałów, które widzi — tak właśnie docierają do niego oznaczenia i odpowiedzi. Przed każdą odpowiedzią czyta też **najnowsze wiadomości z ostatniej godziny** na kanale, w tym te nieskierowane do niego, i podaje je modelowi jako kontekst, żeby postać nadążała za tym, co się dzieje.

Traktuj kanał z botem jak kanał, którego bot słucha. Jeśli nie o to ci chodzi, umieść postacie na osobnym kanale.

## Limity \[#limits]

| Limit                            | Wartość                    |
| -------------------------------- | -------------------------- |
| Postacie na kanał                | 5                          |
| Długość wiadomości na Discordzie | 2 000 znaków               |
| Rozmiar wiadomości głosowej      | 25 MB                      |
| Webhooki na kanał Discorda       | 15 (własny pułap Discorda) |
| Wiadomości w kolejce na kanał    | 3                          |

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

## Odłączanie \[#unlinking]

Odłącz konto w panelu integracji przyciskiem **Odłącz konto**. Usunięcie bota z serwera ani opuszczenie serwera nie odłącza twojego konta. Po odłączeniu logowanie przez Discord nie łączy już bota samo — gdy zechcesz go z powrotem, użyj **Połącz przez Discord** albo `/link-account`.

## Powiązane \[#related]

* [Bot Telegram](https://reverie.im/pl/docs/integrations/telegram-bot) — te same postacie, w Telegramie
* [Reverie Labs](https://reverie.im/pl/docs/integrations/labs) — gdzie mieszka panel integracji
* [Czaty grupowe](https://reverie.im/pl/docs/chatting/group-chats) — jak działają rozmowy z wieloma postaciami
* [Kredyty](https://reverie.im/pl/docs/billing/credits) — ile kosztuje wiadomość
