คู่มือ

คู่มือการตั้งค่า Kick

วิธีตั้งค่าช่อง Kick ของคุณและเชื่อมต่อกับหน้าให้ทิปของคุณบนหน้าแก้ไขร้านค้า — รวมถึงการแจ้งเตือนแบบสดในแชทเมื่อมีทิปเข้ามา

สิ่งที่คุณต้องมี: บัญชี Kick (สร้างฟรีที่ kick.com), สิทธิ์ผู้ดูแลสำหรับร้านค้าของคุณบน Xpress Tips และเวลาประมาณ 10 นาที

หมายเหตุ: Kick ไม่มีระบบการให้ทิปในตัว นั่นคือเหตุผลที่ Xpress Tips มีอยู่ — เพื่อเติมเต็มช่องว่างนั้น และมอบวิธีง่าย ๆ ให้ผู้ชมของคุณสนับสนุนคุณขณะที่คุณกำลังไลฟ์

1. สร้างแอป Kick Developer

ก่อนที่คุณจะเชื่อมต่อช่องของคุณกับ Xpress Tips ได้ คุณต้องสร้างแอป developer บน Kick ก่อน แอปนี้จะสร้าง Client ID และ Client Secret ที่ Xpress Tips ใช้ตรวจสอบสิทธิ์กับ Kick ในนามของคุณ

สิ่งสำคัญ: คุณ ต้อง เปิดใช้งานการยืนยันตัวตนสองขั้นตอน (2FA) บนบัญชี Kick ของคุณก่อน จึงจะเข้าถึงแท็บ Developer ได้ หากยังไม่ได้เปิด 2FA ตัวเลือก Developer จะไม่ปรากฏในการตั้งค่าของคุณ

เปิดใช้งาน 2FA ก่อน

  1. เข้าสู่ระบบที่ kick.com
  2. คลิก รูปโปรไฟล์ ของคุณ (มุมขวาบน) → Settings
  3. ไปที่แท็บ Security และเปิดใช้งาน การยืนยันตัวตนสองขั้นตอน (2FA)

สร้างแอปของคุณ

  1. เมื่อเปิด 2FA แล้ว ให้ไปที่ Settings → Developer (หรือเข้าที่ kick.com/settings/developer โดยตรง)
  2. คลิก Create New หรือ Create App
  3. กรอกรายละเอียดตามที่ระบบร้องขอ คุณจะถูกขอให้ระบุ Redirect URL ซึ่งเป็น URL ที่ Kick จะส่งคุณกลับมาหลังจากอนุญาตแอปแล้ว ให้กรอกตามนี้ทุกตัวอักษร:

    https://thai-venues.xpresstips.uk/admin/kick/callback

    คัดลอกให้แม่นยำ รวมถึง https:// และไม่มีเครื่องหมายทับ (/) ต่อท้าย หาก Redirect URL ไม่ถูกต้อง การเชื่อมต่อจะล้มเหลว
  4. บันทึกแอป
  5. คุณจะเห็น Client ID และ Client Secret คัดลอกทั้งสองค่าทันทีและเก็บไว้อย่างปลอดภัย ห้ามเปิดเผย Client Secret ให้ผู้อื่น
หมายเหตุด้านความปลอดภัย: ปฏิบัติต่อ Client Secret เสมือนรหัสผ่าน หากสงสัยว่าถูกเปิดเผย ให้ลบแอปใน Kick Developer settings และสร้างใหม่ คุณจะต้องเชื่อมต่อ Kick ใหม่บนหน้าแก้ไขร้านค้าของ Xpress Tips ด้วยข้อมูลรับรองใหม่

เมื่อคุณมี Client ID และ Client Secret แล้ว คุณสามารถดำเนินการเชื่อมต่อบัญชี Kick ของคุณบน Xpress Tips ในขั้นตอนถัดไป

2. เชื่อมต่อบัญชี Kick ของคุณบน Xpress Tips

เมื่อสร้างแอป Kick Developer แล้ว คุณสามารถเชื่อมต่อกับ Xpress Tips ขั้นตอนนี้ใช้ระบบ OAuth ของ Kick — คุณจะอนุมัติการเชื่อมต่อเพียงครั้งเดียว และจะคงอยู่ต่อไป

สิ่งที่ Xpress Tips ต้องการ

การเชื่อมต่อนี้ต้องใช้ Client ID และ Client Secret จากแอปที่คุณสร้างในขั้นตอนที่ 1 และ การอนุญาตจากคุณ (ดำเนินการครั้งเดียวต่อช่อง) สิทธิ์ที่ร้องขอคือ:

  • chat:write — โพสต์การแจ้งเตือนทิปในแชทของคุณในนามของคุณ
สิ่งสำคัญ: สิทธิ์ chat:write จำเป็นสำหรับการแจ้งเตือน หากไม่มี Xpress Tips จะไม่สามารถโพสต์อะไรในแชทของคุณได้ คุณจะเห็นสิทธิ์นี้บนหน้าอนุมัติของ Kick เมื่อคุณเชื่อมต่อบัญชี

วิธีเชื่อมต่อบัญชีของคุณ

  1. เข้าสู่ระบบที่ thai-venues.xpresstips.uk ในฐานะผู้ดูแล
  2. ไปที่ Dashboard → Venues และคลิก Edit ข้างร้านค้าที่คุณต้องการเชื่อมต่อ
  3. เปิดหน้า ตั้งค่า (Settings) ของร้านค้า หรือไปที่ ตั้งค่า → Kick Settings จากแดชบอร์ดร้านค้าของคุณ
  4. วาง Client ID และ Client Secret จากแอป Kick Developer ของคุณลงในช่องที่ตรงกัน
  5. บันทึกการตั้งค่า จากนั้นคลิก Link Kick Account
  6. คุณจะถูกนำไปยังหน้าอนุมัติของ Kick ซึ่งแสดงสิทธิ์ที่ Xpress Tips ร้องขอ (chat:write)
  7. อนุมัติสิทธิ์ Kick จะส่งคุณกลับมายัง Xpress Tips พร้อม token ที่ปลอดภัย
  8. Xpress Tips จะบันทึกการเชื่อมต่อไว้กับร้านค้าของคุณ คุณจะเห็นการยืนยันบนหน้าแก้ไขร้านค้า

ทดสอบการเชื่อมต่อ

เมื่อเชื่อมต่อแล้ว คลิกปุ่ม Test Link บนหน้าแก้ไขร้านค้า Xpress Tips จะส่งข้อความทดสอบไปยังแชท Kick ของคุณเพื่อยืนยันว่าการเชื่อมต่อทำงานได้

หากคุณเห็นข้อความทดสอบปรากฏในแชทของคุณ แสดงว่าทุกอย่างตั้งค่าถูกต้อง และทิปจะโพสต์การแจ้งเตือนโดยอัตโนมัติ

การยกเลิกการเชื่อมต่อ

คุณสามารถยกเลิกการเชื่อมต่อได้ทุกเมื่อจากหน้าแก้ไขร้านค้าเดียวกัน การยกเลิกจะเพิกถอนความสามารถของ Xpress Tips ในการโพสต์ในแชทของคุณทันที

3. การค้นหา Kick ID ของคุณ

เพื่อส่งการแจ้งเตือนไปยังแชทของคุณ Xpress Tips ต้องการ ID สองตัวจากช่อง Kick ของคุณ:

  • Chatroom ID — ID ภายในสำหรับแชทของช่องคุณ
  • Broadcaster User ID — ID ภายในสำหรับบัญชี Kick ของคุณ

ค่าเหล่านี้ไม่ได้แสดงอยู่ในแดชบอร์ดของ Kick แต่คุณสามารถค้นหาได้จากหน้า JSON สาธารณะ

ค้นหาโดยตรง

ไปที่ URL นี้ โดยแทนที่ [channel_name] ด้วยชื่อผู้ใช้ Kick ของคุณ:

https://kick.com/api/v2/channels/[channel_name]

ตัวอย่างเช่น หากช่องของคุณคือ kick.com/sarahstreams URL จะเป็น:

https://kick.com/api/v2/channels/sarahstreams

เคล็ดลับ: Firefox แสดงหน้า JSON นี้ในรูปแบบที่อ่านง่ายและเป็นระเบียบ เบราว์เซอร์อื่นอาจแสดงเป็นข้อความยาวบรรทัดเดียว

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

เมื่อหน้าโหลดแล้ว ใช้ Ctrl+F (หรือ Cmd+F บน Mac) เพื่อค้นหาค่าสองค่าต่อไปนี้:

  1. Chatroom ID — ค้นหา "chatroom" คุณจะเห็นอะไรทำนองนี้:

    "chatroom":{"id":12345678, ...}

    ตัวเลขหลัง "id": คือ Chatroom ID ของคุณ
  2. Broadcaster User ID — ค้นหา "broadcaster_user_id" คุณจะเห็นอะไรทำนองนี้:

    "broadcaster_user_id":987654

    ตัวเลขหลังเครื่องหมายทวิภาคคือ Broadcaster User ID ของคุณ

ทางเลือก: ใช้เครื่องมือสำหรับนักพัฒนาในเบราว์เซอร์

หากหน้า JSON อ่านยาก คุณสามารถค้นหา Chatroom ID ได้โดยใช้เครื่องมือสำหรับนักพัฒนาในเบราว์เซอร์:

  1. เปิดหน้าช่อง Kick ของคุณ
  2. กด F12 เพื่อเปิด Developer Tools
  3. ไปที่แท็บ Network และรีเฟรชหน้า
  4. ในช่องตัวกรอง พิมพ์ chatroom
  5. คลิกที่คำขอที่ปรากฏ
  6. Chatroom ID จะมองเห็นได้ในการตอบกลับ

กรอกที่ไหน

บนหน้า แก้ไขร้านค้า ใน Xpress Tips ในส่วน Kick Settings ให้วาง ID ทั้งสองในช่องที่ตรงกัน จากนั้นคลิก Test Link เพื่อยืนยันว่าทุกอย่างทำงานได้

สิ่งสำคัญ: ID เป็นตัวเลขเท่านั้น — ห้ามใส่เครื่องหมายคำพูด ช่องว่าง หรืออักขระอื่น ๆ จากหน้า JSON ใส่แค่ตัวเลขเท่านั้น

4. เปิดใช้งานการแปลภาษา (ไม่บังคับ)

ร้านค้าบนแพลตฟอร์มไทยสามารถเปิดใช้งานการแปลภาษาในแชทได้ — รองรับการแปลจากภาษาใดก็ได้เป็นภาษาไทย และจากภาษาไทยเป็นภาษาอังกฤษ เหมาะสำหรับร้านค้าในพื้นที่ท่องเที่ยวที่มีผู้ชมทั้งชาวไทยและต่างชาติ

หมายเหตุ: ฟีเจอร์นี้ต้องใช้สิทธิ์เพิ่มเติมจาก Kick (events:subscribe) ซึ่งจะขอเมื่อคุณเปิดใช้งานการแปลในแดชบอร์ดร้านค้า และต้องตั้งค่า Webhook ในแอป Kick Developer ของคุณก่อน

สิ่งที่ต้องตั้งค่าในแอป Kick Developer

  1. กลับไปที่ Settings → Developer บน Kick (หรือ kick.com/settings/developer)
  2. เปิดแอปที่คุณสร้างไว้ในขั้นตอนที่ 1
  3. เปิดใช้งาน Webhook (หรือ "Webhooks")
  4. กรอก Webhook URL ตามนี้ทุกตัวอักษร:

    https://thai-venues.xpresstips.uk/kick/webhook

    คัดลอกให้แม่นยำ รวมถึง https:// และไม่มีเครื่องหมายทับ (/) ต่อท้าย
  5. เลือกเหตุการณ์ (events) ที่ต้องการสมัครรับ — ต้องมี events:subscribe ในรายการสิทธิ์
  6. บันทึกการตั้งค่า

เปิดใช้งานการแปลในแดชบอร์ดร้านค้า

  1. ไปที่หน้า ตั้งค่า (Settings) ของร้านค้าใน Xpress Tips
  2. เปิดใช้งาน การแปลภาษา (Translation)
  3. เลือกทิศทางการแปล: ภาษาใดก็ได้ → ไทย หรือ ไทย → อังกฤษ
  4. บันทึกการตั้งค่า
สิ่งสำคัญ: หากคุณเปิดใช้งาน Webhook หลังจาก ที่เชื่อมต่อ Kick ไว้แล้ว คุณจะต้องเชื่อมต่อ Kick ใหม่ (Unlink แล้ว Link อีกครั้ง) เพื่อให้สิทธิ์ events:subscribe มีผล มิฉะนั้นการแปลจะไม่ทำงาน

หากต้องการปิดการแปลภายหลัง

ปิดการแปลในหน้า ตั้งค่า ของร้านค้า จากนั้นลบ Webhook ในแอป Kick Developer หากไม่ต้องการรับ เหตุการณ์ เพิ่มเติมอีก

5. วิธีการทำงานสำหรับผู้ชมของคุณ

เมื่อตั้งค่าทุกอย่างเรียบร้อยแล้ว นี่คือประสบการณ์สำหรับผู้ชม:

  1. พวกเขาดูสตรีมของคุณ บน kick.com
  2. พวกเขาเห็นแผง "Tip Me" บนหน้าช่องของคุณ — หรือลิงก์ที่แชร์ในแชท
  3. พวกเขาคลิกลิงก์ — จะเปิดหน้าครีเอเตอร์ Xpress Tips ของคุณ
  4. พวกเขาเลือกจำนวนเงิน และเลือกว่าจะให้ทิปใคร (คุณ หรือพนักงานคนใดคนหนึ่งหากคุณมีพนักงานหลายคน)
  5. พวกเขาชำระเงิน ด้วยบัตร, Apple Pay หรือ Google Pay
  6. ทิปถูกบันทึก ในแดชบอร์ด Xpress Tips ของคุณ — และการแจ้งเตือนจะปรากฏในแชท Kick ของคุณแบบเรียลไทม์

ไม่ต้องดาวน์โหลดแอป ไม่ต้องสร้างบัญชี แค่ให้ทิปง่าย ๆ ในเวลาไม่ถึง 30 วินาที — พร้อมคำขอบคุณสาธารณะในแชทของคุณ

6. การแก้ไขปัญหา

ปัญหา วิธีแก้ไข
เกิดข้อผิดพลาด "Channel not found" ตรวจสอบการสะกดชื่อผู้ใช้ของคุณอีกครั้ง ต้องตรงกับที่ปรากฏใน URL Kick ของคุณ
ลิงก์แผงไม่ทำงาน ตรวจสอบว่าได้กรอก URL แบบเต็ม รวมถึง https://
หา Chatroom ID หรือ Broadcaster User ID ไม่เจอ ตรวจสอบว่าคุณใช้ URL แบบ v2: https://kick.com/api/v2/channels/[channel_name] API v1 แบบเก่าไม่มีให้ใช้แล้ว
กรอก ID แล้วแต่ Test Link ล้มเหลว ตรวจสอบว่าคุณกรอกเฉพาะตัวเลข (ไม่มีเครื่องหมายคำพูดหรือช่องว่าง) และตรวจสอบว่า ID มาจากช่องที่ถูกต้อง
การแจ้งเตือนในแชทไม่ปรากฏ คลิก Test Link บนหน้าแก้ไขร้านค้า หากข้อความทดสอบไม่ปรากฏ ให้คลิก Unlink Kick Account แล้ว Link Kick Account อีกครั้งเพื่ออนุญาตใหม่
การเชื่อมต่อ Kick หมดอายุ Access token ของ Kick จะรีเฟรชโดยอัตโนมัติ แต่หากการเชื่อมต่อกลายเป็น stale ให้คลิก Unlink Kick Account แล้ว Link Kick Account อีกครั้ง
เปิดใช้งานการแปลแล้ว แต่แชทไม่ถูกแปล ตรวจสอบว่าได้ตั้งค่า Webhook URL เป็น https://thai-venues.xpresstips.uk/kick/webhook ในแอป Kick Developer แล้ว และได้เชื่อมต่อ Kick ใหม่ (Unlink แล้ว Link) หลังจากเปิด Webhook เพื่อให้สิทธิ์ events:subscribe มีผล
หน้าอนุมัติแสดงบัญชีผิด ตรวจสอบว่าคุณเข้าสู่ระบบด้วยบัญชี Kick ที่ถูกต้องก่อนคลิก Link Kick Account หากไม่ใช่ ให้ออกจากระบบ Kick ก่อน แล้วลองอีกครั้ง
เกิดข้อผิดพลาด "Redirect URI mismatch" หรือ "Invalid redirect" หลังอนุมัติบน Kick Redirect URL ในแอป Kick Developer ต้องตรงกับ https://thai-venues.xpresstips.uk/admin/kick/callback ทุกตัวอักษร ตรวจสอบเครื่องหมายทับต่อท้าย การพิมพ์ผิด หรือ http:// แทน https:// แก้ไขแอปที่ ตั้งค่า → Developer แล้วลองเชื่อมต่ออีกครั้ง
ผู้ชมไม่เห็นแผง ตรวจสอบว่าแผงตั้งค่าเป็นมองเห็นได้ (ไม่ซ่อน) ในการตั้งค่าช่อง Kick ของคุณ

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

ต้องมีบัญชีนักพัฒนา Kick ไหม?

ใช่ สำหรับการเชื่อมต่อ OAuth กับ Xpress Tips คุณต้องสร้างแอป developer บน Kick เพื่อสร้าง Client ID และ Client Secret อย่างไรก็ตาม คุณไม่ต้องเขียนหรือดูแลโค้ดใด ๆ ด้วยตัวเอง — Xpress Tips จัดการส่วนเทคนิคให้ คุณเพียงสร้างแอปและให้ข้อมูลรับรอง (credentials) เท่านั้น

เชื่อมต่อหลายช่อง Kick กับร้านค้าเดียวได้ไหม?

ปัจจุบันแต่ละร้านค้ารองรับช่อง Kick หนึ่งช่อง หากคุณมีหลายช่อง คุณจะต้องมีร้านค้าแยกกัน

จะเกิดอะไรขึ้นถ้าฉันเปลี่ยนชื่อผู้ใช้ Kick?

คุณจะต้องเชื่อมต่อ Kick ใหม่บนหน้าแก้ไขร้านค้า ลิงก์แผงทิปเก่าของคุณจะใช้ไม่ได้ ดังนั้นอย่าลืมอัปเดตบน Kick ด้วย และคุณจะต้องค้นหา Chatroom ID และ Broadcaster User ID ใหม่ เนื่องจากค่าเหล่านี้เปลี่ยนตามชื่อช่องของคุณ

มีค่าธรรมเนียมสำหรับการเชื่อมต่อ Kick ไหม?

ไม่มี การเชื่อมต่อ Kick รวมอยู่ในค่าธรรมเนียมแพลตฟอร์ม Xpress Tips มาตรฐานของคุณ (คงที่ 15% ของทิปที่เก็บได้) ไม่มีค่าใช้จ่ายเพิ่มเติม

ใช้ได้บนมือถือไหม?

ได้ แผงทิปของคุณปรากฏบนแอปมือถือ Kick และเวอร์ชันเว็บสำหรับมือถือ ผู้ชมสามารถแตะเพื่อเปิดหน้า Xpress Tips ของคุณในเบราว์เซอร์มือถือได้

ปิดการแจ้งเตือนในแชทได้ไหม?

ได้ คลิก Unlink Kick Account บนหน้าแก้ไขร้านค้า แผงทิปบนช่อง Kick ของคุณจะยังทำงานอยู่ แต่ Xpress Tips จะไม่โพสต์อะไรในแชทของคุณ

การแปลภาษาทำงานอย่างไร?

เมื่อเปิดใช้งาน Xpress Tips จะรับเหตุการณ์แชทจาก Kick ผ่าน Webhook และแปลข้อความตามทิศทางที่คุณเลือก (ภาษาใดก็ได้ → ไทย หรือ ไทย → อังกฤษ) ฟีเจอร์นี้ต้องใช้สิทธิ์ events:subscribe จาก Kick และต้องตั้งค่า Webhook ในแอป Kick Developer ของคุณ

เปิดการแปลหลังจากเชื่อมต่อ Kick แล้ว ต้องทำอะไรเพิ่ม?

ใช่ คุณต้องเชื่อมต่อ Kick ใหม่ — คลิก Unlink Kick Account แล้ว Link Kick Account อีกครั้ง เนื่องจากสิทธิ์ events:subscribe จะมีผลก็ต่อเมื่อเชื่อมต่อใหม่หลังจากการตั้งค่า Webhook เสร็จสิ้น

การแจ้งเตือนในแชทมีหน้าตาอย่างไร?

ข้อความสั้น ๆ เช่น: "🎉 SupporterName เพิ่งให้ทิป ฿100 แก่ StaffName ผ่าน Xpress Tips!" — โพสต์โดย Xpress Tips ในนามของคุณ

ทำไม Xpress Tips ต้องได้รับสิทธิ์ในการโพสต์ในแชทของฉัน?

เพราะไม่มีวิธีอื่นในการส่งการแจ้งเตือน API ของ Kick ต้องการสิทธิ์ chat:write เพื่อโพสต์ข้อความใด ๆ ในนามของคุณ หากไม่มี การเชื่อมต่อนี้จะทำงานไม่ได้

ทำไมต้องค้นหา ID ด้วยตัวเอง?

Kick ไม่เปิดเผย Chatroom ID หรือ Broadcaster User ID ในแดชบอร์ดของพวกเขา เข้าถึงได้ผ่าน endpoint JSON สาธารณะเท่านั้น ใช้เวลาประมาณ 30 วินาทีในการค้นหา

8. ข้อมูลอ้างอิงด่วน

Kick Creator Dashboard kick.com → รูปโปรไฟล์ → Creator Dashboard
เปิดใช้งาน 2FA kick.com → รูปโปรไฟล์ → Settings → Security
สร้าง Developer App kick.com → รูปโปรไฟล์ → Settings → Developer
Redirect URL (แอป Kick) https://thai-venues.xpresstips.uk/admin/kick/callback
Webhook URL (แอป Kick) https://thai-venues.xpresstips.uk/kick/webhook
แก้ไขแผงช่อง หน้าช่อง → แท็บ About → Edit Panels
Channel JSON (สำหรับ ID) https://kick.com/api/v2/channels/[channel_name]
แก้ไขร้านค้า Xpress Tips thai-venues.xpresstips.uk/admin/groups/edit/[id]
เชื่อมต่อบัญชี Kick หน้าแก้ไขร้านค้า → Kick Settings → Link Kick Account
ทดสอบการเชื่อมต่อ หน้าแก้ไขร้านค้า → Kick Settings → Test Link
ยกเลิกการเชื่อมต่อ หน้าแก้ไขร้านค้า → Kick Settings → Unlink Kick Account
URL หน้าให้ทิป https://thai-venues.xpresstips.uk/creator/[username]

อัปเดตล่าสุด: ตุลาคม 2569 คู่มือนี้สามารถเปลี่ยนแปลงได้เมื่อ Kick และ Xpress Tips มีการพัฒนาเพิ่มเติม

พร้อมที่จะเชื่อมต่อช่อง Kick ของคุณหรือยัง?

ตั้งค่า Xpress Tips ในเวลาไม่ถึง 15 นาที ไม่มีค่าบริการรายเดือน ค่าธรรมเนียมแพลตฟอร์ม 15% ออกใบแจ้งหนี้รายสัปดาห์ผ่าน Stripe

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