# Gmail与Pilotiko：邮件阅读、分类，并用您的邮箱地址回复

> 了解 Pilotiko 的 Gmail 连接会请求哪些权限（读取与发送邮件）、会读取什么内容、会保留哪些数据，哪些操作必须先经您同意才会执行，以及这项 Gmail 连接目前的上线状态。

更新于 2026年11月8日 · https://app.pilotiko.com/zh/integrations/gmail

企业的Gmail连接以只读方式读取您的邮件（24个月历史记录，随后是新邮件）、联系人和日历，让AI秘书对咨询进行分类并准备回复。它会用您的邮箱地址发送经人员批准的邮件。权限范围：gmail.readonly、gmail.send、contacts.readonly、calendar.readonly。状态：可用。

## 要点
- 企业邮箱请求的权限范围：gmail.readonly、gmail.send、contacts.readonly、calendar.readonly、openid 和 email。个人邮箱请求的权限范围：gmail.send、openid 和 email。
- 读取内容：所有标签下的邮件、您的联系人和日历，保存在您企业的记忆库中。Pilotiko不会在Gmail中修改、整理或删除任何邮件。
- 发送内容：仅限经人员批准的邮件（回复、确认、提醒）。
- 您可以在Pilotiko中一键撤销访问权限，之后也可在您的Google账户中撤销。

## Gmail连接有什么作用？

它授权Pilotiko读取您的邮箱、联系人和日历，并以您的名义发送邮件。AI秘书会对收到的邮件分类并准备回复；未经人员批准，任何邮件都不会发出。

Google将其权限分为三类。**gmail.send**权限范围被Google描述为“Send email on your behalf”，属于所谓的敏感范围 [1]。读取邮箱则通过**gmail.readonly**，这是一个受限范围，需要Google对应用进行验证和安全评估 [1]。Pilotiko为企业邮箱请求该权限。

读取涵盖所有标签下的邮件，先是最近24个月，随后是每封新邮件。邮件保存在您企业的记忆库中，并经自动分析（先规则，后AI模型）提取有用信息：客户咨询、已发送的报价、约会。Pilotiko不会在Gmail中修改、整理或删除任何邮件。

具体来说，连接器会撰写一封文本邮件（收件人、主题、正文），对其编码，并通过Gmail API的users.messages.send方法发送 [2]。Google将该方法描述为向To、Cc和Bcc标头中的收件人发送邮件 [2]。姓名和主题会经过清理，以防止通过恶意构造的客户姓名进行标头注入。

邮件绝不会因失误而重复发送：每封邮件都带有唯一密钥，10分钟内向同一收件人发送相同主题的邮件会被去重，故障后的重试采用递增的等待时间（1分钟、5分钟、30分钟）。

- **gmail.readonly**：读取您的邮件，只读。不修改，不删除。
- **contacts.readonly**和**calendar.readonly**：读取您的联系人和日历，只读。
- **gmail.send**：以您的名义发送邮件，仅限经人员批准之后。
- **openid**和**email**：确认关联的是哪个Google账户，并显示在“连接”页面上。
- **在Google读取的内容**：您的邮件、联系人和日历。您可以在“连接”页面选择读取哪些内容（邮件、联系人、日历）。
- **在Google写入的内容**：经批准、从您的邮箱地址发出的邮件。您的账户中不会有其他任何改动。
- **等待人员处理的内容**：凡不是源于已接受约会的邮件（报价、商业跟进、回复客户），都会作为草稿保留在Pilotiko中等待批准。

## 如何将Gmail连接到Pilotiko？

1. **打开“连接”页面** — 在Pilotiko中打开“连接”，进入“企业邮件”分组。如果Gmail卡片显示“需由Pilotiko启用”，说明该连接尚未对您的账户开放：不会显示虚假按钮。
2. **点击“连接”** — Pilotiko会将您带到Google的授权页面，并附带一个一次性安全参数，10分钟后失效。
3. **查看Google的页面** — Google会显示所请求的权限：读取您的邮件、联系人和日历，并以您的名义发送邮件。请使用代表企业的账户接受授权。
4. **选择Gmail作为发件人** — 如果关联了多个邮箱（Gmail、Outlook、Zoho Mail），请指明由哪一个代表企业发言。Pilotiko不会替您做选择。
5. **发送测试邮件** — 向团队的某个邮箱地址发送一条测试提醒，并在收件时核对发件人、主题和约会时间。

## Gmail目前有哪些功能可用或即将推出？

| 功能 | 状态 | 详情 |
|---|---|---|
| Google授权（OAuth 2.0 与 PKCE） | 可用 | 采用OAuth 2.0与PKCE流程。 |
| 发送约会确认 | 可用 | 经批准后，从您的邮箱地址发送。 |
| 提前24小时和1小时的提醒 | 可用 | 与确认邮件使用相同的发送路径。 |
| 收件箱的读取与分类 | 可用 | 只读（gmail.readonly），由AI秘书分类，准备好待批准的回复。 |
| 通讯邮件与营销序列 | 即将推出 | 不经由Gmail发送；同意与退订功能已具备，实际发送即将推出。 |

## 一周由Gmail发送的提醒是什么样的？

**示例：一家有3名治疗师的物理治疗诊所**

诊所每天有18个约会，每周5天。每个约会会触发一封确认邮件、一封前一天的提醒和一封一小时前的提醒。

这些邮件从诊所的邮箱地址发出，患者的回复会进入诊所惯用的Gmail邮箱。

- 每周约会数 : 18 × 5 = 90
- 每个约会的邮件数 : 3（确认、24小时提醒、1小时提醒）
- 每周邮件数 : 90 × 3 = 270
- 每个工作日的邮件数 : 270 ÷ 5 = 54
- **= 每个工作日约54封邮件，均从诊所的邮箱地址发出。**

## 您的数据会怎样，如何撤销访问权限？

Google提供的令牌在静态存储时已加密（AES-256-GCM），绝不会离开Pilotiko的服务器：它不会出现在日志、界面或错误信息中。读取到的邮件、联系人和事件会复制到您企业的记忆库中，仅限您企业中有权限的人员查看。

在魁北克，企业必须告知当事人收集的目的及其撤回同意的权利 [4]。同意必须是明确、自由、知情且针对特定目的而给予的 [4]。在这里，目的已写在Google的页面和本页中：读取您的邮箱以分类并准备您的工作，并发送您批准的内容。

要切断访问：在Pilotiko中，依次点击“连接”→Gmail→“断开连接”。令牌将被删除，Pilotiko从Gmail读取的内容（邮件、联系人、约会）将从记忆库中清除，但您企业的人员已确认的事实除外，且该操作会记入审计日志。随后，在您的Google账户中打开已关联应用页面，选择Pilotiko，再点击“删除访问权限” [3]。Google说明，删除之后，该应用将无法再访问该账户 [3]。

技术细节：请参阅[安全](/securite)页面和[隐私政策](/confidentialite)。

## Gmail连接有哪些限制？

- 不在Gmail中整理邮件：Pilotiko不会在您的邮箱中归类、归档或将任何邮件标记为已读（没有gmail.modify权限范围）；分类结果在Pilotiko中查看。
- 纯文本邮件：目前此途径暂不支持HTML排版或附件。
- 授权协议遵循PKCE标准（RFC 7636）[5]。
- 如果令牌过期且无法续期，卡片会变为“需重新连接”；不会悄悄发送任何内容。
- Outlook请参阅[Outlook / Microsoft 365集成](https://app.pilotiko.com/zh/integrations/outlook-microsoft-365)；托管于加拿大Zoho的邮箱请参阅[Zoho Mail集成](https://app.pilotiko.com/zh/integrations/zoho-mail)；短信请参阅[Twilio集成](https://app.pilotiko.com/zh/integrations/twilio)。

## 常见问题

### Pilotiko可以读取我的Gmail邮件吗？

可以，前提是您关联了企业邮箱：Pilotiko请求gmail.readonly（只读）、contacts.readonly和calendar.readonly。它读取内容是为了分类并准备回复，不会在Gmail中修改或删除任何东西。而个人邮箱仅请求发送权限（gmail.send）。

### 确认邮件现在已经从我的Gmail地址发出了吗？

是的，邮箱关联之后：每封确认邮件都从您的地址发出，必要时需经人员批准。

### 需要 Google Workspace 账户吗？还是免费的 Gmail 账户就够了？

Pilotiko 不强制要求购买任何 Google 套餐：它只会请求授权，以便从您选定的账户发送邮件。与通用邮箱地址相比，使用您自己域名的邮箱地址能让客户看得更清楚。

### 如果 Google 撤销了对 Pilotiko 的授权，会怎么样？

Gmail 卡片会变为“需重新连接”，并显示具体原因。待发送的邮件会继续留在队列中：只要没有收到 Google 的回复，Pilotiko 绝不会声称邮件已经发出。

### 我可以同时关联 Gmail 和 Outlook 吗？

可以，但只有一个邮箱能以企业名义发送邮件。如果关联了多个邮箱，Pilotiko 会请您选择用哪一个来发送确认邮件。

### 如何确认提醒确实已经发出？

只有在收到 Gmail 的确认并返回邮件标识符之后，Pilotiko 才会标记为“已发送”。没有这个标识符，发送就会被视为失败并稍后重试，绝不会被计为成功。

## 资料来源

1. Google for Developers, « Choose Gmail API scopes », https://developers.google.com/workspace/gmail/api/auth/scopes (查阅于 2026-10-15)
2. Google for Developers, « Method: users.messages.send (Gmail API) », https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/send (查阅于 2026-10-15)
3. Aide Compte Google, « Gérer les associations entre votre compte Google et les applications d'autres développeurs », https://support.google.com/accounts/answer/13533235?hl=fr (查阅于 2026-10-15)
4. LégisQuébec, « Loi sur la protection des renseignements personnels dans le secteur privé (RLRQ, c. P-39.1) », https://www.legisquebec.gouv.qc.ca/fr/document/lc/P-39.1 (查阅于 2026-10-15)
5. RFC Editor (IETF), « RFC 7636 : Proof Key for Code Exchange by OAuth Public Clients », https://www.rfc-editor.org/rfc/rfc7636 (查阅于 2026-10-15)
