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,102 @@
---
title: 邮箱
description: 了解 Twenty 中的电子邮件集成功能。
---
**注意**:要连接您的电子邮件账户并配置同步设置,请访问[电子邮件和日历设置](/l/zh/user-guide/calendar-emails/overview)。
## 电子邮件集成如何运作
Twenty自动将来自您已连接邮箱的电子邮件链接到相关的CRM记录,将所有通信历史保存在一个位置。
### 包含电子邮件的对象
电子邮件会话出现在三个主要对象中:
* **联系人**:查看与特定联系人的所有电子邮件
* **公司**:查看与公司及其员工有关的所有电子邮件
* **Opportunities**: 访问与企业关联的电子邮件线程。 来自参与该商机的个人的电子邮件会话尚未显示。
### 查看电子邮件线程
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记录)
* 电子邮件来自同事(同一域)或群发列表
* 邮箱仍在完成初次同步
### 电子邮件限制
* **系统文件夹**:某些电子邮件文件夹可能无法同步
* **别名**:只能连接真实邮箱(而不是电子邮件别名)