자동화 및 개발자
웹훅
PeekHire에서 이벤트가 발생하면 실시간 알림을 받아보세요.
Webhook은 PeekHire에서 어떤 일이 발생할 때마다 사용자가 제어하는 URL로 작은 메시지를 푸시합니다. 그래서 API를 폴링하는 대신 실시간으로 대응할 수 있습니다.
Webhook 작동 방식
- 개발자 도구 → Webhooks에서 엔드포인트(사용자 서버의 URL 또는 자동화 도구)를 생성합니다.
- 어떤 이벤트를 받을지 선택합니다.
- 이벤트가 발생하면 PeekHire가 JSON 페이로드가 포함된 HTTP
POST를 엔드포인트로 보냅니다.
페이로드는 의도적으로 작게 설계되어 있습니다. 어떤 일이 발생했는지, 어떤 객체와 관련 있는지를 식별하므로, 필요한 경우 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에서 보낸 것인지 확인할 수 있습니다. 페이로드를 신뢰하기 전에 엔드포인트에서 서명을 검증하고, 수신을 확인하려면 2xx 상태로 응답하세요.
전송 확인
Deliveries 화면에서는 최근 webhook 시도와 그 결과를 보여주므로, 이벤트가 도착하는지 확인하고 응답하지 않는 엔드포인트를 디버그할 수 있습니다.
팁
2xx로 빠르게 응답하고 무거운 작업은 비동기로 처리하세요.- 핸들러를 멱등성 있게 만드세요. 동일한 이벤트가 드물게 두 번 이상 전달될 수 있습니다.
- 서버를 직접 운영하고 싶지 않다면 Make, Zapier, n8n 같은 도구로 시작하세요.