> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 캘린더 및 이메일

> Twenty에 이메일과 캘린더 계정을 연결하세요.

## 연결 옵션

### Google 계정 (Gmail 및 Google 캘린더)

1. **설정 → 계정**으로 이동
2. **계정 추가**를 클릭
3. **Google로 계속**을 선택
4. Twenty에게 Gmail 및 Google 캘린더에 대한 접근 권한을 부여
5. 이메일 동기화 설정(가시성, 자동 생성)을 구성한 뒤 → **다음**을 클릭
6. 캘린더 동기화 설정(가시성, 자동 생성)을 구성한 뒤 → **계정 추가**를 클릭
7. 이메일과 캘린더 이벤트가 자동으로 동기화되기 시작합니다.

### Microsoft 계정 (Outlook 및 Microsoft 캘린더)

1. **설정 → 계정**으로 이동
2. **계정 추가**를 클릭
3. **Microsoft로 계속**을 선택
4. Twenty에게 Outlook과 Microsoft 캘린더에 대한 접근 권한을 부여
5. 이메일 동기화 설정(가시성, 자동 생성)을 구성한 뒤 → **다음**을 클릭
6. 캘린더 동기화 설정(가시성, 자동 생성)을 구성한 뒤 → **계정 추가**를 클릭
7. 이메일과 캘린더 이벤트가 자동으로 동기화되기 시작합니다.

### IMAP/SMTP/CalDAV 설정 (다른 공급자)

다른 이메일 및 캘린더 공급자의 경우:

1. **설정 → 계정**으로 이동
2. 수신 이메일을 동기화하려면 IMAP 설정을 구성하고, 이메일을 보내려면 SMTP 설정을 구성하세요.
3. 캘린더를 위한 CalDAV 설정을 구성합니다.
4. 연결을 테스트하세요.

<Note>
  **에어갭 또는 내부 네트워크에서의 셀프 호스팅**: 기본적으로 Twenty는 사설/내부 IP 주소로의 아웃바운드 연결을 거부합니다(SSRF 보호). 메일 또는 캘린더 서버가 로컬/사설 IP(예: LAN의 온프레미스 서버)에서 실행 중인 경우, 해당 서버로의 연결은 차단됩니다. 이를 허용하려면 서버에서 다음 환경 변수를 설정하세요:

  ```
  OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
  ```

  이 설정은 **모든** 아웃바운드 요청(HTTP 워크플로 작업, 웹훅, IMAP/SMTP/CalDAV 연결)에 대해 안전 모드를 비활성화하므로, SSRF 보호가 필요하지 않은 신뢰할 수 있고 격리된 네트워크에서만 설정해야 합니다.
</Note>

### 다중 메일박스

* **무제한 계정**: 사용자당 여러 이메일 계정 연결
* **계정 관리**: 다양한 메일박스 간 전환
* **동기화 설정**: 메일박스 별 다른 설정 구성

<Warning>
  실제 메일박스만 연결할 수 있습니다 (예: 자신의 인박스를 가진 [support@domain.com](mailto:support@domain.com)). 다른 메일박스로 전달되는 이메일 별칭은 Twenty에 연결할 수 없습니다.
</Warning>

## 이메일 구성

### 메시지 가시성

이메일에 대한 가시성 수준 선택:

* **메타데이터만**: 기본 정보만 공유 (발신자, 수신자, 날짜, 시간)
* **제목 및 메타데이터**: 메타데이터와 제목 줄 공유
* **모든 이메일 내용**: 첨부 파일을 포함한 전체 이메일 내용 공유

### 연락처 자동 생성

* **비활성화됨**: 자동 연락처 생성 없음
* **발송 및 수신 메시지용**: 모든 외부 이메일 상호작용에 대해 연락처 생성
* **발송 메시지용**: 발송하는 이메일에 대해서만 연락처 생성
* **참고**: 기본적으로 내부 이메일(모든 참여자가 동일한 도메인을 사용하는 이메일)은 프라이버시 보호를 위해 동기화되지 않습니다.

<Note>활성화하면 연락처는 이메일 도메인을 기준으로 해당 회사 레코드에 자동으로 연결됩니다. 아직 회사가 존재하지 않으면 Twenty가 생성합니다.</Note>

<Note>
  **내부 이메일 동기화**: "내부 이메일이 동기화되지 않음" 동작이 기본값이지만, 이를 해제할 수 있습니다. 해당 토글은 고급 설정에 있습니다:

  1. **설정**을 열고 설정 페이지 하단에서 **고급** 토글을 활성화하세요.
  2. **일반 → 보안**으로 이동하세요.
  3. 모든 참여자가 동일한 도메인을 사용하는 이메일을 포함하려면 **내부 이메일 동기화** 토글을 활성화하세요.

  이 설정은 워크스페이스 전체에 적용됩니다(대학이나 공유 도메인 조직에 유용).
</Note>

### 메시지 폴더 선택으로 동기화할 이메일 제어

Twenty와 동기화할 이메일 폴더 제어:

1. **설정 → 계정**으로 이동하여 연결된 이메일 계정을 선택하세요.
2. 동기화할 폴더를 선택하세요:
   * **받은 편지함**: 주요 수신 이메일
   * **보낸 편지함**: 발송한 이메일
   * **사용자 지정 폴더**: 포함하고 싶은 특정 폴더
   * **폴더 제외**: 스팸, 휴지통 또는 개인 폴더 건너뛰기

모든 이메일을 동기화하지 않고 CRM에 나타나는 이메일을 정확하게 제어할 수 있습니다.

**동기화되는 항목:**

* **외부 이메일**: 선택한 폴더에서 외부 연락처와의 모든 이메일
* **내부 이메일**: 기본적으로 동기화되지 않음(같은 도메인 이메일은 비공개로 유지). 워크스페이스 전체에 포함하려면 **설정** 하단에서 **고급** 토글을 활성화한 후, **일반 → 보안**에서 **내부 이메일 동기화**를 켜세요.
* **첨부 파일**: 2026년 상반기 제공 예정

**참고**: 선택적 동기화를 위한 CC 이메일 주소를 제공하지 않습니다. 대신에 위의 메시지 폴더 기능을 사용하여 Twenty와 동기화할 이메일을 동일한 수준으로 제어할 수 있습니다.

## 캘린더 구성

### 이벤트 가시성

작업 공간의 다른 사용자에게 보이는 내용을 선택하세요:

* **모든 것**: 팀과 이벤트의 모든 세부사항 공유
* **메타데이터**: 날짜 및 참가자만 팀과 공유됨

### 회의를 위한 연락처 자동 생성

* **예**: CRM에 없는 회의 참가자를 위해 연락처 자동 생성
* **아니오**: 기존 연락처에만 회의 연결

<Note>활성화하면 연락처는 이메일 도메인을 기준으로 해당 회사 레코드에 자동으로 연결됩니다. 아직 회사가 존재하지 않으면 Twenty가 생성합니다.</Note>

### 동기화할 이벤트 제어

* **회의 가져오기**: 자동으로 캘린더 이벤트 가져오기
* **연락처 연결**: 회의를 사람과 회사 기록에 연결

**동기화되는 항목:**

* **회의**: 외부 참가자가 있는 캘린더 이벤트
* **연락처 연결**: CRM 기록에 자동으로 연결되는 이벤트
* **팀 이벤트**: 공유된 캘린더 가시성

## 동기화 빈도

**5분마다 업데이트**: 초기 가져오기를 마친 후 5분마다 이메일 및 캘린더 데이터가 자동으로 동기화됩니다.

<Note>
  **초기 동기화 소요 시간**: 캘린더 동기화는 빠르게 완료됩니다(보통 몇 분 이내에), 반면 메일박스가 큰 경우 이메일 동기화에는 더 오래 걸립니다. Twenty는 분당 약 **400건의 메시지**를 가져옵니다(Gmail API의 속도 제한으로 제한됨). 따라서 10,000개의 이메일이 있는 메일박스는 약 25분이 걸립니다. 캘린더 이벤트의 연락처가 이메일 연락처보다 먼저 표시되어도 걱정하지 마세요. 이는 정상적인 동작입니다.
</Note>

## 다음 단계

* [메일박스 기능](/l/ko/user-guide/calendar-emails/capabilities/mailbox)
* [누락된 이메일 문제 해결](/l/ko/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records)