데이터 연동 (API Key / Webhook)

데이터 연동은 API Key와 Webhook을 발급·등록해 라운드HR 데이터를 외부 시스템과 주고받을 수 있게 하는 설정입니다. 엔터프라이즈 플랜에서 사용할 수 있습니다.

개요

데이터 연동은 API Key와 Webhook을 통해 라운드HR 데이터를 외부 시스템과 주고받을 수 있게 하는 설정입니다. 설정 > 서비스 연동 > 보안/SSO 탭에서 관리합니다.

• API Key: 외부 시스템에서 라운드HR 데이터에 접근할 때 사용합니다.

• Webhook: 라운드HR에서 발생한 이벤트를 외부 시스템으로 자동 전달합니다.

API Key와 Webhook은 엔터프라이즈 플랜에서만 사용할 수 있습니다.

사전 준비

• 엔터프라이즈 플랜이 필요하며, API Key·Webhook은 Admin 권한을 가진 사용자만 관리할 수 있습니다.

---

1. API Key 관리

API Key를 발급하면 외부 시스템에서 라운드HR 데이터에 접근할 수 있습니다.

• 발급: [API Key 발급하기] 버튼을 클릭하고 이름을 입력해 발급합니다. 발급된 API Key는 목록에서 확인·복사할 수 있습니다.

• 복사: API Key 옆 복사 아이콘을 클릭해 토큰을 복사합니다.

• 삭제: 삭제 아이콘을 클릭해 사용하지 않는 API Key를 삭제합니다.

API Key 발급·삭제는 Admin 권한이 필요하며, 목록 조회는 매니저 이상 권한에서 가능합니다.

---

2. Webhook 관리

Webhook을 등록하면 라운드HR에서 발생하는 이벤트를 외부 시스템으로 자동 전달할 수 있습니다.

• 등록: [Webhook 등록하기] 버튼을 클릭하고 Callback URL을 입력해 등록합니다.

• 수정: 등록된 Webhook의 Callback URL을 수정합니다.

• 삭제: 사용하지 않는 Webhook을 삭제합니다.

Webhook은 Admin 권한을 가진 사용자만 등록·수정·삭제할 수 있습니다.

---

자주 묻는 질문

API Key와 Webhook은 누구나 사용할 수 있나요?

엔터프라이즈 플랜에서만 제공되며, Admin 권한을 가진 사용자만 발급·등록·삭제할 수 있습니다.

API Key와 Webhook은 어떻게 다른가요?

API Key는 외부 시스템이 라운드HR 데이터에 **접근(가져가기)**할 때 사용하고, Webhook은 라운드HR의 이벤트를 외부 시스템으로 **자동 전달(내보내기)**할 때 사용합니다.

Webhook으로는 어떤 이벤트가 전달되나요?

지원자의 채용 단계 변경, 평가 생성·완료, 면접 일정 등록, 폼(양식) 제출 등의 이벤트가 등록한 Callback URL로 전달됩니다. 각 요청에는 위·변조를 확인할 수 있는 서명(Round-Webhook-Signature)이 포함되며, 전송이 연속으로 실패하면 해당 Webhook은 자동으로 비활성화됩니다.