그리팅에서 지원자·평가에 변화가 생기는 순간, 그 사실을 우리 회사 시스템으로 자동 전달받는 기능입니다.사람이 그리팅을 열어보고 옮겨 적는 대신, 시스템이 알아서 받아 처리하게 만들 수 있습니다.
하고 싶은 것 | 사용할 이벤트 |
|---|---|
새 지원자가 들어오면 즉시 AI/자체 스크리닝 돌리기 | 지원자 등록 |
합격자를 인사 시스템(HRIS)에 자동 등록하기 | 합격 |
지원자 단계 변화를 사내 대시보드·데이터 웨어하우스에 동기화하기 | 단계 이동, 합격, 불합격 |
평가가 배정되면 담당자에게 슬랙 DM 보내기 | 평가 부여 |
평가가 끝나면 다음 전형을 자동으로 진행하기 | 평가 완료 |
불합격 처리 결과를 자체 인재풀에 반영하기 | 불합격, 불합격 취소 |
항목 | 내용 |
|---|---|
요금제 | Business 플랜 전용입니다. 플랜이 해지·다운그레이드되면 전송이 자동 중단되고, 다시 Business로 전환하면 설정 그대로 자동 재개됩니다. |
권한 | 워크스페이스의 외부 인터페이스 관리 권한이 필요합니다. 기본 역할 중 소유자·관리자가 가지고 있으며, 일반 멤버에게는 없습니다. (Open API 키 관리와 동일한 권한) |
준비물 | 이벤트를 받을 https 주소(Push 방식) 또는 Open API 키(Pull 방식). |
개발 필요 여부 | 필요합니다. 그리팅이 보내는 요청을 받아 처리할 서버 또는 배치 프로그램을 개발자가 만들어야 합니다. |
그리팅은 같은 이벤트를 두 가지 방법으로 제공합니다. 둘 다 써도 되고, 하나만 써도 됩니다.
Push (웹훅) | Pull (Event Feed API) | |
|---|---|---|
동작 | 이벤트가 생기면 그리팅이 우리 주소로 바로 보냅니다 | 우리 쪽에서 주기적으로 가져갑니다 |
실시간성 | 실시간 (수 초 내) | 폴링 주기만큼 지연 |
필요한 것 | 24시간 떠 있는 https 수신 서버 | 하루 1회 이상 도는 배치 프로그램 |
이럴 때 | 인입 즉시 자동화를 걸어야 할 때 | 상시 서버 운영이 어렵거나, 야간 배치로 몰아서 처리할 때 |
설정 위치 | 워크스페이스 설정 > 웹훅 | 워크스페이스 설정 > Open API (이벤트 API 권한 켜기) |
둘 다 켜두면 안전합니다.
Push는 실시간 주 채널로 쓰고, Pull은 수신 서버 장애로 놓친 이벤트를 나중에 복구하는 용도로 쓸 수 있습니다. 두 방식은 같은 이벤트 저장소를 보기 때문에 받는 내용이 완전히 같습니다.
순서대로 확인하세요.
플랜 - Business 플랜인가요? 설정 화면에 플랜 제한으로 중단됨이 표시되어 있지 않나요?
토글 - 해당 웹훅이 켜져 있나요?
자동 중단 - 연속 실패로 중단되지 않았나요? 설정 화면의 최근 실패 원인을 확인하세요.
이벤트 선택 - 받으려는 이벤트에 체크가 되어 있나요?
테스트 발송 - 눌러보세요. 응답 코드가 바로 표시됩니다.
401/403 → 받는 쪽 서버가 요청을 거부 중입니다. 서명 검증 로직이나 인증 설정을 확인하세요.
404/405 → URL 경로 또는 허용 메서드(POST)를 확인하세요.
응답 없음(타임아웃) → 방화벽, 또는 10초 내 응답 여부를 확인하세요.
등록 시점 - 웹훅 등록 이전에 발생한 이벤트는 전달되지 않습니다.
24시간 경과 - 오래 중단되었다면 24시간이 지난 이벤트는 전송되지 않습니다. Pull(Event Feed)로 조회하면 7일 이내 것은 받을 수 있습니다.
제외 대상 - 데이터 이관·샘플 지원자는 전송 대상이 아닙니다.
받는 쪽에서 연속 7회 실패하면 자동으로 중단됩니다.
설정 화면에서 최근 실패 원인(응답 코드·오류 메시지·시각)을 확인하세요.
원인을 해결한 뒤 재활성화 버튼을 누르면 다시 동작합니다.
플랜 제한으로 중단된 경우는 화면에서 풀 수 없고, Business 플랜으로 전환하면 자동 복구됩니다.
별도 이메일 알림은 제공하지 않습니다. 정기적으로 설정 화면을 확인하거나, 받는 쪽에서 "N시간 동안 이벤트가 없다"를 감지하는 모니터링을 두는 것을 권장합니다.
그리팅은 누락보다 중복을 택하는 방식이라 같은 이벤트가 재전송될 수 있습니다. 받는 쪽에서 eventId로 중복을 제거하면 됩니다.
eventId가 서로 다르다면 중복이 아니라 별개 이벤트입니다. 합격 처리 시 단계 이동과 합격 2건이 발생하는 경우가 대표적입니다.
가장 흔한 원인은 세 가지입니다.
요청 본문을 파싱한 뒤 다시 문자열로 만들어 계산한 경우 - 반드시 원본 그대로 계산해야 합니다.
헤더 값의 sha256 접두사(공백 포함) 를 처리하지 않은 경우.
secret을 재발급했는데 받는 쪽 값을 바꾸지 않은 경우. 웹훅이 여러 개라면 secret도 각각 다릅니다.
설정 화면에서 재발급하세요. 재발급 즉시 이전 secret은 무효가 되므로, 받는 쪽 값을 교체하기 전까지 서명 검증이 실패합니다. 무중단으로 바꾸려면 받는 쪽에서 잠시 두 값을 모두 허용하도록 배포한 뒤 재발급하고, 이후 옛 값을 제거하세요.
Open API 키에 이벤트 API 권한이 켜져 있나요? 권한이 꺼진 API를 호출하면 요청이 거부됩니다.
권한을 켠 이전에 발생한 이벤트는 제공되지 않습니다.
이벤트는 7일 보관됩니다. 그보다 오래된 것은 조회할 수 없습니다.
상황 | 결과 |
|---|---|
Business → 하위 플랜 / 해지 | 모든 웹훅이 자동 중단됩니다. 설정 자체는 남아 있습니다 |
하위 플랜 → Business | 자동으로 재개됩니다. 중단 전에 켜져 있던 웹훅만 다시 켜집니다 |
Q. 면접 일정이 잡히면 알림을 받을 수 있나요?
현재는 제공하지 않습니다. 지원자 6종·평가 2종 총 8종만 제공되며, 면접·오퍼레터 관련 이벤트는 추후 검토 대상입니다.
Q. 지원자의 이력서 파일이나 문항 답변도 함께 받을 수 있나요?
웹훅 본문에는 포함되지 않습니다. 웹훅으로 받은 지원자 ID를 사용해 지원자 상세 조회 Open API로 가져오세요.
Q. 웹훅을 등록하기 전에 발생한 지원자도 받을 수 있나요?
받을 수 없습니다. 등록 시점부터 수집이 시작되며, 과거 데이터는 Open API로 조회해 초기 적재하세요.
Q. 등록 직후 바로 이벤트가 오지 않습니다.
설정 반영에 최대 10초가 걸릴 수 있습니다. 즉시 확인하려면 테스트 발송을 사용하세요.
Q. Push와 Pull을 동시에 쓰면 이벤트가 중복되나요?
같은 이벤트를 두 경로로 각각 받게 됩니다(이벤트 식별자는 동일). 한쪽만 처리하거나, eventId 기준으로 중복을 제거하세요.