RolePark 소개 ↗
Djinni를 RolePark에 연결
RolePark는 공고를 Djinni에 게시하고 지원서를 RolePark 받은편지함으로 가져옵니다. Djinni API 키만 있으면 됩니다. RolePark가 ATS이므로 개발자가 필요 없습니다.
업데이트:
시작하기 전에
- API 접근 권한이 있는 Djinni 고용주 계정. https://djinni.co/home/profile/을 열었을 때 “ATS” 탭이 보이면 권한이 있습니다. 없으면 Djinni 지원팀(magic@djinni.co)에 문의하세요.
- RolePark 회사 관리자 계정. Djinni 연결은 회사 관리자만 할 수 있습니다.
- 회사당 Djinni API 키 하나이며 특정 개인에 묶이지 않습니다.
1단계. Djinni에서 API 키 만들기
- https://djinni.co/home/integrations/을 엽니다(Djinni 프로필의 “ATS” 탭).
- “Створити ключ” / “Create key”를 눌러 키를 복사합니다.
- “Увімкнути поле ATS Job ID у вакансіях”(ATS Job ID 필드)를 켭니다. 그러면 Djinni가 지원서마다 RolePark 공고 ID를 돌려줍니다.


키 옆의 빨간 “Delete” 버튼은 키를 삭제합니다. 새 키를 붙여 넣을 때까지 RolePark는 게시하지 않습니다.
2단계. RolePark에 키 붙여 넣기
- RolePark에서 설정 → 채용 사이트 → Djinni를 엽니다.
- “Djinni API 키”에 키를 붙여 넣고 “연결”을 누르면 RolePark가 바로 확인합니다.
- Djinni에서 필수인 기본값을 고릅니다: Djinni 채용 담당자(Djinni 목록의 이메일), 산업 분야, 카테고리. “기본값 저장”을 누릅니다.
저장한 뒤에는 키의 마지막 네 글자만 표시됩니다.

3단계. 지원서 웹훅
키가 확인되면 RolePark가 Djinni API를 통해 웹훅을 자동으로 만듭니다.
직접 추가하려면 Djinni → ATS → Webhooks에서 다음을 입력하세요:
| URL | RolePark의 Djinni 카드에 표시된 주소 |
|---|---|
| Action | Candidate Apply |
| 인증 | Header(사용자 지정 헤더) |
| Header Name | X-RolePark-Webhook-Token |
| Authentication Value (Token) | RolePark의 Djinni 카드에 표시된 토큰 |
| Send as JSON | 켜기 |
회사마다 고유한 주소와 토큰이 있으며, RolePark는 모든 요청에서 토큰을 확인합니다.
공고 게시
- RolePark에서 공고 → “게시처” 탭 → “Djinni” 패널을 엽니다.
- 필수 항목이 비어 있으면 패널에 표시됩니다. 게시하려면 Djinni에 급여 범위(최소·최대)가 필요하며, 초안은 없어도 됩니다. RolePark는 공고의 급여 범위가 월 미화 기준일 때만 자동으로 보내므로, 그렇지 않으면 “이 공고의 Djinni 항목”에 입력하세요.
- “Djinni에 게시”를 누르면 RolePark가 Djinni에 공고를 만들고 한 번에 게시합니다. “Djinni 초안으로 저장”은 보이지 않는 비활성 초안을 만들며, 나중에 “Djinni에 게시”로 게시할 수 있습니다.
- Djinni는 새 공고를 검토하며, 그동안 상태는 “Djinni 검토 중”입니다.

RolePark의 상태
- 대기 중 — 요청이 Djinni로 가는 중입니다.
- 초안 — Djinni에 있지만 보이지 않습니다.
- Djinni 검토 중 — Djinni가 검토하고 있습니다.
- 게시됨 — Djinni에서 보입니다.
- Djinni에서 일시 중지됨 — 공고가 일시 중지되어 Djinni에서 비활성 상태이며, 공고가 다시 열리면 돌아옵니다.
- 오류 — Djinni가 거부했으며 이유가 상태 옆에 표시됩니다.
- 내려감 — Djinni에서 보관되었습니다.
- RolePark에서 공고를 수정하면 Djinni 공고도 업데이트됩니다.
- 공고를 일시 중지하면 RolePark가 Djinni 공고도 일시 중지하고, 공고가 다시 열리면 재개합니다. 공고를 마감하거나 게시를 중단하거나 삭제하면 RolePark가 Djinni에서 내립니다.
- Djinni가 응답하지 않으면 RolePark가 다시 시도하며 분당 100회 한도를 지킵니다.
지원서가 표시되는 곳
- Djinni는 새 지원서가 들어오는 즉시 웹훅으로 RolePark에 보내며, RolePark는 15분마다 게시된 공고의 지원서도 확인합니다.
- 공고 → “받은편지함” 탭에 “Djinni” 배지와 프로필 링크와 함께 표시됩니다.
- 같은 사람이 Djinni 이메일 알림으로도 들어오면 프로필 링크로 알아보고 중복을 만들지 않습니다.
전송되는 데이터
RolePark → Djinni
- 제목, 설명, 기술, 위치와 근무 형태;
- 급여 범위(RolePark에서 공개인 경우에만 공개), 산업 분야, 카테고리, 채용 담당자;
- RolePark 공고 ID(ATS Job ID).
Djinni → RolePark
- 공유된 경우 이름과 연락처, 프로필 링크, CV, 자기소개서, 지원 시각.
- 성별, 병역 연기, 사진, 메신저, 퀴즈 답변은 가져오지 않습니다.
- API 키는 암호화(AES-256-GCM)되어 저장되며 다시 표시되거나 로그에 기록되지 않습니다.
- 연결을 해제하면 키와 웹훅이 삭제됩니다.
문제 해결
“키가 유효하지 않음”
Djinni에서 키가 삭제되었습니다. 새 키를 만들어 “키 교체”로 붙여 넣으세요.
“Djinni 요청 한도”
Djinni는 분당 100회를 허용합니다. RolePark가 기다렸다가 자동으로 계속합니다.
Djinni가 공고를 거부했습니다
이유는 공고 패널에 표시됩니다. 수정한 뒤 “다시 시도”를 누르세요.
Djinni에서 웹훅이 꺼졌습니다
RolePark에서 “키 확인”을 누르면 다시 설정됩니다.
Djinni에 “ATS” 탭이 없습니다
Djinni 지원팀에 문의하세요: magic@djinni.co.
지원
RolePark 문의: help@rolepark.com
Djinni API 접근 문의: magic@djinni.co.