Telegram Mini App Studio — Stars Billing Starter | โครง Mini App เก็บเงินด้วย Telegram Stars

ทำไมต้อง Telegram Mini App + Stars

💰 ผู้ใช้จ่ายในแชท ไม่ออกจากแอป

backend ยิง sendInvoice currency=XTR → Telegram เปิดหน้าชำระด้วย Stars ให้เองในแชท ผู้ใช้กดจ่ายจบภายในแอปเดียว ไม่ต้องเด้งไปหน้าเว็บ ไม่มี friction ตอนจ่าย

🚫 ไม่ต้องต่อ Stripe ฝั่งแอป

การเงินจัดการโดย Telegram ทั้งหมด — ไม่ต้องสมัคร merchant ไม่ต้องเก็บบัตรเอง Stars ถอนคืนได้จริง (~$13 ต่อ 1,000 Stars ผ่าน TON)

🔐 ไม่ต้องทำระบบ login

Telegram ส่ง initData มาพร้อม signature — backend ยืนยันด้วย HMAC-SHA256 ตามสเปกแล้วรู้ทันทีว่า user ไหน ปลอม/ขโมย id อื่นไม่ได้ (test พิสูจน์ให้ดูแล้ว)

🐍 สแตกเดียวจบ

FastAPI ไฟล์เดียว + หน้า HTML เดียว รันได้ทั้งเครื่องลูกค้าและ VPS/Fly.io ที่ไหนก็ได้ที่มี Python — deploy แล้วชี้ Menu Button คือขายได้

ของจริงในไฟล์ zip

app.py

Backend FastAPI

ระบบเครดิต + /api/tts + /api/create-invoice (XTR) + validate_init_data() ครบในไฟล์เดียว อ่านจบใน 30 นาที

static/index.html

หน้า Mini App ภาษาไทย

ใช้ Telegram WebApp SDK อย่างเป็นทางการ ธีมสีตาม Telegram อัตโนมัติ ปุ่มเติม Stars เล่นเสียงในแอปได้

test_app.py

Integration test 8 ข้อ

รันเองได้ไม่ต้องมี bot token — พิสูจน์เครดิต, invoice XTR, HMAC จับข้อมูลปลอม และไฟล์เสียงจริง

README-buyer.md
DEPLOY.md · CUSTOMIZE.md · LICENSE.txt

คู่มือครบตั้งแต่ 0

quickstart, deploy Fly.io/Railway พร้อม HTTPS, คู่มือต่อ ElevenLabs + ปรับราคา/เครดิต, ไอเดียต่อยอด, license เชิงพาณิชย์ 1 ผู้ซื้อ

โครงระบบ — อธิบายจากโค้ดจริงใน kit

/api/tts — หักเครดิตก่อนทำงาน: เริ่มฟรี 3 ครั้งต่อผู้ใช้ ครั้งที่ 4 เมื่อเครดิตหมดตอบ HTTP 402 ให้หน้าแอปชวนกดเติม (ทดสอบแล้ว: [200, 200, 200, 402])
/api/create-invoice — ตรวจ sku แล้วสร้าง payload sendInvoice ตามสเปก: currency: XTR · 10 เครดิต = 50 Stars · 50 เครดิต = 200 Stars (sku ผิด → 422)
validate_init_data() — ยืนยัน signature แบบ 2 ชั้นตามสเปก Bot API: สร้าง secret จาก HMAC("WebAppData", bot_token) แล้วเทียบ HMAC ของ data-check-string ด้วย hmac.compare_digest — แก้ user id ขโมยแล้ว signature พังทันที (test จับได้จริง)
เครดิต + ราคาเป็นตัวแปรบนสุดของไฟล์ — FREE_CREDITS, PRICE_STARS แก้ตัวเลขจุดเดียวเปลี่ยนทั้งระบบ

# จาก app.py จริงใน kit (ย่อ)
FREE_CREDITS = 3
PRICE_STARS = {"credits_10": 50, "credits_50": 200}   # หน่วย: Stars (XTR)

secret_key = hmac.new(b"WebAppData", BOT_TOKEN.split(":")[1].encode(), hashlib.sha256).digest()
calc = hmac.new(secret_key, data_check_string.encode(), hashlib.sha256).hexdigest()
# เทียบด้วย hmac.compare_digest → ผ่านเฉพาะของแท้จาก Telegram เท่านั้น

เริ่มขายได้ใน 3 ขั้น

สร้างบอท — คุยกับ @BotFather → /newbot → ได้ BOT_TOKEN ฟรี ไม่เสียค่าใช้จ่าย
Deploy เซิร์ฟเวอร์ — ตาม DEPLOY.md ใน kit (Fly.io หรือ Railway) — Mini App ต้องรันบน HTTPS เท่านั้น
เปิดปุ่มแอปในแชท — BotFather → /setmenubutton → ชี้ URL ที่ deploy → ปุ่มเปิดแอปโผล่ในแชทผู้ใช้ทันที

คำถามที่พบบ่อย — ตอบตรง ๆ

เสียงที่สร้างได้เป็นเสียงพูดจริงไหม?

ยังไม่ใช่ — พูดตรง ๆ: TTS ใน kit เป็น dry-run tone generator สร้างไฟล์ WAV จริง (~120KB ต่อครั้ง) เพื่อพิสูจน์ว่า pipeline เครดิต→สร้างเสียง→เล่นในแอปทำงานครบ แต่ยังไม่ใช่เสียงพูด จุดต่อ ElevenLabs คือฟังก์ชัน synth_dry_run() จุดเดียวใน app.py แก้ที่เดียวจบ และต่อแล้วโครง billing เครดิต-ด้วย-Stars ทั้งระบบใช้ได้เลย (คู่มืออยู่ใน DEPLOY.md)

ต้องมีอะไรก่อนซื้อ?

(1) บัญชี Telegram + bot token จาก @BotFather (ฟรี) (2) บัญชี deploy เช่น Fly.io หรือ Railway — เครื่องเล็กสุดพอ ค่าใช้จ่ายราว $5/เดือน (3) Python 3.10+ บนเครื่องที่จะแก้โค้ด

เงิน Stars ถอนออกมาเป็นเงินบาทได้ไหม?

ได้ แต่ต้องรู้ทาง: Stars ถอนผ่าน TON (~$13 ต่อ 1,000 Stars ณ ตอนวิจัย) และตลาดไทยยังไม่มีคู่ THB_TON โดยตรง (ตรวจ Bitkub live API แล้ว) จึงใช้เส้นทาง TON→USDT→THB หรือ wallet ที่แลกตรง — เราแนะนำให้ทดสอบวงจรเงินจริง 1 รอบ (ซื้อ Stars → ยิง invoice → ถอน) ด้วยเงิน ~100 บาทก่อนเทรดจริง

เครดิตผู้ใช้เก็บที่ไหน ใช้จริงระดับ production ได้ไหม?

starter นี้เก็บเครดิต in-memory เพื่อให้โค้ดสั้นอ่านจบ — เหมาะกับการพิสูจน์ตลาดและผู้ใช้ช่วงแรก จุดต่อ SQLite/Postgres มี comment บอกไว้ใน app.py แล้ว

ปรับราคา/จำนวนเครดิต/ธุรกิจอื่นที่ไม่ใช่ voiceover ได้ไหม?

ได้ — ราคา Stars และเครดิตฟรีแก้ที่ตัวแปรบนสุดของ app.py และ CUSTOMIZE.md มีตัวอย่างเปลี่ยนจาก voiceover เป็นไอเดีย Mini App อื่น (เช่น สรุปข่าว, ตรวจการบ้าน, สติกเกอร์ AI) โดยโครง credits + billing เหมือนเดิมทั้งหมด

ซื้อแล้วได้ไฟล์ยังไง?

จ่ายผ่าน Stripe → หน้าชำระพามาที่หน้าตั้งรหัสผ่าน → ดาวน์โหลด zip ได้ทันที และกลับมาดาวน์โหลดซ้ำได้ตลอดที่ tg-miniapp-studio.zicula.trade/thanks ด้วยอีเมล+รหัสผ่านที่ตั้งไว้

License ครอบคลุมแค่ไหน?

Commercial license สำหรับ 1 ผู้ซื้อ — ใช้กับสินค้า/ธุรกิจของตัวเองได้เต็มที่ แก้ได้ ขายต่อเป็น service ได้ แต่ห้าม resale หรือแจกจ่ายซอร์สโค้ดต้นฉบับเป็นสินค้าแข่งกับเรา

โครง Mini App ที่เก็บเงินด้วย Telegram Stars — ซื้อโค้ดจริง รันได้คืนนี้