เริ่มต้นอย่างรวดเร็ว: จากศูนย์จนใช้งานได้ ไม่ข้ามขั้นตอนใดเลย

เส้นทางเริ่มต้นคือโฮสต์บนคลาวด์: แค่มีมือถือและเวลา ~10 นาที — ไม่ต้องมีเซิร์ฟเวอร์ ไม่ต้องเขียนโค้ด ทุกขั้นตอนบอกคุณว่าต้องเปิดหน้าจอไหนและแตะตรงไหน พร้อมทั้งจุดพลาดที่คนเจอกันจริง ๆ

สารบัญ รายการตรวจสอบ ขั้นที่ 1 · สร้างบอตของคุณใน BotFather (สวิตช์สำคัญสองตัว) ขั้นที่ 2 · เชื่อมต่อบอตใน Telegram Business ขั้นที่ 3 · สร้างกลุ่มฟอรัมคอนโซลของคุณ ขั้นที่ 4 · เลือกหนึ่ง: ☁️ โฮสต์บนคลาวด์ (แนะนำ) / 💻 โฮสต์เอง ขั้นที่ 5 · ทดสอบแชท การแก้ปัญหา

🧾 รายการตรวจสอบ

1สร้างบอตของคุณใน BotFather

ใน Telegram ค้นหา @BotFather (มองหาตราสัญลักษณ์ยืนยันสีน้ำเงิน) แล้วสนทนาดังนี้:

🤖 BotFather
/newbot
BotFatherAlright, a new bot. How are we going to call it? Please choose a name for your bot.
LingoDesk Assistant
BotFatherGood. Now let's choose a username for your bot. It must end in bot.
my_lingodesk_bot
BotFatherDone! Use this token to access the HTTP API:
8123456789:AAHfK3xxxxxxxxxxxxxxxxxxxxxxxxx
Keep your token secure and store it safely…

1a. เปิด Secretary Mode (จำเป็น; เดิมเรียกว่า "Business Mode")

⚠️ เมื่อพฤษภาคม 2026 Telegram ได้เปลี่ยนชื่อสวิตช์นี้เป็น Secretary Mode ไคลเอนต์รุ่นเก่าอาจยังเรียกว่า Business Mode — สิ่งเดียวกัน ทำสิ่งนี้ภายในแชท @BotFather (ไม่ใช่หน้าโปรไฟล์ของบอตคุณ และไม่ใช่การตั้งค่า Telegram ในมือถือ) มีสองอินเทอร์เฟซ — ใช้ได้ทั้งคู่:

อินเทอร์เฟซ ① คำสั่งแบบคลาสสิก — แค่ส่งข้อความ:

/mybots→ @my_lingodesk_bot→ Bot Settings→ Secretary Mode→ Turn on

อินเทอร์เฟซ ② แผงจัดการแบบใหม่ — แตะปุ่ม Open สีน้ำเงินข้างช่องข้อความของ BotFather:

Open (แผงจัดการ)→ เลือกบอตของคุณ→ Settings→ Mode Settings→ เปิดสวิตช์ Secretary Mode
หาไม่เจอ? ① มันมีสองชื่อ: Secretary Mode ในไคลเอนต์ใหม่ และ Business Mode ในไคลเอนต์เก่า — มองหาได้ทั้งสองชื่อ; ② ให้แน่ใจว่าคุณอยู่ใน @BotFather ไม่ใช่การตั้งค่าของบอตคุณเอง; ③ สวิตช์นี้ไม่เกี่ยวข้องกับ Telegram Premium เลย — Premium มีผลแค่ตอนเชื่อมต่อฝั่งบัญชีของคุณในขั้นที่ 2; ใครก็เปิดสวิตช์นี้ได้
หากไม่มี Secretary Mode Telegram จะแสดงป๊อปอัป — "บอตนี้ยังไม่รองรับ Telegram Business" — เมื่อคุณพยายามเพิ่มบอตในขั้นที่ 2 นี่คือตัวขวางที่พบบ่อยที่สุด เปิดสวิตช์เลย: มีผลทันที ไม่ต้องสร้างบอตใหม่ แค่ลองเพิ่มอีกครั้ง

1b. ปิด Group Privacy (จำเป็น)

/mybots→ @my_lingodesk_bot→ Bot Settings→ Group Privacy→ Turn off
Privacy เปิดอยู่โดยค่าเริ่มต้น และตราบใดที่มันเปิดอยู่ บอตจะมองไม่เห็นคำตอบที่คุณพิมพ์ในกลุ่มคอนโซล — อาการคือ "ฉันพิมพ์ในหัวข้อแล้วไม่มีอะไรเกิดขึ้น" ปิดมันเสีย (BotFather ต้องบอกว่า Privacy mode is disabled)

2เชื่อมต่อบอตใน Telegram Business

บนแอป Telegram มือถือ (การตั้งค่านี้ปัจจุบันมีเฉพาะบนมือถือ):

⚙️ การตั้งค่า→ 💼 Telegram Business→ 🤖 Chatbots

ในไคลเอนต์รุ่นใหม่ รายการนี้เรียกว่า "Chat Automation" — ป้ายต่างกัน แต่ทางเข้าเดียวกัน

  1. พิมพ์ username ของบอตคุณ (เช่น my_lingodesk_bot) ในช่องค้นหาแล้วเลือกมัน
  2. สิทธิ์: เปิด "Reply to messages" — หากไม่เปิด บอตจะอ่านได้แต่จะส่งแทนคุณไม่ได้เลย
  3. สำหรับ "แชทไหนบ้าง" ให้เลือก All 1:1 Chats; เพิ่มผู้ติดต่อส่วนตัวที่คุณอยากกันออกจากการรีเลย์ไว้ในรายการ Excluded Chats
เมื่อเชื่อมต่อแล้ว ทุกข้อความส่วนตัวที่คุณได้รับจะถูก "cc" ให้บอตอย่างเงียบ ๆ — อีกฝ่ายไม่สังเกตเห็นอะไร และประสบการณ์การแชทของคุณเองก็ไม่เปลี่ยนแปลงเลย

3สร้างกลุ่มฟอรัมคอนโซลของคุณ

กลุ่มนี้คือโต๊ะทำงานของคุณ: หนึ่งหัวข้อต่อหนึ่งผู้ติดต่อ พร้อมการ์ดข้อความสองภาษาที่โผล่ขึ้นมาข้างใน

  1. สร้างกลุ่ม: New → New Group เพิ่มบอตของคุณเป็นสมาชิกเพียงคนเดียว (ค้นหา username ของมัน) ตั้งชื่ออะไรก็ได้ เช่น "LingoDesk Console"
  2. เปิด Topics: เปิดกลุ่ม → แตะที่ชื่อเพื่อดูโปรไฟล์ → Edit → เปิดสวิตช์ Topics กลุ่มจะอัปเกรดเป็นซูเปอร์กรุ๊ปและได้รายการหัวข้อ
  3. เลื่อนบอตขึ้นเป็นแอดมิน: โปรไฟล์ → Administrators → Add Admin → บอตของคุณ → ติ๊ก "Manage Topics" (ที่เหลือปล่อยเป็นค่าเริ่มต้น) → บันทึก
บอตจะสร้างหัวข้อให้แต่ละผู้ติดต่อโดยอัตโนมัติ หากไม่มีสิทธิ์แอดมิน + "Manage Topics" การสร้างจะล้มเหลว — อาการคือ "ลูกค้าทักมาแต่ไม่มีอะไรปรากฏในกลุ่ม"
กลุ่มต้องการแค่คุณกับบอต — ไม่ต้องมีคนอื่น หากคุณเพิ่มพาร์ตเนอร์ คำตอบของพวกเขาในหัวข้อจะกระตุ้นการแปลและการส่งเหมือนกับของคุณ

4เลือกหนึ่ง: ☁️ โฮสต์บนคลาวด์ หรือ 💻 โฮสต์เอง

ทุกอย่างฝั่งมือถือเสร็จเรียบร้อยแล้ว ตอนนี้เลือกเส้นทางของคุณ — ไม่มีเซิร์ฟเวอร์? เลือก A: ไม่ต้องติดตั้งอะไรเลย

☁️ ตัวเลือก A · โฮสต์บนคลาวด์ (แนะนำ: ไม่มีเซิร์ฟเวอร์ ไม่ต้องเขียนโค้ด ใช้ได้ทันที)

  1. ส่งข้อความส่วนตัวหาบอตเปิดใช้งานอย่างเป็นทางการ @LingoDeskbot ส่ง /start แล้ววาง BOT_TOKEN จากขั้นที่ 1 ลงไปในแชทเลย
  2. เปิดใช้งานอัตโนมัติทันที: เมื่อโทเคนผ่านการตรวจสอบ มันจะตอบ "🎉 Activated" (และลบข้อความโทเคนของคุณทิ้ง) แพ็กเกจฟรีครอบคลุมการแปลตอบกลับ 300 ครั้ง/เดือน; อัปเกรดเป็น Pro (500 ⭐/เดือน) ได้ทุกเมื่อเพื่อใช้แบบไม่จำกัด เครื่องมือแปลเราออกให้ — ไม่ต้องสมัคร API keys ใด ๆ
  3. ทำตามคำตอบของมันเพื่อเชื่อมต่อให้เสร็จ จากนั้นส่ง /bind ในกลุ่มคอนโซลของคุณ — บอตจะตอบ "✅ bound" แล้วคุณก็เสร็จ ข้ามไปขั้นที่ 5 เพื่อทดสอบ ส่งข้อความส่วนตัว /status ได้ทุกเมื่อ หรือ /native en เพื่อตั้งภาษาของคุณเอง
กังวลเรื่องการมอบโทเคนหรือ? มันถูกเก็บแบบเข้ารหัสและใช้เพื่อรีเลย์เฉพาะแชทที่คุณอนุญาตใน Telegram Business เท่านั้น — และคุณยังควบคุมได้: เพิกถอนได้ทุกเมื่อใน BotFather (/mybots → API Token → Revoke) แล้วโทเคนเก่าจะตายทันที

💻 ตัวเลือก B · โฮสต์เอง (เครื่องของคุณเอง ข้อมูลของคุณเอง)

ก่อนอื่นไปเอาคีย์สำหรับแปลที่ console.anthropic.com → API Keys → Create Key (sk-ant-…; เครดิตไม่กี่ดอลลาร์ใช้ได้นานที่ ~$0.001 ต่อข้อความ) จากนั้น:

git clone https://github.com/sanxiaozi/lingodesk.git cd lingodesk npm install cp .env.example .env # open .env — only BOT_TOKEN and ANTHROPIC_API_KEY are required npm run db:push # initialize the database (first run only) npm run dev 🚀 LingoDesk is up, bot = @my_lingodesk_bot

เมื่อคุณเห็นแบนเนอร์ ให้ส่ง /bind ในกลุ่มคอนโซลของคุณเพื่อเชื่อมต่อ (group ID และ user ID ของคุณจะถูกตรวจจับโดยอัตโนมัติ — ไม่ต้องไปหาตัวเลขใด ๆ) บนเซิร์ฟเวอร์ Docker ใช้คำสั่งเดียว: docker compose up -d — ดูที่ GitHub README

โทเคนบอตหนึ่งตัว = อินสแตนซ์ที่รันได้หนึ่งตัวทั่วโลก (409 Conflict = โปรเซสเก่ายังถือมันอยู่) ถ้าเราโฮสต์ให้คุณ อย่ารันอินสแตนซ์บนเครื่องคุณเองด้วย

5ทดสอบแชท

จากบัญชี Telegram อื่น (บัญชีที่สองหรือของเพื่อน) ส่งข้อความส่วนตัวเป็นภาษาต่างประเทศไปที่บัญชีส่วนตัวของคุณ (ไม่ใช่ที่บอต!) — เช่น "Hola, ¿cuánto cuesta?" ในภาษาสเปน ภายในไม่กี่วินาที หัวข้อใหม่ที่ตั้งชื่อตามผู้ส่งควรจะปรากฏในกลุ่มคอนโซลของคุณ:

📋 LingoDesk Console · หัวข้อ: @amigo_es
my_lingodesk_bot🆕 ผู้ติดต่อใหม่ @amigo_es (es)
ต้นฉบับ: Hola, ¿cuánto cuesta?
🌐 สวัสดี ราคาเท่าไหร่?
─────
↳ พิมพ์ตรงนี้ด้วยภาษาของคุณ — มันจะออกไปเป็นภาษา es ส่งในนามของคุณ
แพ็กเกจ A ราคา $100 และรวมทุกฟีเจอร์ไว้แล้ว
my_lingodesk_bot📤 ตัวอย่างคำแปล (→es) จะส่งหลังจากคุณยืนยันเท่านั้น:

El paquete A cuesta 100 dólares e incluye todas las funciones.

(ข้อความของคุณ: แพ็กเกจ A ราคา $100…)

[ ✅ ส่งให้ลูกค้า ] [ ✏️ ยกเลิก ]

แตะ "✅ ส่งให้ลูกค้า" — อีกฝ่ายเห็นบัญชีส่วนตัวของคุณตอบกลับเป็นภาษาสเปนอย่างคล่องแคล่ว ตอนนี้ทั้งวงจรทำงานแล้ว 🎉

🔧 การแก้ปัญหา

ลูกค้าทักมาแต่ไม่มีอะไรปรากฏในกลุ่มคอนโซล

ตรวจสอบตามลำดับ: ① BotFather → Business Mode เปิดอยู่ (ขั้นที่ 1a); ② Telegram Business → Chatbots มีบอตของคุณเชื่อมต่ออยู่ และแชทนั้นอยู่ในขอบเขต (ขั้นที่ 2); ③ บอตเป็นแอดมินกลุ่มพร้อมสิทธิ์ "Manage Topics" (ขั้นที่ 3); ④ กลุ่มคอนโซลถูกผูกไว้แล้ว — ส่ง /bind ในนั้น; ⑤ สำหรับผู้โฮสต์เอง: โปรเซสของบอตยังรันอยู่โดยไม่มีข้อผิดพลาด

ป๊อปอัปตอนเพิ่มบอต: "บอตนี้ยังไม่รองรับ Telegram Business"

Business Mode ยังไม่ได้เปิดใน BotFather (ขั้นที่ 1a) ไปที่ @BotFather → /mybots → บอตของคุณ → Bot Settings → Business Mode → Turn on มีผลทันที — ไม่ต้องสร้างบอตใหม่หรือส่งโทเคนใหม่ แค่กลับไปที่ Telegram Business → Chatbots แล้วเพิ่มมันอีกครั้ง ผู้ใช้แบบโฮสต์บนคลาวด์สามารถส่งข้อความส่วนตัว @LingoDeskbot /status เพื่อตรวจสอบรายการนี้ซ้ำได้

ฉันส่ง /bind ในกลุ่มแล้วไม่มีอะไรเกิดขึ้น

① Group Privacy ยังเปิดอยู่ (ขั้นที่ 1b) — ปิดมัน แล้วเอาบอตออกและเพิ่มกลับเข้าไปใหม่; ② Topics ยังไม่ได้เปิดในกลุ่ม; ③ ผู้ใช้แบบโฮสต์บนคลาวด์: ให้แน่ใจว่า @LingoDeskbot ตอบว่า "Activated" (ส่งข้อความส่วนตัว /status เพื่อตรวจสอบ); ④ ผู้โฮสต์เอง: ให้แน่ใจว่าโปรเซสกำลังรันอยู่

การมอบ BOT_TOKEN ให้โฮสต์บนคลาวด์ปลอดภัยไหม?

โทเคนถูกเก็บแบบเข้ารหัสและใช้เพื่อรีเลย์เฉพาะแชทภายในขอบเขตที่คุณอนุญาตใน Telegram Business เท่านั้น — และคุณสามารถกันผู้ติดต่อส่วนตัวออกได้ (ขั้นที่ 2) คุณยังควบคุมได้: เพิกถอนได้ทุกเมื่อผ่าน BotFather → /mybots → API Token → Revoke; โทเคนเก่าจะตายทันทีและบริการจะหยุด หากต้องการกลับมาใช้ ก็แค่ส่งโทเคนใหม่ให้ @LingoDeskbot

ฉันพิมพ์ในหัวข้อแล้วบอตไม่ทำอะไรเลย

เก้าในสิบครั้งคือ Group Privacy ยังเปิดอยู่ (ขั้นที่ 1b) BotFather → Bot Settings → Group Privacy → Turn off จากนั้นเอาบอตออกจากกลุ่มแล้วเพิ่มกลับเข้าไปใหม่ (การเปลี่ยนแปลงจะมีผลหลังเข้าร่วมใหม่เท่านั้น) แล้วเลื่อนขึ้นเป็นแอดมินอีกครั้ง

เริ่มระบบล้มเหลวด้วย 409 Conflict

มีอินสแตนซ์สองตัวรันอยู่บนโทเคนเดียวกัน หาและหยุดโปรเซสเก่า (Ctrl+C หรือ pkill -f "tsx.*main.ts") รอสิบวินาที แล้วเริ่มใหม่

"ส่งให้ลูกค้า" ล้มเหลวด้วยข้อผิดพลาดทั่วไป

ตรวจสอบตามลำดับความน่าจะเป็น: ① สิทธิ์ "Reply to messages" ปิดอยู่ (พบบ่อยที่สุด) — Settings → Telegram Business → Chat Automation (Chatbots) → บอตของคุณ → เปิด "Reply to messages"; หากไม่เปิด บอตจะอ่านได้แต่ส่งไม่ได้; ② แชทของลูกค้าไม่อยู่ในขอบเขตแชทที่บอตเข้าถึงได้ (หน้าเดียวกัน); ③ ผู้ติดต่อไม่ได้ทักคุณมานานเกิน 24 ชั่วโมง — Telegram บล็อกการส่งที่ริเริ่มโดยบอต; ขอให้พวกเขาส่งอะไรมาก่อน ผู้ใช้แบบโฮสต์บนคลาวด์: ส่งข้อความส่วนตัว @LingoDeskbot /status — บรรทัด "reply permission" ให้คำตอบคุณโดยตรง

"ส่งให้ลูกค้า" ล้มเหลว: ผู้ติดต่อไม่มีความเคลื่อนไหวนานเกินไป

ข้อจำกัดของ Telegram: หากบทสนทนาเงียบไปนานเกินไป บอตจะริเริ่มแทนคุณไม่ได้ (BUSINESS_PEER_USAGE_MISSING) ขอให้พวกเขาส่งอะไรมาเพื่อกระตุ้นให้กลับมาใช้งาน หรือตอบเองด้วยมือจากมือถือของคุณสักครั้งนี้

ส่งล้มเหลว: การเชื่อมต่อธุรกิจไม่ถูกต้อง

ไปที่ Settings → Telegram Business → Chatbots เอาบอตออกแล้วเพิ่มกลับเข้าไปใหม่ — หรือแค่รอข้อความถัดไปของลูกค้า ซึ่งจะทำให้บอตจับการเชื่อมต่อใหม่ได้โดยอัตโนมัติ

ตรวจจับภาษาผิด / ต้องการภาษาปลายทางอื่น

ภาษาจะถูกล็อกที่ข้อความแรกของผู้ติดต่อ (เพื่อเลี่ยงการสลับไปมาบนข้อความสั้น ๆ) ส่ง /lang code ในหัวข้อของผู้ติดต่อรายนั้นเพื่อแก้ไข เช่น /lang pt (โปรตุเกส) หรือ /lang ar (อาหรับ)

หลังจากรีสตาร์ท ปุ่ม "ส่ง / ยกเลิก" เก่าใช้งานไม่ได้แล้ว

ตัวอย่างที่รอดำเนินการอยู่ในหน่วยความจำและจะหมดอายุเมื่อรีสตาร์ท (ปุ่มจะบอกคุณเอง) แค่พิมพ์คำตอบของคุณอีกครั้งในหัวข้อ ผู้ติดต่อและประวัติแชทอยู่ในฐานข้อมูล — ไม่มีอะไรสูญหาย

🎉 ทำงานได้ทั้งหมดแล้ว?

จากนี้ไป ลูกค้าจะเขียนด้วยภาษาใดก็ได้ตามใจชอบ — คุณแค่พิมพ์ด้วยภาษาของคุณ หากมีอะไรพัง ให้ลองไล่ดูรายการแก้ปัญหาข้างต้นก่อน; หากยังติดขัด ส่งอีเมลหาเราพร้อมภาพหน้าจอของข้อผิดพลาดในเทอร์มินัล

✉️ [email protected]