สิ่งที่ต้องเตรียม
- สิทธิ์แอดมินใน Sookly
- มี HTTPS endpoint สาธารณะพร้อมระบบบันทึกคำขอ (request logging)
- สามารถ deploy การแก้ไข endpoint ได้รวดเร็ว
ขั้นตอน
- สร้าง endpoint สำหรับรับ Webhook ในระบบของคุณ
- เปิด Settings → Developer → Webhooks ใน Sookly
- เพิ่ม URL ของ endpoint และเลือกประเภท event ที่ต้องการ
- ทำ signature validation และออกแบบให้ประมวลผลซ้ำได้อย่าง idempotent
- ส่ง test events และตรวจการตอบกลับ 2xx
- ติดตาม retries และ error logs ให้พร้อมสำหรับ production
ผลลัพธ์ที่ควรได้
- Webhook events มาถึงด้วยรูปแบบ payload ถูกต้อง
- ป้องกันการประมวลผลซ้ำด้วย idempotency
- มี monitoring สำหรับเหตุขัดข้อง
ปัญหาที่พบบ่อยและวิธีแก้
ปัญหา: Webhook retry ต่อเนื่องแม้แก้ endpoint แล้ว
วิธีแก้: ให้ endpoint ตอบ 2xx ให้เร็ว และย้ายงานหนักไปทำแบบ async
ปัญหา: การตรวจลายเซ็นล้มเหลวเป็นบางครั้ง
วิธีแก้: ตรวจ shared secret, การอ่าน header และการจัดการ canonical payload