# 원티드 지원자 동기화

## 개요

원티드 연동을 통해 두 가지 동기화 기능을 사용할 수 있습니다.

* **지원자 목록 동기화:** 원티드에 지원한 지원자 정보를 라운드HR로 자동으로 불러옵니다. 설정을 켜면 별도 조작 없이 새 지원자가 자동 등록됩니다.
* **지원자 상태 동기화:** 라운드HR에서 변경한 채용 상태(합격, 불합격 등)를 원티드에 자동 반영합니다.

### 핵심 이점

* **완전 자동화:** 지원자 목록 동기화를 켜면 원티드 지원자가 자동으로 라운드HR에 등록됩니다. 별도로 불러오기를 실행할 필요가 없습니다.
* **상태 자동 반영:** 라운드에서 합격/불합격 처리하면 원티드에도 자동으로 반영되어 이중 작업이 사라집니다.

### 이런 경우에 사용하세요

* 원티드에 공고를 게시하고, 지원자를 라운드HR에서 관리하고 싶을 때
* 라운드에서 처리한 채용 결과를 원티드에 별도로 입력하기 번거로울 때

## 사전 준비

다음 설정이 완료되어야 합니다:

* **권한:** Admin 또는 Manager
* **원티드 API 키 연동:** [원티드 계정 연동](/candidate/recruitment/recruit_platform/connect/api.md) 완료
* **공고 연결:** [채용 플랫폼 공고 연결](/candidate/recruitment/recruit_platform/mapping.md) 완료
* **앱 설치:** [라운드HR 앱 설치](/candidate/recruitment/recruit_platform/app_install.md) 완료 (데스크톱 앱 사용 시)

***

<figure><img src="/files/vJd9hdp2NUtIXFbHoc2q" alt=""><figcaption></figcaption></figure>

## 1. 지원자 목록 동기화

***

지원자 목록 동기화를 활성화하면, 원티드에 새로 지원한 지원자가 **자동으로** 라운드HR에 등록됩니다. 별도로 불러오기를 실행할 필요 없이, 설정만 켜두면 됩니다.

### 1-1. 자동 동기화 설정

* **설정** > **채용관리** > **원티드** 에서 **지원자 목록 동기화**를 활성화합니다.
* 원티드 연동 시 기본적으로 활성화되어 있습니다.

{% hint style="info" %}
지원자 목록 동기화가 활성화되면, 원티드에 새 지원자가 들어올 때마다 자동으로 라운드HR에 등록됩니다. ATS > **지원자 관리** > **지원** 탭에서 동기화된 지원자를 확인할 수 있습니다.
{% endhint %}

### 1-2. 자동 동기화 방식

* 동기화는 **일정 간격으로 자동 실행**되며, 새로운 지원자만 추가됩니다.
* 이미 등록된 지원자는 자동으로 제외되어 중복 등록되지 않습니다.
* 재지원 제한 설정에 해당하는 지원자도 자동으로 필터링됩니다.

### 1-3. 동기화되는 정보

원티드에서 다음 정보가 함께 동기화됩니다.

| 항목        | 내용                          |
| --------- | --------------------------- |
| **기본 정보** | 이름, 이메일, 전화번호               |
| **학력**    | 학교명, 전공                     |
| **경력**    | 회사명, 직무, 재직 기간, 고용 형태       |
| **지원 정보** | 지원일, 지원 경로(원티드), 지원 유형      |
| **추천 정보** | 추천자 이름, 회사명, 관계 (추천 지원인 경우) |
| **첨부파일**  | 이력서, 포트폴리오 등                |

{% hint style="warning" %}
**동기화 대상 상태:** 원티드에서 **지원** 또는 **서류 통과** 상태인 지원자만 불러올 수 있습니다. 이미 불합격 또는 최종 합격 처리된 지원자는 동기화 대상에서 제외됩니다.
{% endhint %}

***

## 2. 지원자 상태 동기화

***

라운드HR에서 변경한 지원자의 채용 상태를 원티드에 자동으로 반영합니다.

### 2-1. 자동 상태 동기화 활성화

* **설정** > **외부 서비스 연동** > **원티드** 에서 **자동 상태 동기화**를 활성화합니다.

{% hint style="info" %}
자동 상태 동기화를 활성화하면, 라운드에서 지원자 상태를 변경할 때마다 원티드에도 자동으로 반영됩니다.
{% endhint %}

### 2-2. 상태 매핑

라운드HR의 채용 단계 변경이 원티드 상태에 다음과 같이 반영됩니다.

<table><thead><tr><th width="166.52734375">라운드HR 처리</th><th width="184.76953125">원티드 반영 상태</th><th>설명</th></tr></thead><tbody><tr><td>인터뷰 단계 이동</td><td><strong>서류 통과</strong></td><td>면접 단계로 이동하면 원티드에서 서류 통과 처리</td></tr><tr><td>최종 합격 처리</td><td><strong>최종 합격</strong></td><td>합격 처리하면 원티드에서도 합격 처리</td></tr><tr><td>불합격 처리</td><td><strong>불합격</strong></td><td>불합격 처리하면 원티드에서도 불합격 처리</td></tr></tbody></table>

```mermaid
graph LR
    subgraph Round[라운드HR]
        R_Interview[인터뷰 단계 이동]
        R_Pass[최종 합격]
        R_Fail[불합격]
    end

    subgraph Wanted[원티드]
        W_Pass[서류 통과 (Pass)]
        W_Hire[최종 합격 (Hire)]
        W_Reject[불합격 (Reject)]
    end

    R_Interview -->|자동 반영| W_Pass
    R_Pass -->|자동 반영| W_Hire
    R_Fail -->|자동 반영| W_Reject

    style R_Interview fill:#E6F7FF,stroke:#1890FF
    style R_Pass fill:#F6FFED,stroke:#52C41A
    style R_Fail fill:#FFF1F0,stroke:#F5222D

    style W_Pass fill:#E6F7FF,stroke:#1890FF
    style W_Hire fill:#F6FFED,stroke:#52C41A
    style W_Reject fill:#FFF1F0,stroke:#F5222D
```

### 2-3. 동기화 확인

자동 상태 동기화가 활성화된 상태에서 지원자를 처리하면, 처리 모달에 안내 문구가 표시됩니다.

> "처리한 결과는 원티드에도 자동 반영됩니다."

{% hint style="warning" %}
**주의사항**

* **지원 상태로는 되돌릴 수 없습니다.** 한 번 변경된 상태(서류 통과, 합격, 불합격)는 다시 "지원" 상태로 변경할 수 없습니다.
* 원티드에서 불러온 지원자에게만 상태 동기화가 적용됩니다. 자체 지원이나 직접 등록한 지원자는 해당되지 않습니다.
  {% endhint %}

{% hint style="success" %}
**자동 동기화 범위:** 상태 변경 후 일정 시간 내에 자동으로 원티드에 반영됩니다. 별도의 추가 조작 없이 라운드에서의 채용 프로세스만 진행하면 됩니다.
{% endhint %}

***

## 자주 묻는 질문 (FAQ)

<details>

<summary>이미 등록된 지원자가 중복으로 동기화되나요?</summary>

**중복 지원자 자동 제외**

이미 라운드HR에 등록된 지원자는 자동으로 제외됩니다. 동기화 시 새로운 지원자만 추가되며, 기존 데이터에는 영향을 주지 않습니다.

</details>

<details>

<summary>원티드에서 불합격 처리된 지원자도 동기화되나요?</summary>

**동기화 가능 상태**

원티드에서 **지원**(**send**) 또는 **서류 통과**(**pass**) 상태인 지원자만 동기화 대상입니다. 이미 불합격(reject) 또는 최종 합격(hire) 처리된 지원자는 자동 동기화에서 제외됩니다.

</details>

<details>

<summary>상태 동기화가 반영되지 않아요. 어떻게 해야 하나요?</summary>

**상태 동기화 체크사항**

다음 항목을 확인해 주세요:

* **자동 상태 동기화 활성화 여부:** 설정 > 외부 서비스 연동 > 원티드 에서 자동 상태 동기화가 켜져 있는지 확인합니다.
* **원티드 연동 상태:** 원티드 API 키가 정상적으로 연동되어 있는지 확인합니다.
* **지원자 유입 경로:** 원티드에서 불러온 지원자에게만 상태 동기화가 적용됩니다. 자체 지원 또는 직접 등록한 지원자는 해당되지 않습니다.

위 사항을 모두 확인했는데도 문제가 지속된다면, 고객센터로 문의해 주세요.

</details>

<details>

<summary>라운드에서 불합격 처리 후 다시 합격으로 변경할 수 있나요?</summary>

**상태 변경 제한**

라운드에서는 지원자의 단계를 자유롭게 변경할 수 있지만, 원티드로의 상태 동기화는 **되돌릴 수 없습니다.** 원티드에서 불합격(reject) 처리된 지원자를 다시 합격으로 변경하려면 원티드에서 직접 처리해야 합니다.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.roundhr.com/candidate/recruitment/recruit_platform/platform_collection/wanted-sync.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
