9c249c766b
Created by Github action <!-- This is an auto-generated description by cubic. --> <a href="https://cubic.dev/pr/twentyhq/twenty/pull/21746?utm_source=github" target="_blank" rel="noopener noreferrer" data-no-image-dialog="true"><picture><source media="(prefers-color-scheme: dark)" srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img alt="Review in cubic" src="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a> <!-- End of auto-generated description by cubic. --> Co-authored-by: github-actions <github-actions@twenty.com>
145 lines
6.2 KiB
Plaintext
145 lines
6.2 KiB
Plaintext
---
|
||
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 上(例如局域网中的本地部署服务器),与其的连接将会被阻止。 要允许这些连接,请在服务器上设置以下环境变量:
|
||
|
||
```
|
||
OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
|
||
```
|
||
|
||
这会为**所有**出站请求(HTTP 工作流操作、Webhook,以及 IMAP/SMTP/CalDAV 连接)禁用安全模式,因此只应在无需 SSRF 保护的受信任、隔离网络中进行此设置。
|
||
</Note>
|
||
|
||
### 多个邮箱
|
||
|
||
* **无限账户**:每用户可连接多个电子邮件账户
|
||
* **账户管理**:在不同邮箱之间切换
|
||
* **同步设置**:为各邮箱配置不同设置
|
||
|
||
<Warning>
|
||
只能连接真正的邮箱(如:support@domain.com及其独立收件箱)。 电子邮件别名转发到其他邮箱不能连接到Twenty。
|
||
</Warning>
|
||
|
||
## 电子邮件配置
|
||
|
||
### 邮件可见性
|
||
|
||
为您的电子邮件选择不同的可见性级别:
|
||
|
||
* **仅元数据**:仅分享基本信息(发件人、收件人、日期、时间)
|
||
* **主题和元数据**:分享主题行以及元数据
|
||
* **所有电子邮件内容**:分享全部电子邮件内容,包括附件
|
||
|
||
### 联系人自动创建
|
||
|
||
* **已停用**:无自动联系人创建
|
||
* **用于发送和接收的消息**:为所有外部电子邮件互动创建联系人
|
||
* **仅用于发送的消息**:仅为您发送的电子邮件创建联系人
|
||
* **注意**:默认情况下,内部电子邮件(所有参与者都使用你的域名)不会被同步,以保护隐私
|
||
|
||
<Note>启用后,联系人会根据其电子邮件域名自动关联到其公司记录。 如果该公司尚不存在,Twenty 会为您创建该公司。</Note>
|
||
|
||
<Note>
|
||
**同步内部电子邮件**:"未同步内部电子邮件" 的行为是默认设置,但可以关闭。 该切换位于高级设置中:
|
||
1. 打开 **设置**,并在设置页面底部启用 **高级** 切换开关
|
||
2. 转到 **常规 → 安全**
|
||
3. 启用 **同步内部电子邮件** 切换开关,以包含所有参与者共享同一域名的电子邮件
|
||
|
||
这是一个针对整个工作区的设置(对大学或共享域组织非常有用)。
|
||
</Note>
|
||
|
||
### 通过消息文件夹选择控制哪些电子邮件同步
|
||
|
||
控制哪些电子邮件文件夹与Twenty同步:
|
||
|
||
1. 前往**设置 → 账户**并选择您已连接的电子邮件账户
|
||
2. 选择要同步的文件夹:
|
||
* **收件箱**:主要的收入电子邮件
|
||
* **已发件箱**:您发送的外发电子邮件
|
||
* **自定义文件夹**:您希望包含的任意特定文件夹
|
||
* **排除文件夹**:跳过像垃圾邮件、垃圾桶或个人文件夹这样的文件夹
|
||
|
||
这样您无需同步所有内容,即可精确控制哪些电子邮件会出现在您的客户关系管理系统中。
|
||
|
||
**同步内容**:
|
||
|
||
* **外部电子邮件**:所有具有外部联系人的电子邮件来自选择的文件夹
|
||
* **内部电子邮件**:默认不进行同步(同域邮件保留隐私)。 在 **设置** 底部启用 **高级** 切换开关,然后在 **常规 → 安全** 下打开 **同步内部电子邮件**,即可在整个工作区内将其包含在内。
|
||
* **附件**:2026年H1推出
|
||
|
||
**注意**:我们不提供选择性同步的CC电子邮件地址。 相反,使用上述消息文件夹功能来实现同样水平的电子邮件同步控制。
|
||
|
||
## 日历配置
|
||
|
||
### 事件可见性
|
||
|
||
选择其他用户在您的工作区中可见的内容:
|
||
|
||
* **全部**:整个事件详情将与您的团队共享
|
||
* **元数据**:仅日期和参与者将与您的团队共享
|
||
|
||
### 会议的联系人自动创建
|
||
|
||
* **是**:自动为非CRM中的会议参与者创建联系人
|
||
* **否**:仅将会议链接到现有联系人
|
||
|
||
<Note>启用后,联系人会根据其电子邮件域名自动关联到其公司记录。 如果该公司尚不存在,Twenty 会为您创建该公司。</Note>
|
||
|
||
### 控制哪些事件同步
|
||
|
||
* **会议导入**:自动导入日历事件
|
||
* **联系人链接**:将会议链接到人员和公司记录
|
||
|
||
**同步内容**:
|
||
|
||
* **会议**:包含外部参与者的日历事件
|
||
* **联系人链接**:事件自动链接到CRM记录
|
||
* **团队事件**:共享日历可见性
|
||
|
||
## 同步频率
|
||
|
||
**每5分钟更新**:电子邮件和日历数据在首次导入后每5分钟自动同步。
|
||
|
||
<Note>
|
||
**初始同步耗时**: 日历同步完成很快 (通常在几分钟内),而对于大型邮箱,邮件同步耗时更长。 Twenty 以约**每分钟 400 封**的速度导入邮件 (受 Gmail API 速率限制),因此包含 10,000 封邮件的邮箱大约需要 25 分钟。 如果您看到来自日历事件的联系人早于电子邮件联系人出现,请不必担心;这是正常行为。
|
||
</Note>
|
||
|
||
## 下一步
|
||
|
||
* [邮箱功能](/l/zh/user-guide/calendar-emails/capabilities/mailbox)
|
||
* [排查缺失的电子邮件](/l/zh/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records)
|