# Telegram-Bot

> Chatte privat unter vier Augen, hol Figuren in Gruppen, teile sie inline oder öffne die Mini-App.

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

Der Reverie-Bot bringt Figuren nach Telegram — in einen Privatchat mit dem Bot, in eine Gruppe oder in einen Kanal, in dem er Administrator ist. Er kann Reverie auch als Mini App innerhalb von Telegram öffnen, wo du mit Telegram Stars Guthaben kaufen kannst.

## Einrichten \[#set-it-up]

### Dein Konto verknüpfen \[#link-your-account]

Wer mit einer Figur redet, braucht ein Reverie-Konto, das mit seinem Telegram-Konto verknüpft ist — ein kostenloses reicht. Ein Telegram-Konto gehört zu genau einem Reverie-Konto.

* **Über die Website.** Geh in der App zu **Labs → Discord- & Telegram-Bots** und drücke auf der Telegram-Karte **In Telegram verknüpfen**. Telegram öffnet einen Chat mit dem Bot; tippe auf **Starten**, und du bist mit dem Konto verknüpft, mit dem du angemeldet bist. Die Seite aktualisiert sich von selbst.
* **Aus Telegram heraus.** Öffne den Bot und sende `/start`. **Weiter mit Telegram** legt über die Mini-App ein kostenloses Reverie-Konto an, ganz ohne E-Mail. **Ich habe schon ein Konto** schickt stattdessen einen Einmal-Link, **10 Minuten** gültig, der dein Telegram mit einem bestehenden Konto verbindet; `/link` schickt denselben Link jederzeit.

### Eine Figur wählen \[#pick-a-character]

Sende `/chat`, um zu sehen, mit wem du reden kannst — zuerst die Figuren, mit denen du hier schon sprichst, dann Vorschläge —, oder `/chat` mit einem Namen dahinter, um zu suchen. Tipp eine an und fang an zu schreiben.

### Figuren in eine Gruppe holen \[#bring-characters-into-a-group]

Optional. Füge den Bot einer Gruppe hinzu — **Bot zu einer Gruppe hinzufügen** auf der Telegram-Karte erledigt das — und sende dort `/add <name>`. Der Bot sucht und zeigt bis zu acht Treffer als Buttons; tippe einen an, um ihn hinzuzufügen. Nur Gruppen-Admins können Figuren hinzufügen.

## Dein Privatchat \[#your-private-chat]

Dein Privatchat mit dem Bot ist dein eigenes Gespräch und wird deinem eigenen Konto berechnet. Jede Nachricht bekommt eine Antwort — ohne Erwähnung.

* **Eine Figur auf einmal.** `/chat` wechselt zu jemand anderem, und `/chats` listet die Figuren, mit denen du hier gesprochen hast. Jede behält ihr eigenes Gespräch, du machst also beim Zurückwechseln genau dort weiter, wo du aufgehört hast.
* `/remove` beendet das aktuelle Gespräch — es bleibt für `/chats` gespeichert —, und `/reset` löscht es, nachdem du bestätigt hast.
* **18+-Figuren** folgen der 18+-Einstellung deines Kontos: Ist sie aus, sind sie verborgen und können hier nicht chatten.
* Deine letzten Gespräche erscheinen auch im Integrations-Dashboard unter **Privater Chat**, mit **Im Web weiterchatten**, um im Browser weiterzumachen, und **In Telegram chatten**, um zurückzukehren.

## Befehle \[#commands]

Der Menü-Button neben dem Eingabefeld listet die Befehle, die dort funktionieren, wo du gerade bist — Privatchat und Gruppe haben je eine eigene Liste, in deiner Telegram-Sprache.

| Befehl               | Argument                      | Wo                                | Was er tut                                                                                                                          |
| -------------------- | ----------------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `/start`             | —                             | privat                            | Meldet dich an oder verknüpft dich und bietet dann Figuren an. In einer Gruppe wie `/help`                                          |
| `/help`              | —                             | beides                            | Listet die Befehle auf                                                                                                              |
| `/chat`              | Name (optional)               | privat                            | Wählt oder wechselt die Figur, mit der du sprichst                                                                                  |
| `/chats`             | —                             | privat                            | Die Figuren, mit denen du gesprochen hast, zum Wechseln                                                                             |
| `/link`              | —                             | privat                            | Ein Einmal-Link, der dein Telegram mit einem bestehenden Reverie-Konto verbindet                                                    |
| `/add`               | Suchtext (optional)           | Gruppe, Admins                    | Sucht Figuren und fügt die angetippte hinzu. Im Privatchat wie `/chat`                                                              |
| `/remove`            | —                             | Gruppe, Admins                    | Listet die Figuren der Gruppe als Buttons; entfernt die angetippte. Im Privatchat beendet er das aktuelle Gespräch                  |
| `/list`              | —                             | Gruppe                            | Die Figuren dieser Gruppe. Im Privatchat wie `/chats`                                                                               |
| `/info`              | Name der Figur                | beides                            | Details zur Figur. Im Privatchat beschreibt ein bloßes `/info` die Figur, mit der du sprichst; in einer Gruppe ist der Name Pflicht |
| `/settings`          | ein Unterschlüssel (optional) | beides                            | Öffnet das Einstellungsmenü                                                                                                         |
| `/plugins`           | —                             | beides                            | Plugins, die in diesem Chat laufen, mit Buttons zum Installieren, Entfernen oder Schalten offizieller und eigener Plugins           |
| `/group`             | —                             | Gruppe, Admins oder der Gastgeber | Wer chatten darf, ein Tageslimit pro Mitglied, blockierte Mitglieder und Verbrauch. Öffnet sich in deinem Privatchat                |
| `/block`, `/unblock` | —                             | Gruppe, Admins oder der Gastgeber | Als Antwort auf die Nachricht eines Mitglieds gesendet: hindert es daran, mit Figuren zu reden, oder erlaubt es wieder              |
| `/reset`             | —                             | beides, in einer Gruppe Admins    | Löscht den Verlauf dieses Chats                                                                                                     |
| `/regenerate`        | —                             | beides                            | Würfelt die letzte Antwort neu                                                                                                      |
| `/suggest`           | —                             | beides                            | Drei Antwortvorschläge                                                                                                              |
| `/account`           | —                             | beides                            | Guthaben und Abo-Status                                                                                                             |
| `/daily`             | —                             | privat                            | Holt deine tägliche Belohnung ab                                                                                                    |
| `/notify`            | —                             | privat                            | Ob Figuren dir zuerst schreiben dürfen, und welche Benachrichtigungen hier ankommen                                                 |
| `/buy`               | —                             | privat                            | Ein Abo oder ein Guthabenpaket mit Telegram Stars kaufen                                                                            |
| `/app`               | —                             | beides                            | Öffnet die Reverie-Mini-App                                                                                                         |
| `/paysupport`        | —                             | beides                            | Zahlungssupport. Registriert, aber nicht im Menü aufgeführt                                                                         |

`/plugins` listet die in diesem Chat laufenden Prompt- und Tool-Plugins auf und bietet Admins oder wer einen Charakter hinzugefügt hat Buttons, um offizielle und eigene Plugins zu installieren, zu entfernen oder ein- und auszuschalten. Ein Plugin, das ausgefüllte Einstellungen braucht, lässt sich nicht über den Bot installieren. Das Ergebnis eines Tool-Plugins wird als kurze Karte in den Chat gepostet.

### Einstellungen \[#settings]

`/settings` öffnet ein Inline-Menü, oder du springst mit `/settings model`, `language`, `mode`, `style`, `payment` oder `limit` direkt auf eine Seite.

| Menüeintrag            | Geltungsbereich                                             | In Gruppen nur für Admins |
| ---------------------- | ----------------------------------------------------------- | ------------------------- |
| **Model (personal)**   | Dein eigenes Modell für die Hauptfigur dieses Chats         | nein                      |
| **Language (chat)**    | Antwortsprache des Chats                                    | ja                        |
| **Chat mode**          | Auf alles antworten, oder nur, wenn man die Figur anspricht | ja                        |
| **Chat style**         | Rollenspielprosa, oder nur Dialog                           | ja                        |
| **Payment mode**       | Besitzer zahlt oder Nutzer zahlt                            | ja                        |
| **Daily credit limit** | Guthaben-Obergrenze pro UTC-Tag                             | ja                        |

Im Privatchat bietet das Menü **Model (personal)**, **Reply language** und **Chat style**: Ein Privatchat antwortet immer, und du zahlst deine eigenen Nachrichten. In einer Gruppe löschen sich Menüs und Fehlermeldungen nach kurzer Zeit selbst, damit der Chat aufgeräumt bleibt.

## Gruppen und Kanäle \[#groups-and-channels]

In einer Gruppe antworten Figuren, wenn sie **@erwähnt** werden oder wenn du auf eine ihrer Nachrichten **antwortest** — die automatische Antwort ist standardmäßig aus, eine Figur in einer lebhaften Gruppe redet also nicht über alle hinweg. `/settings mode` schaltet sie ein. Hat der Bot beim Beitritt gesagt, dass er nur Nachrichten sieht, die ihn erwähnen oder auf ihn antworten, mach ihn zum Admin der Gruppe: Die automatische Antwort muss jede Nachricht sehen.

In einer Gruppe mit Themen landet jede Antwort in dem Thema, auf das sie antwortet. Die Gruppe behält über alle Themen hinweg eine Besetzung und einen Verlauf.

Der Bot kann auch in einem Telegram-**Kanal** posten, wenn er dort zum Administrator gemacht wurde.

## Gruppenregeln \[#group-rules]

Sende `/group` in der Gruppe. Das Panel öffnet sich in deinem Privatchat mit dem Bot, damit die Gruppe dir nicht beim Einstellen zusieht — hast du nie einen Privatchat mit dem Bot begonnen, bittet er dich zuerst, einen zu öffnen. Nutzen können es die Admins der Gruppe und wer für ihre Figuren zahlt. Es zeigt den Verbrauch von heute und der letzten sieben Tage, die Mitglieder mit dem höchsten Verbrauch heute und die Regeln:

| Regel                       | Auswahl                                                                                                                                                       |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Wer chatten darf**        | **Alle** (Standard) oder **Nur Admins**                                                                                                                       |
| **Tageslimit pro Mitglied** | Wie viel vom Guthaben des Gastgebers ein Mitglied pro UTC-Tag ausgeben darf, oder **Kein Limit** (Standard). Gilt nur, wo der Gastgeber zahlt                 |
| **Blockierte Mitglieder**   | Antworte in der Gruppe mit `/block` auf die Nachricht eines Mitglieds, damit es nicht mehr mit Figuren reden kann; `/unblock`, genauso gesendet, hebt das auf |

Admins und das zahlende Konto werden nie ausgesperrt, weder durch eine Blockierung noch durch den Zugriffsmodus. Wer vom Zugriffsmodus ausgeschlossen ist, erfährt einmal, dass nur manche Mitglieder mit Figuren reden können; ein blockiertes Mitglied bekommt gar keine Antwort.

## Eine Figur teilen \[#sharing-a-character]

Tippe in einem beliebigen Telegram-Chat — auch in einem, in dem der Bot nicht ist — den @Benutzernamen des Bots und dahinter den Namen einer Figur, und wähle eine aus der Liste. Das postet eine Karte, deren Button im Bot einen Chat unter vier Augen mit dieser Figur öffnet. Angeboten werden nur öffentliche Figuren, die nicht 18+ sind.

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

`/app` öffnet Reverie im Browser von Telegram, angemeldet über dein Telegram-Konto — die vollständige App, mit deinen Figuren, deinen Chats und deinem Guthaben.

Antwortet der Bot, die App sei nicht verfügbar, ist die Mini App nicht eingeschaltet — öffne Reverie stattdessen im Browser.

## Mit Telegram Stars bezahlen \[#paying-with-telegram-stars]

`/buy` wickelt den ganzen Kauf in Telegram ab. Ohne Abo wählst du zwischen einem Tarif und einem Guthabenpaket; mit Abo geht es direkt zu den Guthabenpaketen, mit deinem Abo-Bonus schon eingerechnet. Ein Klick darauf postet eine native Stars-Rechnung mit einem **Pay**-Knopf.

`/buy` ist auf Privatchats beschränkt — eine Rechnung in einer Gruppe würde der Person berechnet, die sie antippt.

## Wer zahlt \[#who-pays]

| Zahlungsmodus             | Belastet wird                                                                                                                 | Welche Limits gelten                                                                         |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **Owner pays** (Standard) | Der Gastgeber der Gruppe: das Reverie-Konto, das als erstes eine Figur in die Gruppe geholt hat, bis jemand anderes übernimmt | Das tägliche Guthaben-Limit der Gruppe und das mit `/group` gesetzte Tageslimit pro Mitglied |
| **User pays**             | Das Guthaben der jeweils sendenden Person                                                                                     | Keine — jedes Mitglied ist durch sein eigenes Guthaben begrenzt                              |

Nachrichten kosten dasselbe wie in der Web-App. Die Tageszähler werden um **00:00 UTC** zurückgesetzt. Um die Rechnung einer Gruppe auf dein eigenes Konto zu nehmen, öffne `/group` und drücke **Mit meinem Konto zahlen**. In deinem Privatchat zahlst du immer deine eigenen Nachrichten.

## Was in Telegram funktioniert \[#what-works-in-telegram]

* **Bilder.** Figuren können Bilder erzeugen.
* **Sprache raus.** Figuren können Sprachnachrichten senden.
* **Sprache rein.** Sprachnotizen und Audiodateien werden transkribiert, bis **25 MB**.
* **Erinnerung.** Figuren speichern und aktualisieren Erinnerungen, wenn das Modell Werkzeuge unterstützt, und der Kanon aus Weltbüchern kommt in ihren Kontext.
* **Verlauf.** Lange Chats werden automatisch zusammengefasst, während sie wachsen.

## Benachrichtigungen und tägliche Belohnung \[#notifications-and-check-ins]

`/notify` stellt zwei Dinge ein. **Charaktere, die dir zuerst schreiben** ist die Proaktivitätsstufe deines Kontos, dieselbe Einstellung wie auf der Website: Mit einem Abo kann die Figur, mit der du in deinem Privatchat gerade sprichst, dir von sich aus schreiben — siehe [Nachrichten von sich aus](https://reverie.im/de/docs/chatting/proactive-messages). **Auch hier empfangen** wählt aus, welche deiner Reverie-Benachrichtigungen zusätzlich in deinem Privatchat ankommen; anfangs ist nur **Konto & Abrechnung** an — siehe [Benachrichtigungen](https://reverie.im/de/docs/account/notifications). Das Integrations-Dashboard bietet dieselbe Auswahl.

`/daily` holt deine [tägliche Belohnung](https://reverie.im/de/docs/rewards/daily-check-in) ab, dieselbe wie auf der Website, und öffnet die Glücksziehung in der Mini-App.

## Grenzen \[#limits]

| Grenze                        | Wert          |
| ----------------------------- | ------------- |
| Figuren pro Chat              | 5             |
| Nachrichtenlänge              | 4.096 Zeichen |
| Größe der Spracheingabe       | 25 MB         |
| Wartende Nachrichten pro Chat | 3             |
| Suchtreffer, die `/add` zeigt | 8             |

Schnell aufeinanderfolgende Nachrichten derselben Person werden zu einem Zug zusammengefasst.

## Verknüpfung lösen \[#unlinking]

Löse die Verknüpfung im Integrations-Dashboard mit **Unlink Account**.

> Den Bot in Telegram zu blockieren löst die Kontoverknüpfung nicht. Den Bot aus einer Gruppe zu entfernen deaktiviert nur die Figuren dieser Gruppe. Nutze **Unlink Account** in der App.

## Verwandt \[#related]

* [Discord-Bot](https://reverie.im/de/docs/integrations/discord-bot) — dieselben Figuren, in einem Server
* [Reverie Labs](https://reverie.im/de/docs/integrations/labs) — wo das Integrations-Dashboard wohnt
* [Credits](https://reverie.im/de/docs/billing/credits) — was eine Nachricht kostet
* [Abonnements](https://reverie.im/de/docs/billing/subscriptions) — was ein Tarif enthält
