snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 3s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -0,0 +1,43 @@
---
title: 캘린더
description: Twenty의 캘린더 통합 기능 이해하기.
---
**참고**: 캘린더를 연결하고 동기화 설정을 구성하려면 [이메일 및 일정 설정](/l/ko/user-guide/calendar-emails/overview)을 방문하세요.
## 캘린더 통합 작동 방식
Twenty는 캘린더 이벤트를 자동으로 동기화하고 관련 CRM 레코드에 연결하여 연락처 및 회사와의 미팅 이력을 완벽하게 파악할 수 있도록 합니다.
## 캘린더 탭
레코드의 이메일 탭 옆에 `캘린더` 탭이 있으며, 해당 레코드와 예정된 미팅의 이력을 확인할 수 있습니다.
### 사용 가능 대상
* **사람들**: 특정 연락처와 예정된 모든 미팅 보기
* **회사**: 회사 및 직원과 관련된 모든 미팅 보기
* **기회**: 이 기회와 연결된 회사의 미팅 기록에 접근
### 미팅 기록 보기
1. **기록으로 이동**: 특정 사람, 회사 또는 기회 기록으로 이동
2. **캘린더 탭 선택**: 이메일 탭 옆에 있는 `캘린더` 탭을 클릭합니다
3. **미팅 기록 탐색**: 예정된 모든 미팅과 그 세부정보 보기
4. **미팅 컨텍스트 접근**: 미팅 참가자, 시간 및 관련 정보 보기
## 가시성 설정
캘린더 데이터는 이메일과 동일한 가시성 설정을 따르며, 두 커뮤니케이션 채널 전반에서 일관된 개인정보 보호를 보장합니다.
## 동기화되는 내용
* **외부 미팅**: 조직 외부 연락처와의 모든 미팅
* **자동 연결**: 참석자의 이메일 주소를 기준으로 미팅이 기존 사람 및 회사 레코드에 연결됩니다
* **미팅 세부정보**: 제목, 시간, 기간, 참가자
* **업데이트**: 새로운 캘린더 이벤트가 자동으로 동기화됩니다
## 동기화되지 않는 항목
* **내부 미팅**: 동료끼리만의 미팅(동일 도메인)은 비공개로 유지됩니다
* **비공개 이벤트**: 캘린더에서 비공개로 표시된 이벤트

View File

@@ -0,0 +1,102 @@
---
title: 메일함
description: Twenty의 이메일 통합 기능 이해하기.
---
**참고**: 이메일 계정을 연결하고 동기화 설정을 구성하려면 [이메일 및 일정 설정](/l/ko/user-guide/calendar-emails/overview)을 방문하세요.
## 이메일 통합 작동 방식
Twenty는 연결된 메일함에서 메일을 자동으로 해당 CRM 기록에 연결하여 모든 커뮤니케이션 이력을 한 곳에 유지합니다.
### 이메일을 확인할 수 있는 객체
이메일 대화는 세 가지 주요 객체에 나타납니다:
* **사람들**: 특정 연락처와 교환한 모든 이메일 보기
* **회사**: 회사 및 직원과 관련된 모든 이메일 보기
* **기회**: 기회와 연결된 회사와 관련된 이메일 스레드에 접근합니다. 기회에 있는 개별 사람의 이메일 스레드는 아직 표시되지 않습니다.
### 이메일 스레드 보기
1. **기록으로 이동**: 특정 사람, 회사 또는 기회 기록으로 이동
2. **이메일 탭 선택**: 동기화된 이메일을 보려고 `이메일` 탭을 클릭하세요
3. **이메일 스레드 열기**: 전체 대화를 열고 읽으려면 이메일을 클릭하세요
4. **히스토리 탐색**: 해당 연락처와의 완전한 이메일 기록을 스크롤하여 확인하세요
<img src="/images/user-guide/emails/show-inbox.png" style={{width:'100%'}} />
## 볼 수 있는 내용
### 이메일 스레드 보기
이메일 스레드를 열면 다음을 할 수 있습니다:
* **전체 대화 읽기**: 전체 이메일 교환 보기
* **참여자 보기**: 이메일 스레드에 참여한 모든 사람 보기
* **타임스탬프 확인**: 각 이메일이 발송된 정확한 시간을 알기
* **컨텍스트 접근**: 전체 커뮤니케이션 이력 이해하기
### 이메일 가시성
메일함 설정에 따라 다음을 볼 수 있습니다:
* **전체 내용**: 이메일 텍스트 및 세부 내용 표시
* **제목 + 메타데이터**: 제목, 발신자, 수신자 및 타임스탬프
* **메타데이터만**: 이메일 내용 없이 기본 정보
## 이메일 동기화 행동
### 동기화 속도
Twenty는 분당 약 **400건의 메시지**를 가져옵니다. 이 속도는 현재 Gmail API의 속도 제한에 의해 제한됩니다(다른 제공업체에도 유사하게 적용됩니다).
참고:
* 이메일 1,000개 → ~2.5분
* 이메일 10,000개 → ~25분
* 이메일 50,000개 → ~2시간
### 동기화되는 내용
* **외부 이메일**: 조직 외부 연락처와의 모든 이메일
* **자동 연결**: 이메일이 기존 사람 및 회사 기록에 연결됩니다
* **다중 주소**: 모든 주소의 이메일이 동일한 연락처 기록에 연결됩니다
* **업데이트**: 새로운 이메일이 즉시 표시됩니다
### 동기화되지 않는 항목
* **내부 이메일**: 기본적으로 동료(동일 도메인) 간의 이메일은 비공개로 유지됩니다(설정 → 일반 → 보안에서 설정할 수 있습니다)
* **그룹 이메일**: 배포 목록 및 그룹 이메일은 제외됩니다
* **제외된 폴더**: 동기화하지 않도록 선택한 폴더 (설정 → 계정 → 이메일에서 구성됨)
### 내부 이메일
Twenty에서 내부 이메일을 동기화할지 선택하세요:
1. **설정 → 일반 → 보안**으로 이동하세요
2. **내부 이메일 동기화**를 켜거나 끄세요
### 선택적 폴더 동기화
Twenty와 동기화할 이메일 폴더 제어:
1. **설정 → 계정**으로 이동하여 연결된 이메일 계정을 선택하세요.
2. 이메일 섹션에서 폴더를 구성하세요.
3. 특정 폴더를 포함하거나 제외하기 선택 (받은 편지함, 보낸 편지함, 보관함, 사용자 지정 폴더)
## 이메일 동기화 문제 해결
### 일반 동기화 문제
* **동기화 지연**: 이메일은 즉시 표시되지만, 초기 가져오기는 더 오래 걸립니다
* **누락된 이메일**: 확인할 사항:
* 메시지 폴더 설정에서 폴더가 제외되어 있음
* 연락처 자동 생성이 비활성화됨(이메일에는 기존 Twenty 레코드가 필요함)
* 이메일은 동료 (같은 도메인) 또는 그룹 목록에서 검토 중이 아님
* 메일함이 초기 동기화를 완료하고 있음
### 이메일 제한 사항
* **시스템 폴더**: 일부 이메일 폴더는 동기화 가능하지 않을 수 있습니다
* **별칭**: 실제 메일함만 연결할 수 있습니다 (이메일 별칭은 안됨)

View File

@@ -0,0 +1,25 @@
---
title: Twenty에서 미팅을 예약할 수 있나요?
description: Twenty에서 직접 미팅을 예약하는 것에 대한 정보.
---
## 현재 상태
Twenty의 캘린더 통합은 기존 캘린더 이벤트를 **동기화하고 표시**하도록 설계되었습니다.
## 워크플로우를 통해 미팅 예약하기
미팅을 수동으로 예약할 수는 없지만, Twenty에서는 워크플로우를 사용해 예약할 수 있습니다.
1. 새 워크플로우 만들기
2. 필요에 따라 트리거를 선택하세요.
3. **Create Calendar Event** 노드를 추가하세요.
4. 필요한 모든 데이터를 설정하세요.
5. 워크플로우를 활성화합니다
## 가능한 작업
* 사람, 회사 및 기회 레코드에서 **미팅 기록 보기**
* CRM의 연락처와의 **예정된 미팅 보기**
* 이메일 커뮤니케이션과 함께 **미팅 맥락 추적**
* 미팅 참가자를 기반으로 **연락처 자동 생성**

View File

@@ -0,0 +1,53 @@
---
title: Twenty에서 이메일을 보낼 수 있나요?
description: Twenty에서 직접 이메일을 보내는 것에 대한 정보.
---
## 현재 상태
Twenty의 이메일 통합은 이메일 기록을 **동기화하고 표시**할 뿐만 아니라 이메일을 작성하고 전송할 수 있도록 설계되었습니다.
레코드 페이지에서 이메일 스레드를 보고 **Reply**를 클릭하면, 화면에서 바로 이메일을 작성하고 전송할 수 있습니다.
## Twenty에서 메시지를 보내는 방법
사전 조건: 이메일 발송이 가능한 연결된 메일 계정
1. **Ctrl+K** 또는 **Cmd+K** 단축키로 Command 메뉴를 엽니다
2. "Compose email" 옵션을 클릭합니다
3. 수신자를 선택하고, 이메일에 제목, 본문 및 첨부파일을 추가합니다
4. 이메일을 보내려면 "Send" 버튼을 클릭합니다
## 현재 가능한 작업
* 사람, 회사 및 기회 레코드에서 **이메일 기록 보기**
* CRM의 연락처와 주고받은 **전체 이메일 스레드 읽기**
* 캘린더 이벤트와 함께 **커뮤니케이션 맥락 추적**
* 이메일 상호작용에서 **연락처 자동 생성**
* **리디렉션을 통한 답장** — Reply를 클릭하여 사서함으로 이동
## 워크플로우를 통해 이메일 보내기
워크플로우를 사용하면 이메일을 **자동으로 전송할 수 있습니다**. 다음에 유용합니다:
* 자동 후속 조치
* 연락처에 대한 알림
* 레코드 변경을 기반으로 트리거되는 커뮤니케이션
워크플로우를 통해 전송된 이메일은 연결된 사서함 계정을 통해 발송됩니다.
→ [Send Email 액션](/l/ko/user-guide/workflows/capabilities/workflow-actions#send-email)에 대해 알아보기
## 이메일 시퀀스 및 뉴스레터
이메일 시퀀스와 뉴스레터의 경우, Twenty를 전용 이메일 마케팅 도구와 연결하기 위해 워크플로우를 사용할 것을 권장합니다.
<Warning>
도메인 평판을 보호하기 위해 대량 이메일은 사서함에서 직접 보내지 말아야 합니다. 대량 커뮤니케이션에는 전용 도구를 사용하세요.
</Warning>
→ 설정 방법은 [워크플로우에서 이메일을 보내는 방법](/l/ko/user-guide/workflows/capabilities/send-emails-from-workflows)을 참조하세요
## 향후 계획
Twenty 내에서의 네이티브 이메일 작성 기능은 로드맵에 포함되어 있습니다. 사용 사례를 공유하고 이 기능의 우선순위를 정하는 데 도움을 주기 위해 우리 [GitHub 토론](https://github.com/twentyhq/twenty/discussions)에 참여하세요.

View File

@@ -0,0 +1,35 @@
---
title: 모든 객체에서 이메일 활동을 추적할 수 있나요?
description: 다양한 객체 전반에서 이메일 활동이 어떻게 추적되는지 이해하기.
---
## 지원되는 객체
이메일 활동은 현재 **세 가지 표준 객체**에서 사용할 수 있습니다:
| 객체 | 볼 수 있는 내용 |
| ------- | ---------------------------------- |
| **사람들** | 해당 특정 연락처와 주고받은 모든 이메일 |
| **회사** | 해당 회사의 누구와 주고받은 모든 이메일(이메일 도메인 기준) |
| **기회** | 해당 기회에 연결된 회사와 관련된 이메일 |
## 왜 이러한 객체만 지원하나요?
사람들, 회사, 기회는 이메일 맥락이 가장 큰 가치를 더하는 핵심 관계 객체입니다. 이메일 스레드는 다음을 기준으로 자동 연결됩니다:
* **이메일 주소** → 사람 레코드와 매칭
* **이메일 도메인** → 회사 레코드와 매칭
* **회사 관계** → 기회와 연결
## 사용자 지정 개체
현재 **사용자 지정 객체에서는 이메일 추적을 사용할 수 없습니다**.
사용자 지정 객체에서 이메일 맥락이 필요하다면 다음을 고려하세요:
* 관계 필드를 사용하여 사용자 지정 객체를 사람 또는 회사에 연결
* 연결된 사람/회사 레코드에서 이메일 내역 보기
## 향후 계획
이메일 가시성을 사용자 지정 객체로 확장하는 방안을 검토 중입니다. 이 기능의 우선순위 결정을 돕기 위해 사용 사례를 [GitHub 토론](https://github.com/twentyhq/twenty/discussions)에 공유해 주세요.

View File

@@ -0,0 +1,42 @@
---
title: 사용자당 다중 메일박스 연결
description: 단일 사용자에 대해 여러 이메일 계정을 연결합니다.
---
## 개요
Twenty는 **사용자당 무제한 이메일 계정**을 지원합니다. 다음과 같이 여러 받은편지함을 관리하는 경우 유용합니다:
* 개인 업무용 이메일 + 팀 공유 받은편지함
* 고객 대응용 이메일 주소 여러 개
* 역할별로 서로 다른 이메일 계정
## 여러 메일박스를 추가하는 방법
1. **설정 → 계정**으로 이동
2. **계정 추가**를 클릭
3. Google 또는 Microsoft 계정을 추가로 연결하거나, IMAP/SMTP 프로토콜을 지원하는 다른 메일 제공업체의 계정을 연결하세요
4. 이 메일박스의 동기화 설정을 구성하세요
5. 연결하려는 각 메일박스에 대해 반복하세요
## 여러 계정 관리
연결된 각 메일박스에는 고유한 설정이 있습니다:
* **이메일 가시성**: 팀원이 볼 수 있는 범위 선택
* **연락처 자동 생성**: 메일박스별 사용/사용 안 함
* **폴더 선택**: 동기화할 폴더 선택
## 이메일 표시 방식
연결된 모든 메일박스의 이메일이 Twenty와 동기화되어 다음 위치에 표시됩니다:
* **사람 레코드**: 연락처의 이메일 주소 기준
* **회사 레코드**: 이메일 도메인 기준
* **기회**: 연결된 회사 기준
<Note>각 이메일에는 어떤 메일박스에서 발송되었는지 또는 어떤 메일박스로 수신되었는지가 표시되므로, 각 커뮤니케이션에 어떤 계정이 사용되었는지 추적할 수 있습니다.</Note>
## 중요 참고 사항
<Warning>실제 메일박스만 연결할 수 있습니다. 다른 메일박스로 전달되는 이메일 별칭은 별도로 연결할 수 없습니다 — 기본 메일박스를 통해 동기화됩니다.</Warning>

View File

@@ -0,0 +1,53 @@
---
title: 레코드에서 이메일이 보이지 않음
description: 레코드에서 누락된 이메일 문제 해결.
---
## 일반적인 원인
### 1. 초기 동기화가 아직 진행 중
이메일 동기화에는 시간이 걸리며, 특히 메일함이 큰 경우 더 오래 걸립니다. Twenty는 분당 약 **400건의 메시지**를 가져옵니다(이것은 Gmail API의 속도 제한에 의해 제한됩니다).
* **캘린더 동기화**: 몇 분 안에 완료됨
* **이메일 동기화**: 메일함 크기에 따라 달라짐 (예: 이메일 10,000개 ≈ 25분, 50,000개 ≈ 2시간)
**해결 방법**: 초기 가져오기가 완료될 때까지 기다리세요. 메일함 크기를 기준으로 소요 시간을 추정할 수 있습니다.
### 2. Twenty에 연락처가 존재하지 않음
이메일은 기존 사람 레코드에만 표시됩니다. 연락처가 아직 생성되지 않았다면:
* 메일함 설정에서 **연락처 자동 생성**을 활성화하세요
* 또는 먼저 사람 레코드를 수동으로 생성하세요
**해결 방법**: **Settings → Accounts**로 이동하여 메일함을 선택하고 연락처 자동 생성을 활성화하세요.
### 3. 내부 이메일은 제외됨
동료 간 이메일(같은 이메일 도메인)은 개인 정보 보호를 위해 절대 동기화되지 않습니다.
**해결 방법**: 이는 의도된 동작입니다. 외부 이메일만 동기화됩니다.
### 4. 그룹 또는 배포 목록에서 온 이메일
그룹 이메일과 배포 목록은 동기화에서 제외됩니다.
**해결 방법**: 이는 의도된 동작입니다.
### 5. 동기화 대상으로 폴더가 선택되지 않음
Message Folder 기능을 사용하는 경우 일부 폴더가 제외되어 있을 수 있습니다.
**해결 방법**: **Settings → Accounts**로 이동하여 메일함을 선택하고 폴더 동기화 설정을 확인하세요.
### 6. 레코드의 이메일 주소가 잘못됨
사람 레코드에 이메일에서 사용된 주소와 다른 이메일 주소가 등록되어 있을 수 있습니다.
**해결 방법**: 올바른 이메일 주소를 사람 레코드에 추가하세요.
## 아직도 작동하지 않나요?
1. 메일함 연결을 끊었다가 다시 연결해 보세요
2. 문제가 지속되면 지원팀에 문의하세요

View File

@@ -0,0 +1,58 @@
---
title: 가져오는 이메일 제한
description: 어떤 이메일을 Twenty로 가져올지 제어하세요.
---
## 개요
기본적으로 Twenty는 연결된 메일박스의 모든 외부 이메일을 동기화합니다. **폴더 선택**과 **표시 설정**을 사용하여 가져올 항목을 제한할 수 있습니다.
## 방법 1: 폴더 선택(권장)
Twenty와 동기화할 이메일 폴더 제어:
1. **설정 → 계정**으로 이동
2. 연결된 이메일 계정을 선택하세요.
3. 동기화할 폴더를 선택하세요:
| 폴더 | 설명 |
| ------------- | --------- |
| **받은 편지함** | 주요 수신 이메일 |
| **보낸 편지함** | 발송한 이메일 |
| **보관함** | 보관된 메시지 |
| **사용자 지정 폴더** | 원하는 특정 폴더 |
4. 동기화하지 않을 폴더를 제외하세요(스팸, 휴지통, 개인 폴더).
<Note>모든 이메일을 전부 동기화하지 않고도 CRM에 표시되는 이메일을 정확하게 제어할 수 있습니다.</Note>
## 방법 2: 연락처 자동 생성 설정
이메일에서 연락처를 생성할 시점을 제어하세요:
1. **설정 → 계정**으로 이동
2. 연결된 메일박스를 선택하세요.
3. 옵션을 선택하세요:
* **비활성화**: 연락처는 생성되지 않지만, 이메일은 기존 연락처와 계속 동기화됩니다
* **발신 및 수신**: 모든 외부 이메일에서 연락처를 생성합니다
* **발신만**: 사용자가 보낸 이메일에서만 연락처를 생성합니다
## 내부 이메일
동료 간 메시지(같은 도메인)는 Twenty에서 동기화할 수 있습니다:
1. **설정 → 일반 → 보안**으로 이동하세요.
2. **내부 이메일 동기화**를 켜거나 끄세요.
<Note>기본적으로 이 옵션은 꺼져 있습니다.</Note>
## 항상 제외되는 항목
설정과 관계없이 다음 이메일은 동기화되지 않습니다:
* **그룹 이메일**: 배포 목록 및 그룹 메시지
* **스팸/휴지통**: 시스템 폴더는 일반적으로 제외됩니다
## 중요 참고 사항
<Note>아직 선택적 동기화를 위한 CC 이메일 주소를 제공하지 않습니다. 위의 폴더 선택 기능을 사용하여 동일한 수준의 제어를 구현하세요.</Note>

View File

@@ -0,0 +1,144 @@
---
title: 캘린더 및 이메일
description: 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). 다른 메일박스로 전달되는 이메일 별칭은 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)