กำหนดค่า Webhook
ชี้ Timemark ไปยัง endpoint ของคุณ เลือกว่าเหตุการณ์ใดและโปรเจกต์ใดจะทริกเกอร์การทำงาน แล้วทดสอบการส่งข้อมูล
ควรทำสิ่งนี้เมื่อไหร่
หัวข้อที่มีชื่อว่า “ควรทำสิ่งนี้เมื่อไหร่”คุณต้องการให้ระบบของคุณเองตอบสนองเมื่อมีเหตุการณ์เกิดขึ้นใน Teamspace เช่น บันทึกการอัปโหลดภาพถ่าย หรือเริ่มการทำงานของระบบขั้นถัดไป Webhook จะทำให้ Timemark ส่งคำขอ POST ไปยัง endpoint ของคุณทุกครั้งที่เหตุการณ์ที่เลือกไว้เกิดขึ้น
สิ่งที่คุณต้องมี
หัวข้อที่มีชื่อว่า “สิ่งที่คุณต้องมี”- บทบาท
- เจ้าของทีม
- แพลตฟอร์ม
- Web
- แผน
- Business
- มีผลกับ
- ทำงานเฉพาะเหตุการณ์ที่เกิดขึ้นหลังจากสร้าง webhook เท่านั้น
ตั้งค่า Webhook
หัวข้อที่มีชื่อว่า “ตั้งค่า Webhook”- ไปที่ Teamspace → การตั้งค่า → การผสานการทำงาน → Webhook
- ป้อน endpoint URL ของคุณ ต้องเข้าถึงได้แบบสาธารณะและตอบสนองต่อคำขอ POST ได้
- ยืนยันทริกเกอร์ Webhook จะทำงานเมื่อมี ภาพถ่ายใหม่ ถูกอัปโหลด
- เลือก ขอบเขต: ภาพทั้งหมด หรือ โฟลเดอร์ ที่ระบุ
- บันทึก
ทดสอบการส่งข้อมูล
หัวข้อที่มีชื่อว่า “ทดสอบการส่งข้อมูล”- จาก Webhook ที่คุณเพิ่งบันทึกไป ใช้ฟังก์ชัน ทดสอบ หรือ ping เพื่อส่งตัวอย่าง payload
- ตรวจสอบ log ของ endpoint คุณเพื่อยืนยันว่า payload มาถึงแล้ว
- ยืนยันว่า endpoint ของคุณตอบกลับด้วยสถานะ
2xx
ฟิลด์ที่คุณสามารถกำหนดค่าได้
หัวข้อที่มีชื่อว่า “ฟิลด์ที่คุณสามารถกำหนดค่าได้”| Field | What it does | Notes |
|---|---|---|
| Endpoint URL | ตำแหน่งที่ Timemark ส่งคำขอ POST ไป | ต้องเป็นสาธารณะและตอบกลับด้วย 2xx ภายในเวลาที่กำหนด (timeout) |
| Trigger | การกระทำที่ทำให้เกิดการส่งข้อมูล | ปัจจุบัน ภาพถ่ายใหม่ (photo.uploaded) เป็นทริกเกอร์เดียวที่มี ดู ประเภทเหตุการณ์ของ Webhook |
| ขอบเขต | จำกัดการทำงานให้อยู่ในโฟลเดอร์เดียว หรือภาพถ่ายทั้งหมดของทีม | ขอบเขตแบบโฟลเดอร์จะทำงานเฉพาะภาพถ่ายในโฟลเดอร์นั้นเท่านั้น |
ข้อผิดพลาดที่พบบ่อย
หัวข้อที่มีชื่อว่า “ข้อผิดพลาดที่พบบ่อย”- ไม่ทำงานย้อนหลัง Webhook จะทำงานเฉพาะเหตุการณ์ที่เกิดขึ้นหลังจากสร้างเท่านั้น ภาพถ่ายที่มีอยู่ก่อนหน้าจะไม่ทริกเกอร์การทำงาน
- Endpoint ต้องตอบกลับด้วย
2xxให้ทันเวลา การ timeout หรือเกิดข้อผิดพลาดจะถือว่าเป็นการส่งข้อมูลที่ล้มเหลว Timemark จะลองส่งใหม่สำหรับการส่งที่ล้มเหลว แล้วหยุดเมื่อจำนวนครั้งที่ลองใหม่หมดลง - ขอบเขตไม่ตรงกัน Webhook ที่กำหนดขอบเขตไว้ที่โฟลเดอร์เดียวจะไม่ทำงานสำหรับภาพถ่ายในโฟลเดอร์อื่น ตั้งขอบเขตเป็น ภาพทั้งหมด หากคุณต้องการให้ครอบคลุมทุกโฟลเดอร์
- อยู่หลัง Firewall Endpoint ที่อยู่หลัง VPN หรือ Firewall จะไม่สามารถเข้าถึงได้ ต้องเปิดเป็น URL สาธารณะ
ดูเพิ่มเติม
หัวข้อที่มีชื่อว่า “ดูเพิ่มเติม”อัปเดตล่าสุด: