Webhook

Webhook đẩy một thông điệp nhỏ đến một URL do bạn kiểm soát bất cứ khi nào có điều gì xảy ra trong PeekHire — để bạn có thể phản ứng theo thời gian thực thay vì liên tục thăm dò API.

Cách webhook hoạt động

1. Bạn tạo một endpoint (một URL trên máy chủ của bạn hoặc một công cụ tự động hóa) trong Công cụ dành cho nhà phát triển → Webhooks.
2. Bạn chọn những sự kiện mà endpoint đó sẽ nhận.
3. Khi một sự kiện xảy ra, PeekHire gửi một HTTP POST với payload JSON đến endpoint của bạn.

Payload được thiết kế nhỏ gọn — chúng cho biết điều gì đã xảy ra và liên quan đến đối tượng nào, để bạn có thể lấy đầy đủ chi tiết từ REST API nếu cần.

Sự kiện hiện có

Sự kiện bao quát vòng đời tuyển dụng, bao gồm:

• Hồ sơ ứng tuyển — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Bình luận trong hồ sơ ứng tuyển — application.comment.created, application.comment.updated, application.comment.deleted.
• Chiến dịch — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Xác minh lượt gửi

Mỗi lượt gửi đều được ký để bạn có thể xác nhận nó thực sự đến từ PeekHire. Hãy xác minh chữ ký trên endpoint của bạn trước khi tin tưởng payload, và phản hồi bằng trạng thái 2xx để xác nhận đã nhận.

Kiểm tra lượt gửi

Chế độ xem Lượt gửi hiển thị các lần thử webhook gần đây và kết quả của chúng, để bạn có thể xác nhận sự kiện đang được gửi đến và gỡ lỗi endpoint không phản hồi.

Mẹo

• Phản hồi nhanh bằng 2xx và xử lý các tác vụ nặng một cách bất đồng bộ.
• Thiết kế trình xử lý của bạn theo hướng idempotent — đôi khi cùng một sự kiện có thể được gửi nhiều hơn một lần.
• Bắt đầu với một công cụ như Make, Zapier hoặc n8n nếu bạn không muốn tự vận hành máy chủ.