Skip to main content

Ko-fi Webhook

เชื่อมต่อ Ko-fi เข้ากับแอปผ่าน webhook เพื่อรับ donation และ subscription แบบ realtime แล้วป้อนเข้าคิวเดียวกับ source อื่น ๆ เพื่ออ่าน TTS + แสดง overlay รองรับหลายสกุลเงิน (USD/EUR/JPY ฯลฯ) แปลงเป็นบาทอัตโนมัติ — เหมาะกับผู้ชมต่างชาติ (Ko-fi ไม่มี PromptPay)

การตั้งค่าใช้ 2 ส่วน เพื่อความปลอดภัย: Webhook URL (ที่สร้างจากในแอป) + Verification Token (คัดลอกมาจาก Ko-fi) — ต้องมีครบทั้งคู่ถึงจะนับว่า Connected

ทำอะไรได้​

  • รับ donation / subscription จาก Ko-fi ผ่าน webhook (ชื่อผู้โดเนท / ข้อความ / ยอด / สกุลเงิน)
  • ป้อนเข้าคิวรวม — อ่าน TTS + แสดง overlay เหมือน source อื่น
  • หลายสกุลเงิน → แปลงเป็นบาทอัตโนมัติ
  • Generate / Regenerate Webhook URL ได้จากในแอป — ถ้า URL หลุดก็ regen เพื่อ revoke ของเดิม
  • แสดงสถานะ Connected / Disconnected + เวลาที่รับล่าสุด

เข้าถึงได้จาก​

Settings → Connections → ☕ Ko-fi

หน้า Settings → Connections ส่วน Ko-fi แสดงปุ่ม Generate Webhook URL + ช่อง Verification Token
สร้าง Webhook URL ในแอป + วาง Verification Token จาก Ko-fi ให้ครบทั้งคู่

Inputs / ตั้งค่าได้​

  • Webhook URL — กดสร้างในแอป (แสดงครั้งเดียว ต้อง copy ก่อนออกจากหน้า) แล้วนำไปวางใน Ko-fi → More → API → Webhook URL
  • Verification Token — คัดลอกจาก Ko-fi → More → API → Advanced มาวางในแอป จำเป็นต้องมี ไม่งั้นโดเนทจะถูกปฏิเสธ

Outputs / สิ่งที่จะเกิดขึ้น​

  • สถานะ Connected / Disconnected + "Last received: …"
  • เฉพาะ event ชนิด Tip / Donation / Subscription เท่านั้นที่เด้ง alert (Commission / Shop Order จะถูกข้าม)
  • Donation event เข้าคิวอัตโนมัติ พร้อมส่งต่อไป TTS + overlay (ยอดแสดงเป็นบาทหลังแปลงสกุล)

หมายเหตุ​

:::warning ต้องวาง Verification Token เสมอ ถ้าวางแค่ Webhook URL แต่ไม่ใส่ Verification Token โดเนทจะถูก ปฏิเสธทันที และ Ko-fi ไม่ retry — โดเนทนั้นจะหายไปเลย ตั้งให้ครบทั้งคู่ก่อนเปิดรับจริง :::

  • ยืนยันตัว 2 ชั้น: token ใน URL (routing) + Verification Token (ตรวจว่าเป็นของ Ko-fi จริง)
  • ไม่รองรับ PromptPay — Ko-fi รับบัตร/โอนต่างประเทศ เหมาะกับผู้ชมต่างชาติ
  • อีเมล/ที่อยู่จัดส่งของผู้โดเนทเป็นข้อมูลส่วนบุคคล (PII) — แอป ไม่เก็บและไม่ log ใช้แค่ชื่อ/ข้อความ/ยอด/สกุลเงิน

Use case​

streamer ที่มีผู้ติดตามต่างชาติและรับเงินผ่าน Ko-fi — สร้าง Webhook URL ในแอป วางลง Ko-fi แล้วคัดลอก Verification Token กลับมาวางให้ครบ จากนั้นทุก tip / subscription จะวิ่งเข้าระบบเดียวกับ source อื่น อ่าน TTS และเด้ง overlay พร้อมแปลงสกุลเงินเป็นบาทให้อัตโนมัติ

คู่มือที่เกี่ยวข้อง​