# Telegram ボット

> 個人チャットでキャラクターと 1 対 1 で話し、グループにキャラクターを呼び、インラインで共有し、ミニアプリを開く。

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

Reverie のボットはキャラクターを Telegram に連れてきます——ボットとの個人チャット、グループ、あるいはボットが管理者になっているチャンネルで。さらに、Telegram の中でミニアプリとして Reverie そのものを開くこともでき、そこでは Telegram Stars でクレジットを買えます。

## 設定する \[#set-it-up]

### アカウントを連携する \[#link-your-account]

キャラクターと話す人は全員、自分の Telegram アカウントに連携した Reverie アカウントが必要です——無料のもので十分です。1 つの Telegram アカウントは、ちょうど 1 つの Reverie アカウントに対応します。

* **ウェブサイトから。** アプリで **Labs → Discord & Telegram ボット** に進み、Telegram のカードで **Telegramで連携** を押します。Telegram でボットとのチャットが開くので、「開始」をタップすれば、サインイン中のアカウントに連携されます。ページは自動で更新されます。
* **Telegram から。** ボットを開いて `/start` を送ります。**Telegramで続ける** はミニアプリを通じて無料の Reverie アカウントを作ります。メールアドレスは要りません。**すでにアカウントがあります** は、**10 分**有効な使い捨てリンクを送り、代わりに既存のアカウントへ Telegram をつなぎます。同じリンクは `/link` でいつでも送られます。

### キャラクターを選ぶ \[#pick-a-character]

`/chat` を送ると、話せる相手が表示されます——まずここですでに話しているキャラクター、次におすすめです。`/chat` に名前を付ければ検索できます。1 人タップして、書き始めてください。

### グループにキャラクターを呼ぶ \[#bring-characters-into-a-group]

任意です。ボットをグループに追加し——Telegram のカードの **ボットをグループに追加** でできます——そこで `/add <name>` を送ります。ボットが検索して最大 8 件の候補をボタンで出すので、1 つタップすると追加されます。キャラクターを追加できるのはグループの管理者だけです。

## 個人チャット \[#your-private-chat]

ボットとの個人チャットはあなただけの会話で、費用はあなた自身のアカウントに請求されます。どのメッセージにも返信が来ます——メンションは要りません。

* **一度に 1 人のキャラクター。** `/chat` で別のキャラクターに切り替え、`/chats` でここで話したことのあるキャラクターを一覧できます。それぞれが自分の会話を持っているので、戻れば前回の続きから話せます。
* `/remove` は今の会話を終えます——会話は保存され、`/chats` から戻れます。`/reset` は確認のうえで会話を消去します。
* **18 歳以上向けのキャラクター** は、アカウントの 18 歳以上向け設定に従います。オフなら表示されず、ここで話すこともできません。
* 最近の会話は連携ダッシュボードの **プライベートチャット** にも表示され、**Webで続ける** でブラウザから続きを話し、**Telegramでチャット** でここに戻れます。

## コマンド \[#commands]

入力欄の横のメニューボタンには、その場所で使えるコマンドが並びます——個人チャットとグループはそれぞれ別の一覧で、あなたの Telegram の言語で表示されます。

| コマンド                | 引数       | 使える場所            | 内容                                                            |
| ------------------- | -------- | ---------------- | ------------------------------------------------------------- |
| `/start`            | —        | 個人チャット           | 登録または連携をしてから、キャラクターを提案する。グループでは `/help` と同じ                   |
| `/help`             | —        | 両方               | コマンドの一覧を表示                                                    |
| `/chat`             | 名前（任意）   | 個人チャット           | 話しているキャラクターを選ぶ・切り替える                                          |
| `/chats`            | —        | 個人チャット           | 話したことのあるキャラクターを切り替える                                          |
| `/link`             | —        | 個人チャット           | 既存の Reverie アカウントに Telegram をつなぐ使い捨てリンク                       |
| `/add`              | 検索語（任意）  | グループ、管理者         | キャラクターを検索し、タップしたものを追加する。個人チャットでは `/chat` と同じ                  |
| `/remove`           | —        | グループ、管理者         | グループのキャラクターをボタンで一覧し、タップしたものを外す。個人チャットでは今の会話を終える               |
| `/list`             | —        | グループ             | このグループのキャラクター。個人チャットでは `/chats` と同じ                           |
| `/info`             | キャラクター名  | 両方               | キャラクターの詳細。個人チャットでは名前なしの `/info` で今話しているキャラクターを説明し、グループでは名前が必須 |
| `/settings`         | サブキー（任意） | 両方               | 設定メニューを開く                                                     |
| `/plugins`          | —        | 両方               | このチャットで動いているプラグインと、公式プラグインや自分のプラグインを追加・削除・切り替えるボタン            |
| `/group`            | —        | グループ、管理者または支払い担当 | 話せる人、メンバーごとの 1 日の上限、ブロック中のメンバー、使用量。個人チャットで開く                  |
| `/block`、`/unblock` | —        | グループ、管理者または支払い担当 | メンバーのメッセージへの返信として送る。その人がキャラクターと話せないようにする、または元に戻す              |
| `/reset`            | —        | 両方、グループでは管理者     | このチャットの履歴を消去                                                  |
| `/regenerate`       | —        | 両方               | 最後の返信を引き直す                                                    |
| `/suggest`          | —        | 両方               | 返信候補を 3 つ                                                     |
| `/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 の 1 日あたりのクレジット上限         | はい          |

個人チャットのメニューにあるのは **Model (personal)**、**Reply language**、**Chat style** です。個人チャットはいつも返信し、自分のメッセージは自分で払うからです。グループでは、メニューとエラーの返信はしばらくすると自動で消え、チャットをすっきり保ちます。

## グループとチャンネル \[#groups-and-channels]

グループでは、キャラクターは **@メンション**されたとき、またはその発言に**返信**したときに答えます——自動返信は既定でオフなので、にぎやかなグループにキャラクターを入れても、みんなの上にかぶせて話し出すことはありません。オンにするには `/settings mode` を使います。ボットが参加したときに、自分へのメンションや返信しか見えないと言っていたら、グループの管理者にしてください。自動返信にはすべてのメッセージが見える必要があります。

トピックのあるグループでは、返信はそれぞれ答えているトピックに投稿されます。キャラクターの顔ぶれと履歴は、グループ全体でトピックをまたいで 1 つです。

ボットは、管理者にしてもらえば Telegram の**チャンネル**にも投稿できます。

## グループのルール \[#group-rules]

グループで `/group` を送ります。パネルはボットとの個人チャットで開くので、調整する様子をグループに見られずに済みます——ボットと個人チャットを一度も始めていなければ、先に開くよう求められます。使えるのはグループの管理者と、グループのキャラクターの代金を払っている人です。今日と過去 7 日間の使用量、今日いちばん使ったメンバー、そして次のルールが表示されます。

| ルール              | 選択肢                                                                          |
| ---------------- | ---------------------------------------------------------------------------- |
| **話せる人**         | **全員**（既定）または **管理者のみ**                                                      |
| **メンバーごとの1日の上限** | 1 人のメンバーが UTC の 1 日に使える支払い担当のクレジットの量、または **上限なし**（既定）。支払い担当が払う場合だけ効く         |
| **ブロック中のメンバー**   | グループでメンバーのメッセージに `/block` と返信すると、その人はキャラクターと話せなくなる。同じように `/unblock` を送れば元に戻る |

管理者と支払い担当のアカウントは、ブロックでもアクセスモードでも締め出されることはありません。アクセスモードで外れたメンバーには、話せるのは一部のメンバーだけだと一度だけ伝えられます。ブロックされたメンバーには、返信そのものが来ません。

## キャラクターを共有する \[#sharing-a-character]

どの Telegram のチャットでも——ボットがいないチャットでも——ボットの @ユーザー名に続けてキャラクターの名前を入力し、一覧から選びます。カードが投稿され、そのボタンからボットの中でそのキャラクターとの 1 対 1 のチャットが開きます。表示されるのは、18 歳以上向けではない公開キャラクターだけです。

## ミニアプリ \[#the-mini-app]

`/app` は Telegram のブラウザの中で Reverie を開きます。Telegram アカウントでサインイン済みの、フル機能のアプリです——あなたの登録キャラクター、チャット、クレジットがそろっています。

ボットがアプリを利用できないと返してきたら、ミニアプリが有効になっていません——ブラウザで Reverie を開いてください。

## Telegram Stars で払う \[#paying-with-telegram-stars]

`/buy` は購入の一部始終を Telegram の中で完結させます。未加入ならプランとクレジットパックから選び、加入済みなら加入者ボーナスを適用した状態でクレジットパックへ直行します。選ぶと **Pay** ボタン付きの Stars 請求が投稿されます。

`/buy` は個人チャット限定です——グループでの請求は、押した人から引き落とされてしまうからです。

## 誰が払うか \[#who-pays]

| 支払いモード             | 請求先                                                         | 効く上限                                           |
| ------------------ | ----------------------------------------------------------- | ---------------------------------------------- |
| **Owner pays**（既定） | グループの支払い担当：そのグループに最初にキャラクターを追加した Reverie アカウント。ほかの誰かが引き継ぐまで | グループの 1 日のクレジット上限と、`/group` で決めたメンバーごとの 1 日の上限 |
| **User pays**      | 送信者それぞれの残高                                                  | なし——各メンバーは自分の残高の範囲まで                           |

メッセージの費用はウェブアプリと同じです。1 日のカウンターは **00:00 UTC** にリセットされます。グループの請求を自分のアカウントに移すには、`/group` を開いて **自分のアカウントで支払う** を押します。個人チャットでは、いつも自分のメッセージを自分で払います。

## Telegram で使えるもの \[#what-works-in-telegram]

* **画像。** キャラクターは画像を生成できます。
* **音声出力。** キャラクターはボイスメッセージを送れます。
* **音声入力。** ボイスメモや音声ファイルは文字起こしされます（**25 MB** まで）。
* **記憶。** モデルがツールに対応していれば、キャラクターは記憶を保存・更新し、ワールドブックの設定も文脈に入ります。
* **履歴。** 長くなったチャットは自動的に要約されます。

## 通知とチェックイン \[#notifications-and-check-ins]

`/notify` では 2 つのことを決めます。**キャラクターからの話しかけ** はアカウントの自発性のレベルで、ウェブサイトと同じ設定です。サブスクリプションがあれば、個人チャットで今話しているキャラクターがあなたに先に話しかけてくることがあります——[自発メッセージ](https://reverie.im/ja/docs/chatting/proactive-messages)を参照。**こちらにも送る** では、Reverie の通知のうちどれを個人チャットにも届けるかを選びます。最初は **アカウントと請求** だけがオンです——[通知](https://reverie.im/ja/docs/account/notifications)を参照。連携ダッシュボードでも同じ選択ができます。

`/daily` はウェブサイトと同じ[デイリーチェックイン](https://reverie.im/ja/docs/rewards/daily-check-in)を受け取り、ラッキー抽選をミニアプリで開きます。

## 上限 \[#limits]

| 上限                 | 値        |
| ------------------ | -------- |
| チャットあたりのキャラクター数    | 5        |
| メッセージ長             | 4,096 文字 |
| 音声入力のサイズ           | 25 MB    |
| チャットあたりの待ち行列メッセージ数 | 3        |
| `/add` が表示する検索結果数  | 8        |

同じ人からの連続した素早いメッセージは、1 ターンにまとめられます。

## 連携を解除する \[#unlinking]

連携ダッシュボードの **Unlink Account** で解除します。

> Telegram でボットをブロックしても、アカウントの連携は解除されません。ボットをグループから外した場合も、そのグループのキャラクターが止まるだけです。アプリの **Unlink Account** を使ってください。

## 関連 \[#related]

* [Discord ボット](https://reverie.im/ja/docs/integrations/discord-bot) —— 同じキャラクターを、サーバーで
* [Reverie Labs](https://reverie.im/ja/docs/integrations/labs) —— 連携ダッシュボードの場所
* [クレジット](https://reverie.im/ja/docs/billing/credits) —— メッセージ 1 通の費用
* [サブスクリプション](https://reverie.im/ja/docs/billing/subscriptions) —— プランに何が含まれるか