# Telegram bot

> Mag-chat nang one-on-one sa private chat, magdala ng mga karakter sa mga group, i-share sila inline, o buksan ang Mini App.

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

Dinadala ng Reverie bot ang mga karakter sa Telegram — sa private chat sa bot, sa isang group, o sa isang channel na pinapangasiwaan nito. Kaya rin nitong buksan ang Reverie mismo sa loob ng Telegram bilang Mini App, kung saan puwede kang bumili ng credits gamit ang Telegram Stars.

## I-set up ito \[#set-it-up]

### I-link ang iyong account \[#link-your-account]

Kailangan ng lahat ng kumakausap sa isang karakter ng Reverie account na naka-link sa kanilang Telegram account — sapat na ang libreng account. Isang Telegram account ay katumbas ng eksaktong isang Reverie account.

* **Mula sa website.** Sa app, pumunta sa **Labs → Mga Discord at Telegram Bot** at pindutin ang **I-link sa Telegram** sa Telegram card. Magbubukas ang Telegram ng chat sa bot; i-tap ang **Start** at mali-link ka sa account na naka-sign in ka. Kusang mag-a-update ang pahina.
* **Mula sa Telegram.** Buksan ang bot at ipadala ang `/start`. Gumagawa ang **Magpatuloy gamit ang Telegram** ng libreng Reverie account sa pamamagitan ng Mini App, nang hindi kailangan ng email. Ang **May account na ako** naman ay nagpapadala ng link na isang beses lang magagamit, valid sa loob ng **10 minuto**, na nagdudugtong sa iyong Telegram sa isang umiiral na account; ipinapadala ng `/link` ang parehong link anumang oras.

### Pumili ng karakter \[#pick-a-character]

Ipadala ang `/chat` para makita kung sino ang puwede mong kausapin — una ang mga karakter na kausap mo na rito, saka ang mga mungkahi — o `/chat` na sinusundan ng pangalan para maghanap. I-tap ang isa at magsimulang sumulat.

### Magdala ng mga karakter sa isang group \[#bring-characters-into-a-group]

Opsyonal. Idagdag ang bot sa isang group — iyan ang ginagawa ng **Idagdag ang Bot sa isang Group** sa Telegram card — at ipadala roon ang `/add <name>`. Maghahanap ang bot at magpapakita ng hanggang walong tugma bilang mga button; i-tap ang isa para idagdag ito. Mga admin lang ng group ang puwedeng magdagdag ng mga karakter.

## Ang iyong private chat \[#your-private-chat]

Sarili mong usapan ang private chat mo sa bot, na sinisingil sa sarili mong account. Sinasagot ang bawat mensahe — hindi kailangan ng mention.

* **Isang karakter sa bawat pagkakataon.** Lumilipat sa iba ang `/chat`, at inililista ng `/chats` ang mga karakter na nakausap mo rito. May sariling usapan ang bawat isa, kaya kapag bumalik ka, itutuloy mo kung saan ka tumigil.
* Tinatapos ng `/remove` ang kasalukuyang usapan — nananatili itong naka-save para sa `/chats` — at binubura ito ng `/reset` matapos kang hingan ng kumpirmasyon.
* **Mga karakter na 18+** ay sumusunod sa 18+ na setting ng iyong account: kapag naka-off ito, nakatago sila at hindi makaka-chat dito.
* Lumalabas din ang mga kamakailan mong usapan sa integrations dashboard sa ilalim ng **Pribadong chat**, na may **Ituloy sa web** para ituloy ang isa sa browser at **Mag-chat sa Telegram** para bumalik.

## Mga command \[#commands]

Inililista ng menu button sa tabi ng input box ang mga command na gumagana kung nasaan ka — may kanya-kanyang listahan ang private chat at ang group, sa wika ng iyong Telegram.

| Command              | Argumento                | Saan                        | Ano ang ginagawa nito                                                                                                                          |
| -------------------- | ------------------------ | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `/start`             | —                        | private                     | Ini-sign up o nili-link ka, saka nag-aalok ng mga karakter. Sa group, kapareho ng `/help`                                                      |
| `/help`              | —                        | pareho                      | Inililista ang mga command                                                                                                                     |
| `/chat`              | pangalan (opsyonal)      | private                     | Pumipili o nagpapalit ng karakter na kausap mo                                                                                                 |
| `/chats`             | —                        | private                     | Ang mga karakter na nakausap mo, para makalipat-lipat                                                                                          |
| `/link`              | —                        | private                     | Isang link na isang beses lang magagamit para idugtong ang iyong Telegram sa isang umiiral na Reverie account                                  |
| `/add`               | search text (opsyonal)   | group, mga admin            | Naghahanap ng mga karakter at idinadagdag ang ita-tap mo. Sa private chat, kapareho ng `/chat`                                                 |
| `/remove`            | —                        | group, mga admin            | Inililista ang mga karakter ng group bilang mga button; inaalis ang ita-tap mo. Sa private chat, tinatapos ang kasalukuyang usapan             |
| `/list`              | —                        | group                       | Mga karakter sa group na ito. Sa private chat, kapareho ng `/chats`                                                                            |
| `/info`              | pangalan ng karakter     | pareho                      | Mga detalye ng karakter. Sa private chat, inilalarawan ng `/info` na walang kasama ang karakter na kausap mo; sa group, kailangan ang pangalan |
| `/settings`          | isang sub-key (opsyonal) | pareho                      | Binubuksan ang menu ng mga setting                                                                                                             |
| `/plugins`           | —                        | pareho                      | Mga plugin na tumatakbo sa chat na ito, na may mga button para mag-install, mag-alis o magpalit ng mga opisyal na plugin at ng sarili mo       |
| `/group`             | —                        | group, mga admin o ang host | Kung sino ang puwedeng makipag-usap, daily limit bawat miyembro, mga naka-block na miyembro at paggamit. Bumubukas sa iyong private chat       |
| `/block`, `/unblock` | —                        | group, mga admin o ang host | Ipinapadala bilang reply sa mensahe ng isang miyembro: pinipigilan silang kumausap sa mga karakter, o pinapayagan ulit                         |
| `/reset`             | —                        | pareho, mga admin sa group  | Binubura ang history ng chat na ito                                                                                                            |
| `/regenerate`        | —                        | pareho                      | Inuulit ang huling sagot                                                                                                                       |
| `/suggest`           | —                        | pareho                      | Tatlong mungkahing sagot                                                                                                                       |
| `/account`           | —                        | pareho                      | Credits at status ng subscription                                                                                                              |
| `/daily`             | —                        | private                     | Kinukuha ang iyong daily check-in                                                                                                              |
| `/notify`            | —                        | private                     | Kung puwedeng maunang mag-message sa iyo ang mga karakter, at kung aling mga notification ang dumarating sa iyo rito                           |
| `/buy`               | —                        | private                     | Bumili ng subscription o credit pack gamit ang Telegram Stars                                                                                  |
| `/app`               | —                        | pareho                      | Binubuksan ang Reverie Mini App                                                                                                                |
| `/paysupport`        | —                        | pareho                      | Support sa pagbabayad. Naka-register pero hindi nakalista sa menu                                                                              |

Inililista ng `/plugins` ang mga prompt at tool plugin na tumatakbo sa chat na ito at, para sa mga admin o sa sinumang nagdagdag ng karakter, nag-aalok ng mga button para mag-install ng mga opisyal na plugin at ng sarili mo, alisin ang mga ito, o i-on at i-off ang mga ito. Hindi mai-install mula sa bot ang plugin na kailangang punan ang mga setting. Ipino-post sa chat ang resulta ng tool plugin bilang maikling card.

### Mga setting \[#settings]

Nagbubukas ang `/settings` ng inline na menu, o direktang tumalon sa isang pahina gamit ang `/settings model`, `language`, `mode`, `style`, `payment` o `limit`.

| Entry sa menu          | Saklaw                                                        | Admin lang sa mga group |
| ---------------------- | ------------------------------------------------------------- | ----------------------- |
| **Model (personal)**   | Sarili mong model para sa pangunahing karakter ng chat na ito | hindi                   |
| **Language (chat)**    | Wika ng sagot para sa chat                                    | oo                      |
| **Chat mode**          | Sagutin ang lahat, o kapag kinakausap lang                    | oo                      |
| **Chat style**         | Prosa ng roleplay, o diyalogo lang                            | oo                      |
| **Payment mode**       | Magbabayad ang owner o magbabayad ang user                    | oo                      |
| **Daily credit limit** | Pinakamataas na credits bawat araw sa UTC                     | oo                      |

Sa private chat, iniaalok ng menu ang \*\*Model (personal)\*\*, **Reply language** at **Chat style**: laging sumasagot ang private chat, at ikaw ang nagbabayad para sa sarili mong mga mensahe. Sa group, kusang nade-delete ang mga menu at mga error reply pagkalipas ng maikling sandali para manatiling malinis ang chat.

## Mga group at channel \[#groups-and-channels]

Sa group, sumasagot ang mga karakter kapag **na-\@mention** sila o kapag **nag-reply** ka sa isa sa mga mensahe nila — naka-off bilang default ang auto-reply, kaya hindi sasapawan ng karakter ang lahat kapag idinagdag mo ito sa isang abalang group. Ino-on ito ng `/settings mode`. Kung sinabi ng bot pagsali nito na ang nakikita lang nito ay ang mga mensaheng bumabanggit dito o sumasagot dito, gawin itong admin ng group: kailangang makita ng auto-reply ang bawat mensahe.

Sa group na may mga topic, napupunta ang bawat sagot sa topic na sinasagot nito. Iisang set ng mga karakter at iisang history ang pinapanatili ng group sa lahat ng topic nito.

Puwede ring mag-post ang bot sa isang Telegram **channel** kapag ginawa na itong admin doon.

## Mga patakaran ng group \[#group-rules]

Ipadala ang `/group` sa group. Bumubukas ang panel sa private chat mo sa bot, para hindi ka pinapanood ng group habang inaayos mo ito — kung hindi ka pa nagsisimula ng private chat sa bot, hihilingin nitong magbukas ka muna ng isa. Magagamit ito ng mga admin ng group, at pati ng sinumang nagbabayad para sa mga karakter nito. Ipinapakita nito ang paggamit ngayong araw at sa nakaraang pitong araw, ang mga miyembrong pinakamaraming nagamit ngayong araw, at ang mga patakaran:

| Patakaran                          | Mga pagpipilian                                                                                                                                                                  |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sino ang puwedeng makipag-usap** | **Lahat** (ang default) o **Mga admin lang**                                                                                                                                     |
| **Daily limit bawat miyembro**     | Kung gaano karami sa credits ng host ang puwedeng gastusin ng isang miyembro bawat araw sa UTC, o **Walang limit** (ang default). Umiiral lang kung saan ang host ang nagbabayad |
| **Mga naka-block na miyembro**     | I-reply ang `/block` sa mensahe ng isang miyembro sa group para pigilan silang kumausap sa mga karakter; binabawi ito ng `/unblock`, na ipinapadala sa parehong paraan           |

Hindi kailanman naisasara ang access ng mga admin at ng nagbabayad na account, ng block man o ng access mode. Sinasabihan nang isang beses ang miyembrong hindi saklaw ng access mode na ilang miyembro lang ang puwedeng kumausap sa mga karakter; walang anumang sagot na natatanggap ang naka-block na miyembro.

## Pag-share ng karakter \[#sharing-a-character]

Sa kahit anong Telegram chat — kahit wala roon ang bot — i-type ang @username ng bot na sinusundan ng pangalan ng karakter, at pumili ng isa mula sa listahan. Magpo-post ito ng card na may button na nagbubukas ng one-on-one na chat sa karakter na iyon sa bot. Mga pampublikong karakter lang na hindi 18+ ang iniaalok.

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

Binubuksan ng `/app` ang Reverie sa loob ng browser ng Telegram, naka-sign in gamit ang iyong Telegram account — ang buong app, kasama ang iyong mga karakter, mga chat at credits.

Kung sumagot ang bot na hindi available ang app, hindi naka-on ang Mini App — buksan na lang ang Reverie sa iyong browser.

## Pagbabayad gamit ang Telegram Stars \[#paying-with-telegram-stars]

Pinapatakbo ng `/buy` ang buong pagbili sa loob ng Telegram. Kung wala kang subscription, pipili ka sa pagitan ng isang plan at isang credit pack; kung may subscription ka na, diretso ka sa mga credit pack na may kasamang subscriber bonus mo. Kapag pumili ka ng isa, magpo-post ito ng native na Stars invoice na may button na **Pay**.

Limitado sa mga private chat ang `/buy` — sisingilin ng invoice sa isang group ang sinumang mag-tap dito.

## Sino ang nagbabayad \[#who-pays]

| Payment mode                       | Sinisingil sa                                                                                              | Mga limitasyong umiiral                                                                                  |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Magbabayad ang owner** (default) | Ang host ng group: ang Reverie account na unang nagdagdag ng karakter sa group, hanggang may ibang pumalit | Ang daily na limit ng credits ng group, at ang daily limit bawat miyembro na itinakda gamit ang `/group` |
| **Magbabayad ang user**            | Sariling balance ng bawat nagpapadala                                                                      | Wala — limitado ang bawat miyembro ng sarili nilang balance                                              |

Pareho ang halaga ng mga mensahe sa web app. Nire-reset ang mga pang-araw-araw na counter sa **00:00 UTC**. Para mailipat sa sarili mong account ang singil ng isang group, buksan ang `/group` at pindutin ang **Magbayad gamit ang aking account**. Sa iyong private chat, lagi kang nagbabayad para sa sarili mong mga mensahe.

## Ano ang gumagana sa Telegram \[#what-works-in-telegram]

* **Mga larawan.** Puwedeng gumawa ng mga larawan ang mga karakter.
* **Boses palabas.** Puwedeng magpadala ng mga voice message ang mga karakter.
* **Boses papasok.** Tina-transcribe ang mga voice note at audio file, hanggang **25 MB**.
* **Memorya.** Nagse-save at nag-a-update ng mga memorya ang mga karakter kapag sumusuporta sa mga tool ang model, at kasama sa kanilang konteksto ang canon mula sa World Book.
* **History.** Awtomatikong binubuod ang mahahabang chat habang lumalaki ang mga ito.

## Mga notification at check-in \[#notifications-and-check-ins]

Dalawang bagay ang itinatakda ng `/notify`. Ang **Mga karakter na unang nagme-message sa iyo** ay ang antas ng pagkukusa ng iyong account, ang parehong setting na nasa website: kapag may subscription, puwedeng maunang sumulat sa iyo ang karakter na kausap mo sa iyong private chat — tingnan ang [Mga proactive na mensahe](https://reverie.im/fil/docs/chatting/proactive-messages). Pinipili ng **Ipadala rin sa akin dito** kung alin sa iyong mga notification sa Reverie ang ipapadala rin sa iyong private chat; **Account at billing** lang ang naka-on sa simula — tingnan ang [Mga notification](https://reverie.im/fil/docs/account/notifications). Iniaalok din ng integrations dashboard ang parehong mga pagpipilian.

Kinukuha ng `/daily` ang iyong [daily check-in](https://reverie.im/fil/docs/rewards/daily-check-in), ang parehong nasa website, at binubuksan nito ang lucky draw sa Mini App.

## Mga limitasyon \[#limits]

| Limitasyon                                         | Halaga          |
| -------------------------------------------------- | --------------- |
| Mga karakter bawat chat                            | 5               |
| Haba ng mensahe                                    | 4,096 character |
| Laki ng voice input                                | 25 MB           |
| Mga nakapilang mensahe bawat chat                  | 3               |
| Mga resulta ng paghahanap na ipinapakita ng `/add` | 8               |

Pinagsasama sa iisang turn ang sunod-sunod at mabilisang mga mensahe mula sa iisang tao.

## Pag-unlink \[#unlinking]

Mag-unlink mula sa integrations dashboard gamit ang **I-unlink ang Account**.

> Hindi naa-unlink ang account mo kapag bina-block mo ang bot sa Telegram. Kapag
> inalis mo ang bot sa isang group, ang mga karakter lang ng group na iyon ang
> nade-deactivate. Gamitin ang **I-unlink ang Account** sa app.

## Kaugnay \[#related]

* [Discord bot](https://reverie.im/fil/docs/integrations/discord-bot) — ang parehong mga karakter, sa isang server
* [Reverie Labs](https://reverie.im/fil/docs/integrations/labs) — kung nasaan ang integrations dashboard
* [Credits](https://reverie.im/fil/docs/billing/credits) — magkano ang isang mensahe
* [Mga subscription](https://reverie.im/fil/docs/billing/subscriptions) — ano ang kasama sa isang plan