🆕 Webhook - 단계이동

요청 헤더·서명 검증·재시도·중복 처리 등 공통 사항은 공통 규격 문서를 참고하세요.

이벤트 타입

APPLICANT_PROCESS_MOVED

발생 시점

지원자가 다른 채용단계로 이동한 시점입니다.
담당자의 수동 이동, 엑셀 일괄 스크리닝에 의한 이동, 합격·합격 취소·연동 불합격 처리에 동반된 이동이 모두 포함됩니다. 어떤 조작이었는지는 movedType으로 구분하세요.
단, 데이터 이관(마이그레이션) 으로 인한 이동은 전송되지 않습니다.

합격·합격 취소 시에는 이벤트가 2건 발생합니다.합격 처리 → APPLICANT_PROCESS_MOVED(movedType: PASS) + APPLICANT_PASSED합격 취소 → APPLICANT_PROCESS_MOVED(movedType: PASS_CANCELED) + APPLICANT_PASS_REVOKED중복이 아니라 의도된 별개 이벤트입니다. 단계 이동만 한 번 처리하고 싶다면 movedType으로 구분하세요.

요청 메소드

POST

요청 데이터 타입

application/json

요청 데이터 본문 (data)

필드	타입	필수 여부	설명
applicantId	Integer	필수	지원자 고유 id 값입니다
openingId	Integer	필수	지원한 공고 고유 id 값입니다
processId	Integer	필수	이동한 후의 채용단계 고유 id 값입니다
processName	String	선택	이동한 후의 채용단계 이름입니다. 단계가 삭제된 경우 생략됩니다
status	Enum	필수	지원자 현재 상태입니다. 이동 시점의 값이며 movedType에 따라 달라집니다
movedType	Enum	필수	단계 이동이 어떤 조작으로 발생했는지입니다

movedType 값

값	설명
MANUAL	담당자가 직접 단계를 옮긴 경우입니다
EXCEL_SCREENING	엑셀 일괄 스크리닝으로 이동한 경우입니다
PASS	합격 처리에 동반된 이동입니다. APPLICANT_PASSED가 함께 발생합니다
PASS_CANCELED	합격 취소에 동반된 이동입니다. APPLICANT_PASS_REVOKED가 함께 발생합니다
INTEGRATION_REJECT	연동을 통한 불합격 처리에 동반된 이동입니다

status 값

값	설명
SUBMIT	평가중
PASS	합격
REJECT	불합격

값이 없는 필드는 키 자체가 생략됩니다. 항상 존재한다고 가정하지 말고 없을 때를 처리하세요.

예시

JSON

참고

이동 전 단계 정보는 제공되지 않습니다. 이전 단계를 알아야 한다면 수신 측에서 직전 값을 보관하세요.
같은 지원자의 이벤트는 발생 순서대로 전달되므로, 단계 이동 이력을 순서대로 재구성할 수 있습니다. 단, 앞선 이벤트의 재시도가 모두 소진된 경우에는 순서가 어긋날 수 있으니 occurredAt 기준 방어 로직을 함께 두세요.