# Telegram 봇

> 개인 채팅에서 캐릭터와 일대일로 대화하고, 그룹에 캐릭터를 부르고, 인라인으로 공유하거나 미니 앱을 엽니다.

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

Reverie 봇은 캐릭터를 Telegram으로 데려옵니다 — 봇과의 개인 대화, 그룹, 또는 봇이 관리자로 있는 채널에서요. Telegram 안에서 Reverie 자체를 미니 앱으로 열 수도 있고, 거기서 Telegram Stars로 크레딧을 살 수 있습니다.

## 설치하기 \[#set-it-up]

### 계정 연동하기 \[#link-your-account]

캐릭터와 대화하는 사람은 모두 자신의 Telegram 계정에 연동된 Reverie 계정이 있어야 합니다 — 무료 계정이면 충분합니다. Telegram 계정 하나는 정확히 Reverie 계정 하나에 대응합니다.

* **웹사이트에서.** 앱에서 **Labs → Discord 및 Telegram 봇**으로 가서 Telegram 카드의 **텔레그램에서 연동**을 누릅니다. Telegram에서 봇과의 채팅이 열리면 **시작**을 누르세요. 지금 로그인한 계정에 연동됩니다. 페이지는 알아서 새로 고쳐집니다.
* **Telegram에서.** 봇을 열고 `/start`를 보냅니다. **Telegram으로 계속하기**는 미니 앱을 통해 무료 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`              | —        | 개인 채팅            | 기존 Reverie 계정에 Telegram을 연결하는 일회용 링크                                    |
| `/add`               | 검색어(선택)  | 그룹, 관리자          | 캐릭터를 검색해서 누른 것을 추가합니다. 개인 채팅에서는 `/chat`과 같습니다                           |
| `/remove`            | —        | 그룹, 관리자          | 그룹의 캐릭터를 버튼으로 보여 주고 누른 것을 뺍니다. 개인 채팅에서는 지금 대화를 끝냅니다                     |
| `/list`              | —        | 그룹               | 이 그룹의 캐릭터. 개인 채팅에서는 `/chats`와 같습니다                                      |
| `/info`              | 캐릭터 이름   | 둘 다              | 캐릭터 상세 정보. 개인 채팅에서 이름 없이 `/info`만 쓰면 지금 대화하는 캐릭터를 설명하고, 그룹에서는 이름이 필요합니다 |
| `/settings`          | 하위 키(선택) | 둘 다              | 설정 메뉴를 엽니다                                                              |
| `/plugins`           | —        | 둘 다              | 이 채팅에서 돌아가는 플러그인과, 공식 플러그인과 내 플러그인을 설치·제거·전환하는 버튼                       |
| `/group`             | —        | 그룹, 관리자 또는 결제 담당 | 대화 가능한 사람, 멤버별 일일 한도, 차단한 멤버, 사용량. 개인 채팅에서 열립니다                         |
| `/block`, `/unblock` | —        | 그룹, 관리자 또는 결제 담당 | 멤버의 메시지에 답장으로 보냅니다. 그 사람이 캐릭터와 대화하지 못하게 하거나 다시 허용합니다                    |
| `/reset`             | —        | 둘 다, 그룹에서는 관리자   | 이 채팅의 기록을 지웁니다                                                          |
| `/regenerate`        | —        | 둘 다              | 마지막 답장을 다시 뽑습니다                                                         |
| `/suggest`           | —        | 둘 다              | 답장 제안 세 개                                                               |
| `/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 하루당 크레딧 상한           | 예           |

개인 채팅의 메뉴에는 **Model (personal)**, **Reply language**, **Chat style**이 있습니다. 개인 채팅은 늘 답하고, 내 메시지는 내가 내기 때문입니다. 그룹에서는 메뉴와 오류 답장이 잠시 뒤 저절로 사라져 대화를 깔끔하게 유지합니다.

## 그룹과 채널 \[#groups-and-channels]

그룹에서 캐릭터는 **@멘션**되었거나 당신이 그 메시지에 **답장**했을 때 답합니다 — 자동 답장은 기본적으로 꺼져 있어서, 북적이는 그룹에 캐릭터를 넣어도 모두를 덮으며 떠들지 않습니다. 켜려면 `/settings mode`를 쓰세요. 봇이 들어올 때 자신을 멘션하거나 자신에게 답장한 메시지만 보인다고 했다면, 봇을 그룹 관리자로 지정하세요. 자동 답장은 모든 메시지를 볼 수 있어야 합니다.

토픽이 있는 그룹에서는 답장이 각자 답하는 토픽에 올라갑니다. 캐릭터 구성과 기록은 토픽과 상관없이 그룹 전체에 하나입니다.

봇은 관리자로 지정되면 Telegram **채널**에도 글을 올릴 수 있습니다.

## 그룹 규칙 \[#group-rules]

그룹에서 `/group`을 보내세요. 패널은 봇과의 개인 채팅에서 열리므로, 조정하는 모습을 그룹이 지켜보지 않습니다 — 봇과 개인 채팅을 한 번도 시작하지 않았다면 먼저 열어 달라고 합니다. 그룹 관리자, 그리고 그룹 캐릭터의 비용을 내는 사람이 쓸 수 있습니다. 오늘과 지난 7일의 사용량, 오늘 가장 많이 쓴 멤버, 그리고 규칙이 나옵니다.

| 규칙            | 선택지                                                                                |
| ------------- | ---------------------------------------------------------------------------------- |
| **대화 가능**     | **모두**(기본) 또는 **관리자만**                                                             |
| **멤버별 일일 한도** | 멤버 한 명이 UTC 하루에 쓸 수 있는 결제 담당의 크레딧, 또는 **제한 없음**(기본). 결제 담당이 낼 때만 적용됩니다             |
| **차단한 멤버**    | 그룹에서 멤버의 메시지에 `/block`으로 답장하면 그 사람은 캐릭터와 대화할 수 없습니다. 같은 방식으로 `/unblock`을 보내면 되돌립니다 |

관리자와 결제 담당 계정은 차단으로도 접근 방식으로도 막히지 않습니다. 접근 방식에서 빠진 멤버에게는 일부 멤버만 캐릭터와 대화할 수 있다고 한 번 알려 줍니다. 차단된 멤버에게는 아예 답장이 가지 않습니다.

## 캐릭터 공유하기 \[#sharing-a-character]

어느 Telegram 채팅에서든 — 봇이 없는 채팅이라도 — 봇의 @사용자명 뒤에 캐릭터 이름을 입력하고 목록에서 고르세요. 카드가 올라가고, 그 버튼을 누르면 봇에서 그 캐릭터와의 일대일 채팅이 열립니다. 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 계정. 다른 사람이 넘겨받기 전까지 | 그룹의 하루 크레딧 상한과, `/group`으로 정한 멤버별 일일 한도 |
| **User pays**      | 보낸 사람 각자의 잔액                                            | 없음 — 멤버마다 자기 잔액만큼만 씁니다                  |

메시지 비용은 웹 앱과 같습니다. 하루 카운터는 **00:00 UTC**에 초기화됩니다. 그룹의 청구를 내 계정으로 옮기려면 `/group`을 열고 **내 계정으로 결제**를 누르세요. 개인 채팅에서는 언제나 내 메시지를 내가 냅니다.

## Telegram에서 되는 것 \[#what-works-in-telegram]

* **이미지.** 캐릭터가 이미지를 만들 수 있습니다.
* **음성 출력.** 캐릭터가 음성 메시지를 보낼 수 있습니다.
* **음성 입력.** 음성 메모와 오디오 파일은 글로 옮겨집니다. **25 MB**까지.
* **기억.** 모델이 도구를 지원하면 캐릭터가 기억을 저장하고 갱신하며, 월드북의 설정도 맥락에 들어갑니다.
* **기록.** 길어진 대화는 자라는 대로 자동 요약됩니다.

## 알림과 체크인 \[#notifications-and-check-ins]

`/notify`로 두 가지를 정합니다. **캐릭터가 먼저 보내는 메시지**는 계정의 먼저 연락하는 정도로, 웹사이트와 같은 설정입니다. 구독이 있으면 개인 채팅에서 지금 대화하는 캐릭터가 먼저 메시지를 보낼 수 있습니다 — [먼저 오는 메시지](https://reverie.im/ko/docs/chatting/proactive-messages)를 보세요. **여기로도 받기**는 Reverie 알림 가운데 어떤 것을 개인 채팅으로도 받을지 고릅니다. 처음에는 **계정 및 결제**만 켜져 있습니다 — [알림](https://reverie.im/ko/docs/account/notifications)을 보세요. 연동 대시보드에서도 같은 것을 고를 수 있습니다.

`/daily`는 웹사이트와 같은 [일일 체크인](https://reverie.im/ko/docs/rewards/daily-check-in)을 받고, 행운 추첨을 미니 앱에서 엽니다.

## 한도 \[#limits]

| 한도                   | 값      |
| -------------------- | ------ |
| 대화당 캐릭터 수            | 5      |
| 메시지 길이               | 4,096자 |
| 음성 입력 크기             | 25 MB  |
| 대화당 대기 중인 메시지 수      | 3      |
| `/add`가 보여주는 검색 결과 수 | 8      |

같은 사람이 빠르게 잇달아 보낸 메시지는 한 턴으로 합쳐집니다.

## 연결 끊기 \[#unlinking]

연동 대시보드에서 **Unlink Account**로 끊습니다.

> Telegram에서 봇을 차단해도 계정 연결은 끊기지 않습니다. 봇을 그룹에서 빼면 그 그룹의 캐릭터만 멈춥니다. 앱의 **Unlink Account**를 쓰세요.

## 관련 문서 \[#related]

* [Discord 봇](https://reverie.im/ko/docs/integrations/discord-bot) — 같은 캐릭터를, 서버에서
* [Reverie Labs](https://reverie.im/ko/docs/integrations/labs) — 연동 대시보드가 있는 곳
* [크레딧](https://reverie.im/ko/docs/billing/credits) — 메시지 하나의 비용
* [구독](https://reverie.im/ko/docs/billing/subscriptions) — 요금제에 무엇이 들어 있는지