# บอท Telegram

> คุยตัวต่อตัวในแชทส่วนตัว พาตัวละครเข้ากลุ่ม แชร์แบบอินไลน์ หรือเปิดมินิแอป

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

บอทของ Reverie พาตัวละครเข้ามาใน Telegram — ทั้งในแชทส่วนตัวกับบอท ในกลุ่ม หรือในช่องที่บอทเป็นผู้ดูแล และยังเปิด Reverie เองขึ้นมาในรูปแบบ Mini App ภายใน Telegram ได้ด้วย ซึ่งคุณสามารถซื้อเครดิตด้วย Telegram Stars ได้ที่นั่น

## ตั้งค่า \[#set-it-up]

### เชื่อมโยงบัญชีของคุณ \[#link-your-account]

ทุกคนที่คุยกับตัวละครต้องมีบัญชี Reverie ที่เชื่อมโยงกับบัญชี Telegram ของตัวเอง (บัญชีฟรีก็พอ) บัญชี Telegram หนึ่งบัญชีคู่กับบัญชี Reverie ได้เพียงบัญชีเดียว

* **จากเว็บไซต์** ในแอป ไปที่ **Labs → บอท Discord และ Telegram** แล้วกด **เชื่อมโยงใน 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`              | —                    | ส่วนตัว                           | ลิงก์ใช้ครั้งเดียวสำหรับเชื่อม 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                                                                              |
| `/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` จะเปิด Reverie ขึ้นมาในเบราว์เซอร์ของ Telegram โดยลงชื่อเข้าใช้จากบัญชี Telegram ของคุณ — เป็นแอปเต็มรูปแบบ พร้อมรายชื่อตัวละคร แชท และเครดิตของคุณ

ถ้าบอทตอบว่าแอปใช้ไม่ได้ แปลว่า Mini App ยังไม่ได้เปิดใช้งาน — ให้เปิด Reverie ในเบราว์เซอร์แทน

## จ่ายด้วย Telegram Stars \[#paying-with-telegram-stars]

`/buy` ทำให้การซื้อทั้งหมดจบในตัว 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/th/docs/chatting/proactive-messages) ส่วน **ส่งมาที่นี่ด้วย** เลือกว่าการแจ้งเตือน Reverie อันไหนจะส่งมาที่แชทส่วนตัวของคุณด้วย ตอนเริ่มต้นเปิดไว้แค่ **บัญชีและการเรียกเก็บเงิน** — ดู [การแจ้งเตือน](https://reverie.im/th/docs/account/notifications) แดชบอร์ดการเชื่อมต่อก็มีตัวเลือกเดียวกัน

`/daily` รับ[รางวัลเช็คอินรายวัน](https://reverie.im/th/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/th/docs/integrations/discord-bot) — ตัวละครชุดเดียวกัน แต่อยู่ในเซิร์ฟเวอร์
* [Reverie Labs](https://reverie.im/th/docs/integrations/labs) — แดชบอร์ดการเชื่อมต่ออยู่ตรงไหน
* [เครดิต](https://reverie.im/th/docs/billing/credits) — ข้อความหนึ่งข้อความราคาเท่าไร
* [การสมัครสมาชิก](https://reverie.im/th/docs/billing/subscriptions) — แพ็กเกจหนึ่งรวมอะไรบ้าง
