ข้ามไปที่เนื้อหา
Promenu คู่มือ
ไปที่เว็บไซต์ สมัคร

เริ่มต้นใช้งาน

วิธีเชื่อมต่อ Telegram Mini App กับเมนูดิจิทัลของร้าน

คู่มือทีละขั้นตอน: เปิดเมนูดิจิทัลใน Telegram Mini App — สร้างบอทใน BotFather ใส่โทเคนใน Promenu แล้วตั้ง URL เป็น Main App และ Menu Button ใช้เวลา 10–15 นาที

อัปเดต 11 กันยายน 2569 อ่าน 5 นาที

ถ้าคุณอยากให้ลูกค้าเปิดเมนูดิจิทัลใน Telegram ได้ Telegram Mini App คือเมนูชุดเดียวกันที่อยู่ในแชต: ลูกค้าเปิดบอทของร้านแล้วเลื่อนดูแคตตาล็อกได้โดยไม่ต้องติดตั้งอะไร และไม่ต้องออกจากแชต Telegram ไม่ใช่แอปแชตหลักในไทย แต่เป็นช่องทางเสริมสำหรับลูกค้าที่ใช้ Telegram อยู่แล้ว — ประตูอีกบานเข้าสู่แคตตาล็อกเดียวกับที่เปิดด้วย QR

ด้านล่างคือเส้นทางจากบอทว่าง ๆ จนได้มินิแอปที่ใช้งานได้ใน Promenu คนส่วนใหญ่ใช้เวลา 10–15 นาทีถ้าร้านมีในระบบแล้ว ถ้ายังไม่มีร้าน สร้างเมนูดิจิทัลก่อน.

สิ่งที่ต้องมี

  • เวลา 10–15 นาที
  • สิทธิ์เข้า แผงควบคุม Promenu และร้านที่มีในระบบแล้ว
  • Telegram บนมือถือหรือคอมพิวเตอร์
  • แคตตาล็อกที่พร้อมโชว์: รายการอาหารไม่กี่อย่าง และโหมด Menu view (ดูเมนู) — เปิดอยู่ตั้งแต่ต้น

ในแผงควบคุมต้องไปที่ไหน

  1. Places (รายการร้าน)
  2. เปิดร้าน → Edit (แก้ไข)
  3. ในส่วนของร้าน เปิด Mini App (มินิแอป)

หน้าจอมีสองช่องกับลิงก์ที่พร้อมใช้: Bot token (โทเคนของบอท), Bot username (ชื่อผู้ใช้บอท โดยไม่มี @) และ URL รูปแบบ https://tg.promenu.space/?rmode=… พร้อมปุ่ม Copy URL (คัดลอก URL) คำใบ้ "How to set up Mini App" และ "How to create a bot in @BotFather" อยู่หน้าจอเดียวกัน — ด้านล่างคือเส้นทางนั้นเป็นภาษาเข้าใจง่าย

วิธีเชื่อมต่อ Telegram Mini App: 4 ขั้นตอน

  1. สร้างบอทใน Telegram

    เปิด @BotFather — บอททางการของ Telegram สำหรับสร้างบอท กด Start จากนั้นเลือก Create a new bot หรือส่ง /newbot ชื่อบอทคือสิ่งที่ลูกค้าจะเห็น (เช่น "คาเฟ่ริมน้ำ") username ต้องเป็นตัวอักษรละตินและลงท้ายด้วย bot โดยไม่มี @ — จะนำไปใส่ใน Promenu ทีหลัง คำอธิบายกับรูปโปรไฟล์ค่อยใส่ทีหลังได้ จากนั้น BotFather จะส่ง โทเคน สตริงยาวแบบ 123456:ABC-… คัดลอกไว้ และอย่าส่งต่อให้ใคร

  2. ใส่ข้อมูลบอทใน Promenu

    กลับไปที่ Places → ร้านของคุณ → Mini App วางโทเคนจาก BotFather ใน Bot token — Show token (แสดงโทเคน) ช่วยเช็กว่าไม่มีช่องว่างเกิน ใน Bot username พิมพ์ username โดยไม่มี @: ถ้าบอทคือ @biba_cafe_bot ให้เขียน biba_cafe_bot บันทึกการ์ดร้าน Promenu แสดง URL ของมินิแอปในหน้านี้แล้ว — กด Copy URL.

  3. ตั้ง URL ใน BotFather

    เปิด @BotFather อีกครั้ง เลือกบอทจากรายการ หรือส่ง /mybots จากนั้น: Bot Settings → Mini Apps ใส่ URL จาก Promenu ชุดเดียวกันสองที่: Main App (มินิแอปหลักของบอท) และ Menu Button (ปุ่มข้างช่องข้อความ ให้ลูกค้าเปิดเมนูได้ในครั้งเดียว)

  4. ตรวจใน Telegram

    ค้นหาบอทจาก username กด Start แล้วเปิด Mini App จากปุ่มเมนู คุณควรเห็นชื่อ ภาพหน้าปก หมวดหมู่ และรายการอาหาร — ตามที่เปิดไว้ใน Modes (โหมดการทำงาน) เปิด https://tg.promenu.space/?rmode=… ในเบราว์เซอร์เพื่อดูแคตตาล็อกคร่าว ๆ ได้ แต่ Mini App ที่แท้จริงรู้สึกถูกต้องเฉพาะใน Telegram

สิ่งที่ควรเช็กเพิ่มในหน้าใกล้กัน

หน้าเหล่านี้ไม่ได้แทน Mini App แต่ถ้าไม่มี ลูกค้าอาจเปิดเปลือกว่าง

  • Link (ลิงก์) — slug สาธารณะสั้นของร้าน (ตัวอักษรละติน ตัวเลข - และ _ ความยาว 3–64 ตัว) เว้นว่างได้
  • Modes: Menu view เปิดอยู่แล้ว เปิด Delivery (เดลิเวอรี) และ Pickup (รับที่ร้าน) ถ้าต้องการรับออร์เดอร์จาก Telegram — ต้องใช้แพ็กเกจ Pro หรือ Ultimate
  • Active (เปิดใช้งาน) — ถ้ายังปิดอยู่ ร้านจะเป็นแบบร่างและลูกค้าจะไม่เห็น

เช็กลิสต์ก่อนเปิดใช้จริง

  • เปิดร้าน → Mini App แล้ว
  • สร้างบอทใน @BotFather แล้ว
  • ใส่โทเคนใน Promenu แล้ว
  • ใส่ username โดยไม่มี @ แล้ว
  • คัดลอก URL จาก Promenu แล้ว
  • ตั้ง URL นั้นเป็น Main App และ Menu Button ใน BotFather แล้ว
  • เปิดบอทใน Telegram แล้วเมนูดูถูกต้อง
  • ร้านเป็น Active และมีรายการอาหารในเมนู

ลืมอะไรไป ต้องกดที่ไหน

ทางลัด: Promenu และ BotFather
สิ่งที่ต้องทำอยู่ที่ไหน
ตั้งค่า Mini AppPlaces → ร้าน → Mini App
สร้างบอทTelegram → @BotFather → /newbot
ตั้ง URLBotFather → บอท → Bot Settings → Mini Apps
ลิงก์สาธารณะของร้านร้าน → Link
เดลิเวอรีและรับที่ร้านร้าน → Modes
ตัวอย่างการ์ดโปรไฟล์ร้าน → App preview

ถ้า BotFather ติเรื่อง username หรือ URL โดยมาก username ถูกใช้แล้ว — หรือมีช่องว่างหลุดเข้าไปในลิงก์ คัดลอก URL ใหม่ด้วย Copy URL แล้ววางโดยไม่แก้

คำถามที่พบบ่อย

ต้องสร้างบอทใหม่ไหม

ร้านต้องมีบอทใน BotFather คุณใช้บอทที่มีอยู่แล้วได้: ใส่โทเคนและ username ใน Promenu แล้วตั้ง URL ของ Mini App ในการตั้งค่าของบอทนั้น

บอทเดียวดูแลหลายร้านได้ไหม

แยกบอทต่อร้านหรือต่อแบรนด์มักชัดเจนกว่าสำหรับลูกค้า ถ้ายังไม่แน่ใจ เริ่มจากบอทหนึ่งตัวต่อหนึ่งร้าน

โทเคนกับ username อะไรสำคัญกว่า

Promenu ต้องการทั้งสองอย่าง โทเคนผูกแผงควบคุมกับบอท ส่วน username บอกคนและระบบว่าคุณต่อบอทตัวไหน

ทำไมใน Telegram ว่าง หรือขึ้นเมนูผิดร้าน

ตรวจตามลำดับนี้: Promenu บันทึกโทเคนและ username ที่ถูกต้องแล้ว Main App และ Menu Button ใน BotFather ใช้ URL ของร้านนี้ ร้านสลับเป็น Active แล้ว มีรายการในเมนู และโหมดที่ต้องการเปิดอยู่ ถ้ายังไม่หาย ทักทาง Telegram ที่ @EmilDevelop.

เก็บโทเคนในแผงควบคุมปลอดภัยไหม

มีแค่คนที่แก้ไขร้านได้ที่เห็นโทเคน อย่าวางในแชต ถ้าหลุดไป ให้เพิกถอนใน BotFather แล้วอัปเดตใน Promenu

ต้องตั้ง whitelist โดเมนแยกไหม

หน้า Mini App ปัจจุบันใน Promenu ไม่ขอ whitelist โดเมน: ใส่ URL จากแผงควบคุมใน Mini Apps ของ BotFather ก็พอ

พร้อมเปิดเมนูร้านใน Telegram แล้วหรือยัง

เปิดแผงควบคุม

ยังมีคำถามเกี่ยวกับขั้นตอนนี้? ทักหาเราทาง Telegram