คู่มือการตั้งค่า Kick
วิธีตั้งค่าช่อง Kick ของคุณและเชื่อมต่อกับหน้าให้ทิปของคุณบนหน้าแก้ไขร้านค้า — รวมถึงการแจ้งเตือนแบบสดในแชทเมื่อมีทิปเข้ามา
หมายเหตุ: Kick ไม่มีระบบการให้ทิปในตัว นั่นคือเหตุผลที่ Xpress Tips มีอยู่ — เพื่อเติมเต็มช่องว่างนั้น และมอบวิธีง่าย ๆ ให้ผู้ชมของคุณสนับสนุนคุณขณะที่คุณกำลังไลฟ์
1. สร้างแอป Kick Developer
ก่อนที่คุณจะเชื่อมต่อช่องของคุณกับ Xpress Tips ได้ คุณต้องสร้างแอป developer บน Kick ก่อน แอปนี้จะสร้าง Client ID และ Client Secret ที่ Xpress Tips ใช้ตรวจสอบสิทธิ์กับ Kick ในนามของคุณ
เปิดใช้งาน 2FA ก่อน
- เข้าสู่ระบบที่ kick.com
- คลิก รูปโปรไฟล์ ของคุณ (มุมขวาบน) → Settings
- ไปที่แท็บ Security และเปิดใช้งาน การยืนยันตัวตนสองขั้นตอน (2FA)
สร้างแอปของคุณ
- เมื่อเปิด 2FA แล้ว ให้ไปที่ Settings → Developer (หรือเข้าที่ kick.com/settings/developer โดยตรง)
- คลิก Create New หรือ Create App
- กรอกรายละเอียดตามที่ระบบร้องขอ คุณจะถูกขอให้ระบุ Redirect URL ซึ่งเป็น URL ที่ Kick จะส่งคุณกลับมาหลังจากอนุญาตแอปแล้ว ให้กรอกตามนี้ทุกตัวอักษร:
https://thai-venues.xpresstips.uk/admin/kick/callback
คัดลอกให้แม่นยำ รวมถึงhttps://และไม่มีเครื่องหมายทับ (/) ต่อท้าย หาก Redirect URL ไม่ถูกต้อง การเชื่อมต่อจะล้มเหลว - บันทึกแอป
- คุณจะเห็น Client ID และ Client Secret คัดลอกทั้งสองค่าทันทีและเก็บไว้อย่างปลอดภัย ห้ามเปิดเผย Client Secret ให้ผู้อื่น
เมื่อคุณมี 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 — โพสต์การแจ้งเตือนทิปในแชทของคุณในนามของคุณ
วิธีเชื่อมต่อบัญชีของคุณ
- เข้าสู่ระบบที่ thai-venues.xpresstips.uk ในฐานะผู้ดูแล
- ไปที่ Dashboard → Venues และคลิก Edit ข้างร้านค้าที่คุณต้องการเชื่อมต่อ
- เปิดหน้า ตั้งค่า (Settings) ของร้านค้า หรือไปที่ ตั้งค่า → Kick Settings จากแดชบอร์ดร้านค้าของคุณ
- วาง Client ID และ Client Secret จากแอป Kick Developer ของคุณลงในช่องที่ตรงกัน
- บันทึกการตั้งค่า จากนั้นคลิก Link Kick Account
- คุณจะถูกนำไปยังหน้าอนุมัติของ Kick ซึ่งแสดงสิทธิ์ที่ Xpress Tips ร้องขอ (
chat:write) - อนุมัติสิทธิ์ Kick จะส่งคุณกลับมายัง Xpress Tips พร้อม token ที่ปลอดภัย
- 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
สิ่งที่ต้องมองหา
เมื่อหน้าโหลดแล้ว ใช้ Ctrl+F (หรือ Cmd+F บน Mac) เพื่อค้นหาค่าสองค่าต่อไปนี้:
-
Chatroom ID — ค้นหา
"chatroom"คุณจะเห็นอะไรทำนองนี้:
"chatroom":{"id":12345678, ...}
ตัวเลขหลัง"id":คือ Chatroom ID ของคุณ -
Broadcaster User ID — ค้นหา
"broadcaster_user_id"คุณจะเห็นอะไรทำนองนี้:
"broadcaster_user_id":987654
ตัวเลขหลังเครื่องหมายทวิภาคคือ Broadcaster User ID ของคุณ
ทางเลือก: ใช้เครื่องมือสำหรับนักพัฒนาในเบราว์เซอร์
หากหน้า JSON อ่านยาก คุณสามารถค้นหา Chatroom ID ได้โดยใช้เครื่องมือสำหรับนักพัฒนาในเบราว์เซอร์:
- เปิดหน้าช่อง Kick ของคุณ
- กด F12 เพื่อเปิด Developer Tools
- ไปที่แท็บ Network และรีเฟรชหน้า
- ในช่องตัวกรอง พิมพ์
chatroom - คลิกที่คำขอที่ปรากฏ
- Chatroom ID จะมองเห็นได้ในการตอบกลับ
กรอกที่ไหน
บนหน้า แก้ไขร้านค้า ใน Xpress Tips ในส่วน Kick Settings ให้วาง ID ทั้งสองในช่องที่ตรงกัน จากนั้นคลิก Test Link เพื่อยืนยันว่าทุกอย่างทำงานได้
4. เปิดใช้งานการแปลภาษา (ไม่บังคับ)
ร้านค้าบนแพลตฟอร์มไทยสามารถเปิดใช้งานการแปลภาษาในแชทได้ — รองรับการแปลจากภาษาใดก็ได้เป็นภาษาไทย และจากภาษาไทยเป็นภาษาอังกฤษ เหมาะสำหรับร้านค้าในพื้นที่ท่องเที่ยวที่มีผู้ชมทั้งชาวไทยและต่างชาติ
events:subscribe) ซึ่งจะขอเมื่อคุณเปิดใช้งานการแปลในแดชบอร์ดร้านค้า และต้องตั้งค่า Webhook ในแอป Kick Developer ของคุณก่อน
สิ่งที่ต้องตั้งค่าในแอป Kick Developer
- กลับไปที่ Settings → Developer บน Kick (หรือ kick.com/settings/developer)
- เปิดแอปที่คุณสร้างไว้ในขั้นตอนที่ 1
- เปิดใช้งาน Webhook (หรือ "Webhooks")
- กรอก Webhook URL ตามนี้ทุกตัวอักษร:
https://thai-venues.xpresstips.uk/kick/webhook
คัดลอกให้แม่นยำ รวมถึงhttps://และไม่มีเครื่องหมายทับ (/) ต่อท้าย - เลือกเหตุการณ์ (events) ที่ต้องการสมัครรับ — ต้องมี
events:subscribeในรายการสิทธิ์ - บันทึกการตั้งค่า
เปิดใช้งานการแปลในแดชบอร์ดร้านค้า
- ไปที่หน้า ตั้งค่า (Settings) ของร้านค้าใน Xpress Tips
- เปิดใช้งาน การแปลภาษา (Translation)
- เลือกทิศทางการแปล: ภาษาใดก็ได้ → ไทย หรือ ไทย → อังกฤษ
- บันทึกการตั้งค่า
events:subscribe มีผล มิฉะนั้นการแปลจะไม่ทำงาน
หากต้องการปิดการแปลภายหลัง
ปิดการแปลในหน้า ตั้งค่า ของร้านค้า จากนั้นลบ Webhook ในแอป Kick Developer หากไม่ต้องการรับ เหตุการณ์ เพิ่มเติมอีก
5. วิธีการทำงานสำหรับผู้ชมของคุณ
เมื่อตั้งค่าทุกอย่างเรียบร้อยแล้ว นี่คือประสบการณ์สำหรับผู้ชม:
- พวกเขาดูสตรีมของคุณ บน kick.com
- พวกเขาเห็นแผง "Tip Me" บนหน้าช่องของคุณ — หรือลิงก์ที่แชร์ในแชท
- พวกเขาคลิกลิงก์ — จะเปิดหน้าครีเอเตอร์ Xpress Tips ของคุณ
- พวกเขาเลือกจำนวนเงิน และเลือกว่าจะให้ทิปใคร (คุณ หรือพนักงานคนใดคนหนึ่งหากคุณมีพนักงานหลายคน)
- พวกเขาชำระเงิน ด้วยบัตร, Apple Pay หรือ Google Pay
- ทิปถูกบันทึก ในแดชบอร์ด 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 มีการพัฒนาเพิ่มเติม
