# Bot Telegram

> Ngobrol empat mata di chat pribadi, bawa karakter ke grup, bagikan secara inline, atau buka Mini App.

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

Bot Reverie membawa karakter ke Telegram — obrolan pribadi dengan botnya, sebuah grup, atau kanal yang ia kelola. Ia juga bisa membuka Reverie sendiri di dalam Telegram sebagai Mini App, tempat kamu bisa membeli kredit dengan Telegram Stars.

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

### Tautkan akunmu \[#link-your-account]

Siapa pun yang berbicara dengan karakter butuh akun Reverie yang tertaut ke akun Telegram-nya — akun gratis sudah cukup. Satu akun Telegram berpasangan dengan tepat satu akun Reverie.

* **Dari situs.** Di aplikasi, buka **Labs → Bot Discord & Telegram** lalu tekan **Tautkan di Telegram** di kartu Telegram. Telegram membuka chat dengan bot; ketuk **Mulai** dan kamu tertaut ke akun yang sedang kamu pakai untuk masuk. Halamannya diperbarui sendiri.
* **Dari Telegram.** Buka bot lalu kirim `/start`. **Lanjutkan dengan Telegram** membuat akun Reverie gratis lewat Mini App, tanpa perlu email. **Aku sudah punya akun** justru mengirim tautan sekali pakai, berlaku **10 menit**, yang menyambungkan Telegram-mu ke akun yang sudah ada; `/link` mengirim tautan yang sama kapan saja.

### Pilih karakter \[#pick-a-character]

Kirim `/chat` untuk melihat siapa saja yang bisa kamu ajak bicara — pertama karakter yang sudah kamu ajak bicara di sini, lalu saran — atau `/chat` diikuti nama untuk mencari. Ketuk salah satunya dan mulailah menulis.

### Bawa karakter ke grup \[#bring-characters-into-a-group]

Opsional. Tambahkan bot ke sebuah grup — **Tambahkan Bot ke Grup** di kartu Telegram melakukannya — lalu kirim `/add <name>` di sana. Bot mencari dan menampilkan hingga delapan hasil sebagai tombol; ketuk salah satunya untuk menambahkannya. Hanya admin grup yang bisa menambahkan karakter.

## Chat pribadimu \[#your-private-chat]

Chat pribadimu dengan bot adalah percakapanmu sendiri, ditagihkan ke akunmu sendiri. Setiap pesan dibalas — tanpa perlu menyebut siapa pun.

* **Satu karakter dalam satu waktu.** `/chat` berpindah ke karakter lain, dan `/chats` menampilkan karakter yang pernah kamu ajak bicara di sini. Masing-masing menyimpan percakapannya sendiri, jadi saat kembali kamu melanjutkan dari tempat terakhir.
* `/remove` mengakhiri percakapan saat ini — percakapannya tetap tersimpan untuk `/chats` — dan `/reset` menghapusnya setelah meminta konfirmasimu.
* **Karakter 18+** mengikuti pengaturan 18+ akunmu: saat dimatikan, mereka disembunyikan dan tidak bisa mengobrol di sini.
* Percakapan terbarumu juga muncul di dasbor integrasi di bawah **Chat pribadi**, dengan **Lanjutkan di web** untuk membukanya lagi di peramban dan **Chat di Telegram** untuk kembali ke sini.

## Perintah \[#commands]

Tombol menu di samping kotak ketik menampilkan perintah yang berlaku di tempatmu sekarang — chat pribadi dan grup masing-masing punya daftar sendiri, dalam bahasa Telegram-mu.

| Perintah             | Argumen                   | Di mana                     | Fungsinya                                                                                                                         |
| -------------------- | ------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `/start`             | —                         | pribadi                     | Mendaftarkan atau menautkanmu, lalu menawarkan karakter. Di grup, sama dengan `/help`                                             |
| `/help`              | —                         | keduanya                    | Menampilkan daftar perintah                                                                                                       |
| `/chat`              | nama (opsional)           | pribadi                     | Memilih atau mengganti karakter yang kamu ajak bicara                                                                             |
| `/chats`             | —                         | pribadi                     | Karakter yang pernah kamu ajak bicara, untuk berpindah di antaranya                                                               |
| `/link`              | —                         | pribadi                     | Tautan sekali pakai untuk menyambungkan Telegram-mu ke akun Reverie yang sudah ada                                                |
| `/add`               | teks pencarian (opsional) | grup, admin                 | Mencari karakter dan menambahkan yang kamu ketuk. Di chat pribadi, sama dengan `/chat`                                            |
| `/remove`            | —                         | grup, admin                 | Menampilkan karakter grup sebagai tombol; mengeluarkan yang kamu ketuk. Di chat pribadi, mengakhiri percakapan saat ini           |
| `/list`              | —                         | grup                        | Karakter di grup ini. Di chat pribadi, sama dengan `/chats`                                                                       |
| `/info`              | nama karakter             | keduanya                    | Detail karakter. Di chat pribadi, `/info` saja menjelaskan karakter yang sedang kamu ajak bicara; di grup, namanya wajib          |
| `/settings`          | subkunci (opsional)       | keduanya                    | Membuka menu pengaturan                                                                                                           |
| `/plugins`           | —                         | keduanya                    | Plugin yang berjalan di chat ini, dengan tombol untuk memasang, menghapus, atau menyalakan dan mematikan plugin resmi dan milikmu |
| `/group`             | —                         | grup, admin atau tuan rumah | Siapa yang bisa ngobrol, batas harian per anggota, anggota yang diblokir, dan pemakaian. Terbuka di chat pribadimu                |
| `/block`, `/unblock` | —                         | grup, admin atau tuan rumah | Dikirim sebagai balasan ke pesan seorang anggota: melarangnya berbicara dengan karakter, atau mengizinkannya lagi                 |
| `/reset`             | —                         | keduanya, admin di grup     | Menghapus riwayat chat ini                                                                                                        |
| `/regenerate`        | —                         | keduanya                    | Mengulang balasan terakhir                                                                                                        |
| `/suggest`           | —                         | keduanya                    | Tiga saran balasan                                                                                                                |
| `/account`           | —                         | keduanya                    | Kredit dan status langganan                                                                                                       |
| `/daily`             | —                         | pribadi                     | Mengambil check-in harianmu                                                                                                       |
| `/notify`            | —                         | pribadi                     | Apakah karakter boleh mengirimimu pesan lebih dulu, dan notifikasi mana yang sampai ke sini                                       |
| `/buy`               | —                         | pribadi                     | Membeli langganan atau paket kredit dengan Telegram Stars                                                                         |
| `/app`               | —                         | keduanya                    | Membuka Mini App Reverie                                                                                                          |
| `/paysupport`        | —                         | keduanya                    | Dukungan pembayaran. Terdaftar tetapi tidak ada di menu                                                                           |

`/plugins` mencantumkan plugin prompt dan alat yang berjalan di obrolan ini dan, bagi admin atau siapa pun yang menambahkan karakter, menyediakan tombol untuk memasang plugin resmi dan milik Anda, menghapusnya, atau mengaktifkan dan menonaktifkannya. Plugin yang butuh pengaturan diisi tidak bisa dipasang dari bot. Hasil plugin alat diposting di obrolan sebagai kartu singkat.

### Pengaturan \[#settings]

`/settings` membuka menu sebaris, atau langsung lompat ke sebuah halaman dengan `/settings model`, `language`, `mode`, `style`, `payment`, atau `limit`.

| Entri menu             | Cakupan                                           | Khusus admin di grup |
| ---------------------- | ------------------------------------------------- | -------------------- |
| **Model (personal)**   | Modelmu sendiri untuk karakter utama obrolan ini  | tidak                |
| **Language (chat)**    | Bahasa balasan untuk obrolan                      | ya                   |
| **Chat mode**          | Membalas semuanya, atau hanya saat disapa         | ya                   |
| **Chat style**         | Prosa bermain peran, atau dialog saja             | ya                   |
| **Payment mode**       | Pemilik yang membayar atau pengirim yang membayar | ya                   |
| **Daily credit limit** | Batas kredit per hari UTC                         | ya                   |

Di chat pribadi, menunya berisi **Model (personal)**, **Reply language**, dan **Chat style**: chat pribadi selalu membalas, dan kamu membayar pesanmu sendiri. Di grup, menu dan balasan galat terhapus sendiri setelah beberapa saat agar chat tetap rapi.

## Grup dan kanal \[#groups-and-channels]

Di grup, karakter menjawab saat **di-\@sebut** atau saat kamu **membalas** salah satu pesan mereka — balas otomatis mati secara bawaan, jadi menambahkan karakter ke grup yang ramai tidak membuatnya bicara menimpa semua orang. `/settings mode` menyalakannya. Jika saat bergabung bot bilang ia hanya melihat pesan yang menyebutnya atau membalasnya, jadikan ia admin grup: balas otomatis perlu melihat setiap pesan.

Di grup yang memakai topik, setiap balasan masuk ke topik yang dijawabnya. Grup memakai satu daftar karakter dan satu riwayat untuk semua topiknya.

Bot juga bisa memposting di sebuah **kanal** Telegram bila di sana ia dijadikan admin.

## Aturan grup \[#group-rules]

Kirim `/group` di grup. Panelnya terbuka di chat pribadimu dengan bot, jadi grup tidak melihatmu mengaturnya — kalau kamu belum pernah memulai chat pribadi dengan bot, bot memintamu membukanya dulu. Admin grup bisa memakainya, begitu pula orang yang membayar karakter grup itu. Panel menampilkan pemakaian hari ini dan tujuh hari terakhir, anggota yang paling banyak memakai hari ini, dan aturannya:

| Aturan                       | Pilihan                                                                                                                                                          |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Siapa yang bisa ngobrol**  | **Semua orang** (bawaan) atau **Hanya admin**                                                                                                                    |
| **Batas harian per anggota** | Berapa banyak kredit tuan rumah yang boleh dihabiskan satu anggota per hari UTC, atau **Tanpa batas** (bawaan). Hanya berlaku di tempat tuan rumah yang membayar |
| **Anggota yang diblokir**    | Balas pesan seorang anggota di grup dengan `/block` agar ia tidak bisa lagi berbicara dengan karakter; `/unblock`, dikirim dengan cara yang sama, membatalkannya |

Admin dan akun yang membayar tidak pernah terkunci di luar, baik oleh pemblokiran maupun mode akses. Anggota yang tersisih oleh mode akses diberi tahu sekali bahwa hanya sebagian anggota yang bisa berbicara dengan karakter; anggota yang diblokir sama sekali tidak mendapat balasan.

## Membagikan karakter \[#sharing-a-character]

Di chat Telegram mana pun — bahkan yang tidak ada botnya — ketik @nama pengguna bot diikuti nama karakter, lalu pilih salah satunya dari daftar. Sebuah kartu akan diposting, dan tombolnya membuka obrolan empat mata dengan karakter itu di bot. Hanya karakter publik yang bukan 18+ yang ditawarkan.

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

`/app` membuka Reverie di dalam peramban Telegram, sudah masuk lewat akun Telegram-mu — aplikasi penuh, lengkap dengan daftar karaktermu, obrolanmu, dan kreditmu.

Kalau bot membalas bahwa aplikasinya tidak tersedia, Mini App-nya tidak dinyalakan — buka Reverie di peramban saja.

## Membayar dengan Telegram Stars \[#paying-with-telegram-stars]

`/buy` menjalankan seluruh pembelian di dalam Telegram. Kalau belum berlangganan, kamu memilih antara paket langganan dan paket kredit; kalau sudah, kamu langsung ke paket kredit dengan bonus pelangganmu sudah diperhitungkan. Memilih salah satunya memunculkan tagihan Stars asli dengan tombol **Pay**.

`/buy` dibatasi pada obrolan pribadi — tagihan di grup akan menagih siapa pun yang mengetuknya.

## Siapa yang membayar \[#who-pays]

| Mode pembayaran         | Ditagihkan ke                                                                                                           | Batas yang berlaku                                                               |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| **Owner pays** (bawaan) | Tuan rumah grup: akun Reverie yang pertama kali menaruh karakter di grup itu, sampai ada orang lain yang mengambil alih | Batas kredit harian grup dan batas harian per anggota yang diatur lewat `/group` |
| **User pays**           | Saldo masing-masing pengirim                                                                                            | Tidak ada — tiap anggota dibatasi saldonya sendiri                               |

Biaya pesan sama seperti di aplikasi web. Penghitung harian disetel ulang pada **00:00 UTC**. Untuk memindahkan tagihan sebuah grup ke akunmu sendiri, buka `/group` lalu tekan **Bayar dengan akunku**. Di chat pribadimu, kamu selalu membayar pesanmu sendiri.

## Apa yang bisa dipakai di Telegram \[#what-works-in-telegram]

* **Gambar.** Karakter bisa membuat gambar.
* **Suara keluar.** Karakter bisa mengirim pesan suara.
* **Suara masuk.** Pesan suara dan berkas audio ditranskripsikan, sampai **25 MB**.
* **Memori.** Karakter menyimpan dan memperbarui memori bila modelnya mendukung perkakas, dan kanon buku dunia ikut masuk ke konteksnya.
* **Riwayat.** Obrolan panjang diringkas otomatis seiring bertambahnya isi.

## Notifikasi dan check-in \[#notifications-and-check-ins]

`/notify` mengatur dua hal. **Karakter mengirim pesan lebih dulu** adalah tingkat proaktivitas akunmu, pengaturan yang sama dengan di situs: dengan langganan, karakter yang sedang kamu ajak bicara di chat pribadi bisa mengirimimu pesan lebih dulu — lihat [Pesan atas inisiatif sendiri](https://reverie.im/id/docs/chatting/proactive-messages). **Kirim juga ke sini** memilih notifikasi Reverie mana yang juga dikirim ke chat pribadimu; awalnya hanya **Akun & penagihan** yang menyala — lihat [Notifikasi](https://reverie.im/id/docs/account/notifications). Dasbor integrasi menawarkan pilihan yang sama.

`/daily` mengambil [check-in harianmu](https://reverie.im/id/docs/rewards/daily-check-in), yang sama dengan di situs, dan membuka undian keberuntungan di Mini App.

## Batas \[#limits]

| Batas                                   | Nilai          |
| --------------------------------------- | -------------- |
| Karakter per obrolan                    | 5              |
| Panjang pesan                           | 4.096 karakter |
| Ukuran masukan suara                    | 25 MB          |
| Pesan yang mengantre per obrolan        | 3              |
| Hasil pencarian yang ditampilkan `/add` | 8              |

Pesan beruntun cepat dari orang yang sama digabung menjadi satu giliran.

## Memutus hubungan \[#unlinking]

Putuskan dari dasbor integrasi lewat **Unlink Account**.

> Memblokir bot di Telegram tidak memutus hubungan akunmu. Mengeluarkan bot dari sebuah grup hanya menonaktifkan karakter di grup itu. Pakai **Unlink Account** di aplikasi.

## Terkait \[#related]

* [Bot Discord](https://reverie.im/id/docs/integrations/discord-bot) — karakter yang sama, di sebuah server
* [Reverie Labs](https://reverie.im/id/docs/integrations/labs) — tempat dasbor integrasi berada
* [Kredit](https://reverie.im/id/docs/billing/credits) — berapa biaya satu pesan
* [Langganan](https://reverie.im/id/docs/billing/subscriptions) — apa saja isi sebuah paket