Webhook ระดับบัญชีของ UnifyPort: ทำไมเวิร์กสเปซไม่ได้รับบางเหตุการณ์
หาก Webhook ของเวิร์กสเปซ UnifyPort รับเหตุการณ์จากบัญชีรับส่งข้อความอื่นได้ แต่รับจากบางบัญชีไม่ได้ ให้ตรวจการตั้งค่า Webhook เฉพาะบัญชีนั้นก่อน การตั้งค่าระดับบัญชีมีผลแทนการตั้งค่าระดับเวิร์กสเปซ แม้ endpoint เฉพาะบัญชีจะเป็น inactive หรือไม่ได้สมัครรับเหตุการณ์นั้น ระบบก็ไม่ส่งต่อไปยังเวิร์กสเปซโดยอัตโนมัติ การลบ endpoint เฉพาะบัญชีตัวสุดท้ายจะคืนการสืบทอดสำหรับการส่งครั้งแรกของเหตุการณ์หลังจากนั้น ไม่ใช่การส่งเหตุการณ์เก่าย้อนหลัง
ประเด็นสำคัญ
- Endpoint ระดับเวิร์กสเปซและระดับบัญชีเป็นคนละขอบเขต ไม่ใช่ระบบหลักกับระบบสำรอง
- ต้องอ่านรายการทั้งสองขอบเขต การไม่ระบุบัญชีจะแสดงเฉพาะ endpoint ระดับเวิร์กสเปซ
- รายการระดับบัญชีที่ว่างหมายถึงไม่มีการตั้งค่าเฉพาะ ไม่ได้หมายถึงไม่มีเส้นทางรับเหตุการณ์
- การปิดใช้งานยังคงการตั้งค่าเฉพาะไว้ ต้องลบตัวสุดท้ายจึงจะคืนการสืบทอด
- ตรวจเส้นทาง การสมัครรับเหตุการณ์ ลายเซ็น และสถานะการเชื่อมต่อแยกกัน
การตั้งค่าใดกำหนดปลายทางของเหตุการณ์
เอกสารสร้าง Webhook endpoint ระบุฟิลด์ account_id แบบไม่บังคับใน body หากส่งฟิลด์นี้ endpoint ใหม่จะผูกกับบัญชีรับส่งข้อความนั้น หากไม่ส่งจะเป็น endpoint ระดับเวิร์กสเปซ ในผลตอบกลับ endpoint เฉพาะบัญชีมี account_id ส่วน endpoint ของเวิร์กสเปซจะไม่มีฟิลด์นี้
| การตั้งค่าเฉพาะบัญชี | การสืบทอดจากเวิร์กสเปซ | สิ่งที่ต้องตรวจ |
|---|---|---|
| ไม่มี endpoint เฉพาะ | ใช้งาน | สถานะและ subscriptions ของเวิร์กสเปซ |
| มี endpoint active และสมัครรับเหตุการณ์ตรงกัน | ใช้การตั้งค่าบัญชีแทน | ตัวรับและการตั้งค่าลายเซ็นของบัญชี |
| มี endpoint เฉพาะแต่ทั้งหมด inactive | ไม่กลับไปใช้เวิร์กสเปซอัตโนมัติ | ยังต้องการการตั้งค่าเฉพาะหรือไม่ |
| Endpoint active ไม่ได้สมัครรับเหตุการณ์เป้าหมาย | ไม่กลับไปใช้เวิร์กสเปซอัตโนมัติ | Subscriptions ของบัญชี |
| ลบ endpoint เฉพาะตัวสุดท้ายแล้ว | คืนการสืบทอดสำหรับการส่งครั้งแรกหลังจากนั้น | ความพร้อมของเวิร์กสเปซและเหตุการณ์ทดสอบใหม่ |
สมมติว่าเวิร์กสเปซสมัครรับ message.received แต่ endpoint เฉพาะของบัญชี LINE สมัครรับเพียง account.status.updated นี่เป็นตัวอย่างสมมติ ไม่ใช่รายงานเหตุขัดข้อง การสมัครรับของเวิร์กสเปซจะไม่เติมเหตุการณ์ข้อความที่ขาดจากตัวกรองระดับบัญชี ต้องแก้การตั้งค่าบัญชีหรือตัดสินใจคืนการสืบทอดอย่างชัดเจน
คู่มือตัวกรองเหตุการณ์ อธิบายว่าควรเลือกชื่อเหตุการณ์ใด แต่คำถามที่ต้องตอบก่อนคือ ขอบเขตใดรับผิดชอบการส่งเหตุการณ์ของบัญชีนี้
ตรวจทั้งสองขอบเขตด้วยคำขออ่านข้อมูลสองครั้ง
ใช้ X-Api-Key ฝั่งเซิร์ฟเวอร์ตัวเดียวกัน เพราะคีย์เป็นตัวกำหนดเวิร์กสเปซ ตัวอย่างต่อไปนี้แสดงเฉพาะ path ให้แทน acc_example ด้วย ID สาธารณะจริงที่ได้จากการอ่านบัญชี:
GET /v1/webhook-endpoints
GET /v1/webhook-endpoints?account_id=acc_example
ตามเอกสารรายการ Webhook endpoints คำขอแรกคืนเฉพาะ endpoint ระดับเวิร์กสเปซ คำขอที่สองคืนเฉพาะการตั้งค่าอิสระของบัญชี ไม่รวม endpoint ของเวิร์กสเปซที่สืบทอดมา ดังนั้น data: [] ในผลตอบกลับที่สำเร็จของคำขอที่สองจึงหมายถึงไม่มี endpoint เฉพาะบัญชี ไม่ใช่ไม่มีเส้นทาง Webhook
บันทึก ID ของ endpoint การผูกบัญชี URL, status, subscribed_events, signing_enabled และนโยบาย retry ตรวจรายการ inactive ด้วย เพราะยังมีผลต่อการสืบทอด อย่าเก็บคีย์ลับหรือเนื้อหาข้อความในบันทึกวิเคราะห์
ชื่อพารามิเตอร์ต้องเป็น account_id ตรงตัว ค่าว่าง ช่องว่างล้วน พารามิเตอร์ซ้ำ หรือชื่อที่เปลี่ยนตัวพิมพ์ใหญ่เล็กไม่เท่ากับการละพารามิเตอร์ หากบัญชีที่ระบุไม่มีอยู่หรืออยู่นอกเวิร์กสเปซ จะได้ 404 account_not_found ให้แก้ ID และเวิร์กสเปซ อย่าตีความเป็นรายการว่าง
หากการตั้งค่าทั้งสองถูกต้อง ให้ตรวจสถานะ authorization และ runtime แยกกัน แล้วติดตามเหตุการณ์ใหม่ที่รองรับตั้งแต่การยืนยันตัวรับไปจนถึงการจัดเก็บถาวร อย่ารีสตาร์ตบัญชีที่ทำงานปกติเพียงเพราะตรวจ URL ผิดแล้วไม่พบทราฟฟิก
เลือกซ่อมการตั้งค่าเฉพาะหรือคืนการสืบทอด
คงตัวรับเฉพาะบัญชีไว้
ใช้อัปเดต Webhook endpoint เพื่อแก้ URL สถานะ active หรือ subscriptions ของ endpoint เดิม รักษาการตั้งค่าลายเซ็นและ retry ที่ตรวจสอบแล้ว ค่า signing_secret ว่างจะปิดการลงลายเซ็น อย่าคัดลอกตัวอย่างที่ไม่ลงลายเซ็นไปใช้ในระบบจริง
หากบัญชีเดียวกันมี endpoint เฉพาะที่ active อยู่แล้ว การสร้างอีกตัวเป็น active อาจคืน 409 account_webhook_already_exists พร้อมรหัสตัวเลข 40008 การเปลี่ยนอีกตัวจาก inactive เป็น active ก็ใช้กฎนี้ แต่การอัปเดต endpoint ที่ active อยู่โดยคง active ไว้ทำได้ รวมถึงการตั้งค่าเก่าที่มีหลายตัว active ระบบไม่ได้ล้างรายการเก่าเหล่านั้นให้อัตโนมัติ กฎจำนวน active นี้ไม่จำกัด endpoint ระดับเวิร์กสเปซ
ไม่สามารถเปลี่ยนการผูกบัญชีได้ account_id ในคำขออัปเดตมีไว้ตรวจเจ้าของเดิมเท่านั้น หากละไว้จะคงเจ้าของเดิม การละฟิลด์หรือส่ง null ไม่ได้แปลง endpoint ระดับบัญชีเป็นระดับเวิร์กสเปซ และไม่สามารถนำ endpoint ของเวิร์กสเปซเดิมไปผูกกับบัญชีได้
กลับไปใช้ตัวรับของเวิร์กสเปซ
ตรวจว่าตัวรับของเวิร์กสเปซ active สมัครรับเหตุการณ์ที่ต้องการ และพร้อมตรวจลายเซ็นกับจัดเก็บถาวรแล้ว ทบทวนผลกระทบร่วมกับผู้ดูแลเวิร์กโฟลว์เฉพาะบัญชี
จากนั้นใช้ลบ Webhook endpoint เพื่อยกเลิกการตั้งค่าเฉพาะโดยตั้งใจ ตรวจทุกรายการ เพราะการเหลือ endpoint inactive ไว้ยังทำให้มีการตั้งค่าระดับบัญชี อ่านรายการระดับบัญชีอีกครั้งเพื่อยืนยันว่าไม่เหลือ endpoint เฉพาะ การลบสำเร็จคืน 204 โดยไม่มี body
นี่คือการเปลี่ยนเส้นทาง ไม่ใช่คำแนะนำทั่วไปสำหรับงานบำรุงรักษา หากเพียงต้องการพัก CRM หรือ AI ชั่วคราว บทเปรียบเทียบการพัก Webhook อธิบายว่าเหตุใดการพัก worker ปลายทางอาจเหมาะกว่าการแก้ endpoint
ยืนยันเส้นทางใหม่โดยไม่อ้างว่ากู้ข้อมูลเก่าแล้ว
หลังเปลี่ยนการตั้งค่า ให้ส่งข้อความทดสอบใหม่ที่ควบคุมได้ ตรวจบัญชีและเหตุการณ์ที่ตัวรับที่ตั้งใจไว้ ยืนยันลายเซ็นตามข้อกำหนดการส่ง Webhook จัดเก็บถาวรก่อนตอบรับ แล้วตรวจการประมวลผลปลายทางแยกต่างหาก
นี่คือข้อเสนอสำหรับการทดสอบรับมอบ ไม่ใช่ผลทดสอบที่ดำเนินการในเวิร์กสเปซของคุณ หากคำขอเปลี่ยนการตั้งค่าหมดเวลา ให้อ่านสถานะปัจจุบันก่อนส่งคำขอแก้ไขซ้ำ กฎการสืบทอดกล่าวถึงการส่งครั้งแรกหลังจากนั้น ไม่ได้ระบุพฤติกรรมของทุกคำขอที่กำลังดำเนินการ
อินเทอร์เฟซที่ไม่เป็นทางการของ UnifyPort ให้เส้นทางเหตุการณ์รูปแบบเดียวกัน แต่ไม่รับประกันการส่ง payload ที่พลาดย้อนหลัง การทดสอบใหม่สำเร็จพิสูจน์เพียงว่าเส้นทางใหม่ทำงาน ไม่ได้พิสูจน์ว่าช่วงข้อมูลที่หายได้รับการกู้คืน
คำถามที่พบบ่อย
ปิด endpoint เฉพาะบัญชีแล้วเวิร์กสเปซจะรับแทนหรือไม่?
ไม่ การตั้งค่าเฉพาะแบบ inactive ยังมีผลแทนเวิร์กสเปซ ต้องลบตัวสุดท้ายจึงจะคืนการสืบทอดสำหรับการส่งครั้งแรกหลังจากนั้น
เปลี่ยน subscriptions ของเวิร์กสเปซเป็น wildcard ช่วยได้หรือไม่?
ไม่ช่วยแก้ลำดับความสำคัญของการตั้งค่าบัญชี ให้แก้การตั้งค่าบัญชีที่มีผล หรือยกเลิกอย่างตั้งใจเพื่อคืนการสืบทอด
ทำไมรายการ endpoint ของบัญชีจึงว่าง?
ผลลัพธ์ว่างที่สำเร็จหมายถึงไม่มี endpoint เฉพาะบัญชี ให้อ่านรายการเวิร์กสเปซเพื่อตรวจการตั้งค่าที่สืบทอด ข้อผิดพลาดไม่ใช่ผลลัพธ์ว่าง
ขั้นตอนถัดไปและแหล่งอ้างอิง
เริ่มจากรายการ Webhook endpoints แล้วเปรียบเทียบทั้งสองขอบเขตก่อนเปลี่ยนค่า
ตรวจเอกสารผลิตภัณฑ์ทางการเมื่อ 2026-11-15:
เปลี่ยนการเชื่อมต่อข้อความให้เป็น pipeline ผลิตภัณฑ์ที่เสถียร
เริ่มจากการส่งผ่าน API เดียว แล้วส่งข้อความขาเข้าทั้งหมดกลับสู่ระบบธุรกิจของคุณด้วย event มาตรฐาน