Webhook ความคิดเห็น TikTok ไม่มา? ตรวจการ polling และเส้นทางส่ง
การสมัคร post.comment.created ใน UnifyPort ไม่ได้เปิดการ polling ความคิดเห็น TikTok โดยอัตโนมัติ ค่าเริ่มต้นคือปิด ต้องตั้ง provider_data.enable_comment เป็นบูลีน true แล้วใช้การเริ่มทำงานหรือเชื่อมต่อใหม่เพื่อนำค่าไปใช้ หากเปลี่ยนขณะบัญชีออนไลน์ต้องเชื่อมต่อใหม่ ตรวจ endpoint รับข้อมูลแยกต่างหากด้วย การเริ่มสำเร็จไม่ใช่หลักฐานว่าใช้ค่าการ polling แล้ว และไม่มี webhook ก็ไม่ได้แปลว่าไม่มีคนแสดงความคิดเห็น
ประเด็นสำคัญ
- แยกการค้นพบความคิดเห็น การใช้ค่ากับการเชื่อมต่อ เส้นทางส่ง และการประมวลผลในแอป
- ยืนยันว่าสภาพแวดล้อมรองรับและเตรียมตัวรับให้พร้อมก่อนเปิด
- การตั้งค่า webhook เฉพาะบัญชีมีลำดับความสำคัญเหนือ workspace และไม่ย้อนกลับไปใช้ workspace เมื่อปิดหรือสมัครเหตุการณ์ไม่ตรง
- การแจ้งเตือนเป็นแบบ best-effort ไม่ใช่ประวัติครบถ้วนหรือสิทธิให้ตอบอัตโนมัติ
เริ่มจากระบุว่ากำลังตั้งค่า webhook ของระบบใด
รายการ webhook ทางการของ TikTok กำหนดชื่อเหตุการณ์และโครงสร้างคำขอของตนเอง ส่วน เอกสาร post.comment.created ของ UnifyPort เป็นอีกสัญญาหนึ่ง: แจ้งเตือนความคิดเห็น TikTok ในรูปแบบมาตรฐานหลังการระบุข้อมูลและตรวจว่าเป็นโพสต์ของบัญชีเอง
การกรอกชื่อเหตุการณ์ UnifyPort ใน TikTok Developer Portal ไม่ได้ตั้งค่า UnifyPort ให้คุณ แยกตัวรับทางการของ TikTok ออกจากอินเทอร์เฟซที่ไม่เป็นทางการสำหรับเชื่อมบัญชีเดิม คู่มือนี้กล่าวถึงแบบหลัง ไม่ใช่ข้อความบริการลูกค้า TikTok Shop หรือ DM
หากยังไม่เชื่อมบัญชีรับส่งข้อความ ให้ทำตาม ขั้นตอนยืนยันตัวตน TikTok ด้วย QR ก่อน การยืนยันตัวตนและการเชื่อมต่อที่ทำงานอยู่เป็นเงื่อนไขตั้งต้น ไม่ใช่หลักฐานว่าเปิด polling ความคิดเห็นแล้ว
ตรวจสี่ขอบเขตตามลำดับ
| ขอบเขต | หลักฐานที่ต้องตรวจ | สิ่งที่ยังสรุปไม่ได้ |
|---|---|---|
| การค้นพบ | สภาพแวดล้อมรองรับและตั้งใจเปิด polling แล้ว | จะพบความคิดเห็นเก่าทั้งหมด |
| การเชื่อมต่อ | เปลี่ยนค่าแล้วเริ่มหรือเชื่อมต่อใหม่ตามที่กำหนด | เริ่มสำเร็จหมายถึงใช้ค่าการ polling แล้ว |
| เส้นทางส่ง | ขอบเขต endpoint ถูกต้อง เปิดใช้งาน และสมัครตรง | ต้นทางสร้างเหตุการณ์แล้ว |
| การประมวลผล | ตรวจสอบเหตุการณ์ บันทึกถาวร และประมวลผลแล้ว | ทุกความคิดเห็นมาถึง หรือคำตอบแสดงต่อสาธารณะแล้ว |
ลำดับนี้ช่วยไม่ให้เปลี่ยนคีย์ลายเซ็นเพื่อแก้ polling ที่ยังปิดอยู่ หรือเชื่อมต่อซ้ำเพื่อแก้ตัวกรองเหตุการณ์
1. ตรวจค่าจริง ไม่ใช่แค่ช่องเลือกในหน้าจอ
เอกสารอัปเดตบัญชี ระบุว่า provider_data.enable_comment รับเฉพาะบูลีน true และ false ใช้ได้ แต่สตริง ตัวเลข และ null จะได้ 400 invalid_request เก็บค่าที่ต้องการและผล API จริงไว้ในกระบวนการจัดการค่าที่มีการป้องกัน
ระวัง provider_data: การไม่ส่งคงค่าเดิม ส่วน {} ล้างค่า อย่าสมมติว่าการส่งเพียงบางฟิลด์ภายในจะรวมกับการตั้งค่าที่มีอยู่ทั้งหมด เตรียมค่าจากแหล่งกำหนดค่าที่ควบคุมไว้ รักษาค่าที่จำเป็น และไม่บันทึกข้อมูลลับลง log ผลการอ่านที่ละข้อมูลอ่อนไหวไว้ไม่ใช่สำเนาสำรองครบชุด
สำหรับบัญชีออนไลน์ ให้จัด การเชื่อมต่อ runtime ใหม่ อย่างตั้งใจหนึ่งครั้งหลังอัปเดต หากยืนยันตัวตนแล้วแต่หยุดทำงาน ให้ใช้ขั้นตอนเริ่มตามเอกสารเมื่อเหมาะสม ประสานกับ worker กู้คืนอัตโนมัติเพื่อไม่ให้สั่งงานแข่งกัน สัญญาสาธารณะไม่ได้กำหนดว่าการเริ่มสำเร็จเท่ากับ “ตรวจสอบ polling ความคิดเห็นแล้ว”
2. หา endpoint ที่ควบคุมบัญชีนี้จริง
ใช้ รายการ webhook endpoints ตรวจทั้งระดับ workspace และบัญชี การเรียกโดยไม่ส่ง account_id คืน endpoint ของ workspace; เมื่อส่งจะคืนเฉพาะการตั้งค่าอิสระของบัญชีนั้น ไม่รวมค่าที่สืบทอดจาก workspace
เอกสารตั้งค่า endpoint ระบุว่าค่าระดับบัญชีมีผลเหนือ workspace หาก endpoint อิสระปิดอยู่หรือสมัครไม่ตรง ก็จะไม่กลับไปใช้ workspace ดังนั้นตัวรับของ workspace ที่ปกติไม่ได้พิสูจน์เส้นทางของบัญชีนี้
ตรวจสถานะและรายการสมัครของ endpoint ที่มีผล ใส่ post.comment.created โดยตรง หรือใช้การเลือกรวมที่เอกสารรองรับ เช่น ["*"] รักษาการสมัครข้อความและเหตุการณ์ยืนยันตัวตนที่ยังจำเป็นไว้ คู่มือตัวกรองเหตุการณ์ อธิบายการเลือกสิ่งที่จะส่ง ไม่ใช่การเริ่ม polling ที่ต้นทาง
อย่าลบ endpoint อิสระเพื่อทดลองวินิจฉัย เมื่อการตั้งค่าอิสระรายการสุดท้ายถูกลบ การส่งครั้งแรกของเหตุการณ์ถัดไปจะกลับไปสืบทอด workspace และเปลี่ยนปลายทางในอนาคต ควรทบทวนการเปลี่ยนเส้นทางนี้โดยตั้งใจ
3. ตรวจการรับโดยไม่เดาฟิลด์ความคิดเห็น
ทำตาม สัญญาการส่งของ UnifyPort: เมื่อเปิดลายเซ็น ให้ตรวจ X-Device-Signature ด้วย HMAC-SHA256 ของ X-Device-Timestamp ตามด้วยจุดและ raw body พร้อมตรวจความสดของเวลา บันทึกเหตุการณ์ที่ตรวจแล้วแบบถาวรก่อนตอบ 2xx และตัดซ้ำเหตุการณ์ชนิดนี้ด้วย id ภายใน workspace
เอกสารยืนยัน envelope กลาง ได้แก่ id, type, provider, account_id, occurred_at และ data แต่ระบุว่าเอกสารฟิลด์ละเอียดและตัวอย่างที่จับได้จริงยังอยู่ระหว่างเตรียม อย่าสร้าง parser ใช้งานจริงจากเส้นทางที่เดา เช่น data.comment หรือแต่งตัวอย่างแล้วถือว่าเป็น payload ทางการ เก็บ envelope ที่ตรวจแล้วเพื่อตรวจในพื้นที่ควบคุม และยืนยันสัญญาข้อมูลจริงก่อนเปิดระบบอัตโนมัติที่อาศัยฟิลด์ภายใน
ใช้การทดสอบควบคุม ไม่ใช่วงจรเชื่อมต่อใหม่
ต่อไปนี้เป็นข้อเสนอสำหรับวินิจฉัย ไม่ใช่ผลทดสอบที่ดำเนินการแล้ว:
- ยืนยันความพร้อมของฟีเจอร์ในสภาพแวดล้อมเป้าหมาย และเลือกโพสต์ของบัญชีเอง
- ปิดการตอบอัตโนมัติไว้ เตรียมตัวรับพร้อมลายเซ็นและการสมัครที่ถูกต้อง
- ใช้ค่าบูลีนและดำเนินการเชื่อมต่อที่จำเป็นหนึ่งครั้ง
- ให้ผู้ทดสอบที่ได้รับอนุญาตเพิ่มความคิดเห็นที่แยกแยะได้ และเก็บการอ้างอิงต้นฉบับอย่างปลอดภัย
- ติดตามการมาถึง การตรวจลายเซ็น การบันทึกถาวร การตัดซ้ำ และ worker แยกกัน
ถ้าไม่พบสัญญาณ ให้เก็บรหัสบัญชีและ endpoint ที่ปกปิดส่วนอ่อนไหว ผลตั้งค่าและการสั่งงาน เวลา และ request ID ที่มีไว้ตรวจต่อ อย่ารับรองเวลาที่ต้องมาถึง เพราะเหตุการณ์อาจช้า ซ้ำ สลับลำดับ หรือหายไปได้ การทดสอบสำเร็จครั้งเดียวพิสูจน์เพียงเส้นทางของครั้งนั้น ไม่ใช่ความครอบคลุมทั้งหมด
ปิด polling ไม่ได้เรียกคืนเหตุการณ์ในคิว
หากต้องหยุดการกระทำทางธุรกิจทันที ให้พัก worker ที่ดำเนินการกับความคิดเห็นในแอปก่อน แล้วตั้ง enable_comment: false และเชื่อมต่อใหม่ตามข้อกำหนดสำหรับบัญชีออนไลน์ ยังคงรับรายการที่เข้าคิวแล้วอย่างปลอดภัยตามนโยบายเก็บข้อมูล เอกสารระบุชัดว่าการปิดไม่ได้เรียกคืนรายการเหล่านี้
การพัก worker เป็นมาตรการของแอป ไม่ใช่ฟิลด์ API ใหม่ แยกการประมวลผล DM ที่ยังต้องทำงานต่อ และอย่าสรุปว่าตั้งค่าล้มเหลวเพียงเพราะมีเหตุการณ์มาหลังปิด
เมื่อต้องการเปิดตอบในภายหลัง ให้ใช้ ขั้นตอนตอบความคิดเห็นระดับบนสุด แยกต่างหาก การไม่มี parent_comment_id ไม่ยืนยันว่าเป็นเป้าหมายระดับบนสุดที่ตอบได้ และการแจ้งเตือนไม่ใช่ใบรับรองคำตอบก่อนหน้า
คำถามที่พบบ่อย
สมัคร post.comment.created แล้ว polling จะเริ่มไหม?
ไม่เริ่ม ตัวกรอง webhook กับ provider_data.enable_comment เป็นคนละส่วน และต้องใช้ค่ากับการเชื่อมต่อด้วย
running หมายถึงระบบติดตามความคิดเห็นทำงานแล้วหรือไม่?
ไม่ใช่ เป็นสถานะการเชื่อมต่อ ต้องยืนยันค่าตั้ง เส้นทาง และการสังเกตแบบควบคุมแยกกัน
ไม่มีเหตุการณ์แปลว่าไม่มีความคิดเห็นใหม่หรือไม่?
ไม่ใช่ การแจ้งเตือนอาจตกหล่น อย่าแสดงความเงียบเป็นจำนวนหรือประวัติที่ครบถ้วน
ใช้เหตุการณ์นี้กระตุ้นการตอบ DM อัตโนมัติได้ไหม?
ไม่ได้ นี่คือแจ้งเตือนความคิดเห็น ไม่ใช่ message.received ตรวจโพสต์และความคิดเห็นก่อนดำเนินการตอบสาธารณะแยกต่างหาก
ขั้นตอนถัดไปและแหล่งข้อมูล
เริ่มที่ เอกสาร post.comment.created แล้วบันทึกว่าขอบเขตใดยังไม่ยืนยัน ก่อนเปลี่ยนค่าระบบจริง
ตรวจเอกสารทางการเมื่อ 2026-11-14:
เปลี่ยนการเชื่อมต่อข้อความให้เป็น pipeline ผลิตภัณฑ์ที่เสถียร
เริ่มจากการส่งผ่าน API เดียว แล้วส่งข้อความขาเข้าทั้งหมดกลับสู่ระบบธุรกิจของคุณด้วย event มาตรฐาน