เว็บฮุก

Webhooks จะส่งข้อความสั้น ๆ ไปยัง URL ที่คุณควบคุมเมื่อมีบางอย่างเกิดขึ้นใน PeekHire — เพื่อให้คุณตอบสนองได้แบบเรียลไทม์โดยไม่ต้องคอย polling API

Webhooks ทำงานอย่างไร

1. คุณสร้าง endpoint (URL บนเซิร์ฟเวอร์ของคุณหรือเครื่องมืออัตโนมัติ) ใน เครื่องมือสำหรับนักพัฒนา → Webhooks.
2. คุณเลือก เหตุการณ์ ที่ endpoint ควรได้รับ
3. เมื่อมีเหตุการณ์เกิดขึ้น PeekHire จะส่ง HTTP POST พร้อม payload แบบ JSON ไปยัง endpoint ของคุณ

Payload ถูกออกแบบให้มีขนาดเล็ก — โดยระบุว่าเกิดอะไรขึ้นและเกี่ยวข้องกับออบเจ็กต์ใด เพื่อให้คุณดึงรายละเอียดทั้งหมดจาก REST API ได้หากต้องการ

เหตุการณ์ที่ใช้งานได้

เหตุการณ์ครอบคลุมวงจรการสรรหาบุคลากร รวมถึง:

• ใบสมัคร — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• ความคิดเห็นในใบสมัคร — application.comment.created, application.comment.updated, application.comment.deleted.
• แคมเปญ — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

การตรวจสอบการส่ง

การส่งแต่ละครั้งจะมีลายเซ็นกำกับ เพื่อให้คุณยืนยันได้ว่ามาจาก PeekHire จริง ตรวจสอบ ลายเซ็นบน endpoint ของคุณก่อนเชื่อถือ payload และตอบกลับด้วยสถานะ 2xx เพื่อยืนยันว่าได้รับแล้ว

การตรวจดูการส่ง

มุมมอง การส่ง จะแสดงความพยายามส่ง webhook ล่าสุดและผลลัพธ์ เพื่อให้คุณ ยืนยันได้ว่าเหตุการณ์มาถึงแล้ว และดีบัก endpoint ที่ไม่ตอบสนองได้

เคล็ดลับ

• ตอบกลับอย่างรวดเร็วด้วย 2xx และทำงานหนักแบบอะซิงโครนัส
• ทำให้ handler ของคุณเป็นแบบ idempotent — เหตุการณ์เดียวกันอาจถูกส่ง มากกว่าหนึ่งครั้งเป็นครั้งคราว
• เริ่มด้วยเครื่องมืออย่าง Make, Zapier หรือ n8n หากคุณไม่อยากรันเซิร์ฟเวอร์ด้วยตัวเอง