# Telegram 機器人

> 在私人聊天中和角色一對一聊天、把角色帶進群組、以內嵌方式分享角色，或開啟 Mini App。

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

Reverie 機器人把角色帶進 Telegram——可以是和機器人的私人聊天、群組，或由它擔任管理員的頻道。它也能在 Telegram 中以 Mini App 的形式直接開啟 Reverie，你可以在那裡用 Telegram Stars 購買點數。

## 開始設定 \[#set-it-up]

### 連結你的帳號 \[#link-your-account]

每個和角色聊天的人，都需要一個已連結自己 Telegram 帳號的 Reverie 帳號——免費帳號就夠了。一個 Telegram 帳號只能對應一個 Reverie 帳號。

* **從網站。** 在應用程式中前往**實驗室 → Discord 與 Telegram 機器人**，在 Telegram 卡片上按**在 Telegram 中連結**。Telegram 會開啟和機器人的聊天；點 **Start**，就會連結到你目前登入的帳號。頁面會自動更新。
* **從 Telegram。** 開啟機器人並傳送 `/start`。**使用 Telegram 繼續**會透過 Mini App 建立一個免費的 Reverie 帳號，不需要電子郵件。**我已經有帳號了**則會傳來一個一次性連結，**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`              | —         | 兩者皆可         | 開啟 Reverie Mini App                               |
| `/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 聊天中——即使機器人不在那裡——輸入機器人的 @使用者名稱，接著輸入角色的名稱，再從清單中挑選一個。這樣會發布一張卡片，卡片上的按鈕會在機器人中開啟和該角色的一對一聊天。只會提供非 18+ 的公開角色。

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

`/app` 會在 Telegram 的瀏覽器中開啟 Reverie，並以你的 Telegram 帳號登入——這是完整的應用程式，包括你的角色清單、你的聊天和你的點數。

如果機器人回覆應用程式無法使用，表示 Mini App 尚未開啟——請改用瀏覽器開啟 Reverie。

## 用 Telegram Stars 付款 \[#paying-with-telegram-stars]

`/buy` 會在 Telegram 中完成整個購買流程。尚未訂閱時，你可以在方案和點數包之間選擇；已經訂閱時，會直接進入點數包，並套用你的訂閱者加贈。選定之後，會發布一張 Telegram 原生的 Stars 帳單，上面附有 **Pay** 按鈕。

`/buy` 僅限在私人聊天中使用——如果帳單出現在群組中，點下它的人就會被收費。

## 由誰付費 \[#who-pays]

| 付費模式               | 計費對象                                       | 適用的上限                              |
| ------------------ | ------------------------------------------ | ---------------------------------- |
| **Owner pays**（預設） | 群組的付費方：第一個把角色加入這個群組的 Reverie 帳號，直到有其他人接手為止 | 群組的每日點數上限，以及用 `/group` 設定的每位成員每日上限 |
| **User pays**      | 每位發送者自己的餘額                                 | 無——每位成員只受自己的餘額限制                   |

訊息的花費和在網頁應用程式中一樣。每日計數會在 **00:00 UTC** 重設。如果你想把群組的費用轉到自己的帳號上，請開啟 `/group` 並按**用我的帳號付費**。在你的私人聊天中，你的訊息一律由你自己付費。

## Telegram 中可以使用的功能 \[#what-works-in-telegram]

* **圖片。** 角色可以生成圖片。
* **語音輸出。** 角色可以傳送語音訊息。
* **語音輸入。** 語音訊息和音訊檔案會被轉成文字，上限 **25 MB**。
* **記憶。** 當模型支援工具時，角色會儲存和更新記憶，世界書的設定也會納入它的上下文。
* **紀錄。** 聊天內容變長時，會自動產生摘要。

## 通知與簽到 \[#notifications-and-check-ins]

`/notify` 可以設定兩件事。**角色主動傳訊息給你**是你帳號的主動程度，與網站上的設定相同：有訂閱時，你在私人聊天中正在聊的角色可以主動傳訊息給你——請見[主動訊息](https://reverie.im/zh-TW/docs/chatting/proactive-messages)。**也傳送到這裡**用來選擇你的哪些 Reverie 通知也會送到你的私人聊天；一開始只開啟了**帳號與帳單**——請見[通知](https://reverie.im/zh-TW/docs/account/notifications)。整合主控台上也提供相同的選項。

`/daily` 會領取你的[每日簽到](https://reverie.im/zh-TW/docs/rewards/daily-check-in)，與網站上的簽到相同，並在 Mini App 中開啟抽獎。

## 限制 \[#limits]

| 限制              | 數值        |
| --------------- | --------- |
| 每個聊天的角色數        | 5         |
| 訊息長度            | 4,096 個字元 |
| 語音輸入大小          | 25 MB     |
| 每個聊天的排隊訊息數      | 3         |
| `/add` 顯示的搜尋結果數 | 8         |

同一個人快速連續傳送的訊息會合併成一輪。

## 取消連結 \[#unlinking]

在整合主控台上使用**取消連結帳號**即可取消連結。

> 在 Telegram 中封鎖機器人並不會取消你帳號的連結。把機器人從群組中移除，只會停用該群組的角色。請在應用程式中使用**取消連結帳號**。

## 相關內容 \[#related]

* [Discord 機器人](https://reverie.im/zh-TW/docs/integrations/discord-bot)——同樣的角色，在伺服器中
* [Reverie 實驗室](https://reverie.im/zh-TW/docs/integrations/labs)——整合主控台所在的位置
* [點數](https://reverie.im/zh-TW/docs/billing/credits)——一則訊息的花費
* [訂閱](https://reverie.im/zh-TW/docs/billing/subscriptions)——方案包含哪些內容