> For the complete documentation index, see [llms.txt](https://guide.roundhr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.roundhr.com/setting/integrations/calendar/naver-works.md).

# Naver Works

Naver Works 캘린더 연동은 네이버웍스 앱을 생성·연결해 면접관의 비어 있는 시간에 면접을 요청하고 일정을 캘린더에 반영하는 설정입니다.

## 개요

**Naver Works 캘린더 연동**은 네이버웍스 앱을 생성·연결해 면접관의 비어 있는 시간에 면접을 요청하고, 확정된 일정을 네이버웍스 캘린더에 반영하는 설정입니다.

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

* 사내에서 네이버웍스 캘린더를 사용하며, 면접 일정을 자동으로 반영하고 싶을 때

## 사전 준비

* 네이버웍스 캘린더 연동을 하려면 먼저 **네이버 웍스 개발자 센터에서 앱 생성 및 연동**이 필요합니다.

***

## 1. 네이버 웍스 앱 만들기

* [네이버 웍스 개발자 센터](https://dev.worksmobile.com/kr/console/openapi/v2/app/list/view)에서 **앱 생성 추가**를 클릭합니다.
* 앱 이름은 `라운드HR`로 입력합니다.

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-75aaf82d0e107138c2251de6cc0af90e5173e3a8%2Fset_integ_cal_naver-works_s1_01.jpeg?alt=media" alt="네이버 웍스 개발자 센터에서 앱 생성 추가를 클릭하는 화면"><figcaption><p>앱 만들기</p></figcaption></figure>

***

## 2. Redirect URL·OAuth Scopes 입력하기

1. Access Token 유효기간을 `24 hours`로 선택합니다.

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-441489096a202dc38b14049f7ef62226b4bff860%2Fset_integ_cal_naver-works_s1_01.png?alt=media" alt="앱 설정에서 Access Token 유효기간을 24 hours로 선택하는 화면"><figcaption><p>Access Token 유효기간 설정</p></figcaption></figure>

2. Redirect URL에 아래 내용을 추가합니다.
   * `https://link.roundhr.com/auth/naver_works/calendar/callback`
3. OAuth Scopes에 아래 항목을 추가합니다.
   * `openid`, `profile`, `email`
   * `calendar`, `calendar.read`
   * `mail`, `mail.read`
   * `bot`, `bot.message`
   * `directory`, `directory.read`

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-c7d9c42abac43ce0bf2c99df548b62503f4ab6be%2Fset_integ_cal_naver-works_s1_03.jpeg?alt=media" alt="Redirect URL과 OAuth Scopes를 입력하는 화면"><figcaption><p>Redirect URL·Scopes 입력</p></figcaption></figure>

4. OIDC Logout Redirection의 Redirection URL에 아래 내용을 추가합니다.
   * `https://link.roundhr.com/auth/naver_works/calendar/logout`

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-3c5c969749972087640fd1130f89249a2ac0e8c6%2Fset_integ_cal_naver-works_s1_03.png?alt=media" alt="OIDC Logout Redirection의 Redirection URL 입력 화면"><figcaption><p>Logout Redirection 설정</p></figcaption></figure>

***

## 3. 라운드HR에서 네이버 웍스 연동

* [설정 > 서비스 연동 > 네이버 웍스](https://app.roundhr.com/setting/integration/calendar/naver_works)에서 **앱 연동하기**(이미 연동된 경우 **앱 연동 수정하기**)를 클릭합니다.
* 개발자 센터에서 받은 **Client ID**와 **Client Secret**을 입력합니다.
  * Client ID는 영어 대소문자 + 숫자 20글자입니다.
  * Client Secret은 영어 대소문자 + 숫자 10글자입니다.

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-d3c2d8e0e474002682c799d25914a37116373b12%2Fset_integ_cal_naver-works_s1_05.jpeg?alt=media" alt="라운드HR 설정 > 서비스 연동 > 네이버 웍스의 웍스 연동하기 버튼"><figcaption><p>네이버 웍스 연동 진입</p></figcaption></figure>

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-4962661771ac4521c21b32664e193fede0bea6a9%2Fset_integ_cal_naver-works_s1_06.jpeg?alt=media" alt="개발자 센터에서 받은 Client ID와 Client Secret을 입력하는 화면"><figcaption><p>Client 정보 입력</p></figcaption></figure>

***

## 4. 네이버 웍스 캘린더 연결

* [설정 > 서비스 연동 > 네이버 웍스](https://app.roundhr.com/setting/integration/calendar/naver_works)에서 **캘린더 연결**을 클릭합니다.
* 연결이 완료되면 "캘린더 연결 완료" 메시지가 표시됩니다.

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-4ea762039bb1b42067b1eaa0c823a6da2c76ce37%2Fset_integ_cal_naver-works_s1_07.jpeg?alt=media" alt="캘린더 연결 완료 메시지가 표시된 화면"><figcaption><p>캘린더 연결 완료</p></figcaption></figure>

***

## 자주 묻는 질문

<details>

<summary>Client ID와 Client Secret은 어디서 확인하나요?</summary>

네이버 웍스 개발자 센터에서 생성한 앱의 정보에서 확인할 수 있습니다. Client ID는 20글자, Client Secret은 10글자(영어 대소문자 + 숫자)입니다.

</details>

<details>

<summary>알림용 봇도 함께 쓰려면 어떻게 하나요?</summary>

여기서 만든 앱을 그대로 사용해 봇을 생성·등록하면 됩니다. 자세한 내용은 [네이버웍스 알림 연동](/setting/integrations/notifications/naver_works.md)을 참고하세요.

</details>

<details>

<summary>캘린더 연결이 잘 되었는지 어떻게 확인하나요?</summary>

캘린더 연결을 클릭한 뒤 연결이 완료되면 "캘린더 연결 완료" 메시지가 표시됩니다. 이 메시지가 보이면 정상적으로 연동된 것입니다.

</details>