同步 Google/Outlook 联系人
连接您的 Google Workspace 或 Microsoft 365 账户后，即可将 Google 通讯录（People API）或 Outlook（Microsoft Graph）中的联系人导入为 CRM 联系人，不会重复，也不会覆盖您已填写的信息。
联系人同步使用与邮件和日历相同的 OAuth 连接（自带模型：OAuth 应用归属于您的组织）。它会将您在服务商处的联系人带入 CRM，成为联系人记录。
前提条件：授予联系人访问权限
连接 Google Workspace 或 Microsoft 365 时，CRM 现在会同时请求联系人权限（Google：contacts；Microsoft：Contacts.ReadWrite），除了邮件和日历权限之外。如果您在此次更新之前就已连接账户，该连接不包含联系人权限：打开“设置 → 集成”，在服务商卡片上点击“重新连接”并授予联系人权限。届时“联系人同步（双向）”区域会显示“同步中”。
💡 在您组织的 OAuth 应用中，请确认已启用联系人权限：在 Google 上，启用 People API；在 Azure 上，为 Microsoft Graph 添加委派权限 Contacts.ReadWrite。
导入联系人（服务商 → CRM）
- 打开“设置 → 集成”，找到已连接的服务商卡片。
- 在“联系人同步（双向）”区域，点击“导入联系人”。
- CRM 会读取您的联系人（每次最多 200 个），并为每个联系人创建或更新一条联系人记录。系统会报告读取、创建和更新的数量。
匹配和去重的原理
匹配的键是联系人的邮箱：如果已存在具有相同邮箱的联系人，则更新而不是重复创建；否则会创建新联系人。CRM 还会在记录本身中存储服务商的联系人 id，作为额外的去重保障。更新现有联系人时，CRM 只会填写空白字段，绝不会覆盖您在 CRM 中已调整过的姓名、电话或职务。
💡 没有邮箱的联系人在导入时会被跳过，因为邮箱是联系人的必填项，也是用于避免重复的键。请在服务商联系人中添加邮箱以便导入。
将 CRM 联系人发送到服务商（CRM → 服务商）
您也可以在 Google/Outlook 中创建 CRM 联系人（尽力而为）。发送后，CRM 会保留链接，以避免在未来发送时重复创建同一联系人。此方向是可选的，且仅在已授予联系人权限时生效。
没有连接？该功能保持静默
如果您尚未连接账户（或未授予联系人权限范围），系统不会导入或发送任何内容，也不会在您的工作流程中产生错误。只有在存在具备联系人权限的活跃连接时，导入按钮才会出现。
如何测试
- 在“设置 → 集成 → 已连接服务商卡片”的“联系人同步（双向）”区域，点击“导入联系人”。
- 查看显示的摘要：读取、创建和更新了多少联系人。
- 打开 CRM 的联系人列表，检查您在 Google/Outlook 中已知的联系人是否出现（或被更新）而没有重复。
故障排查
- “导入联系人”按钮未出现：没有具备联系人权限的连接。在卡片上点击“重新连接”并授予联系人权限（Google：contacts / People API；Microsoft：Contacts.ReadWrite）。
- 部分联系人未导入：没有邮箱的联系人会被跳过（邮箱为必填项，也是去重的键）。请在服务商联系人中添加邮箱后重新导入。
- 我已经调整过的联系人被“覆盖”了：这种情况不应发生。导入只会填写空白字段，绝不会覆盖您编辑过的姓名/电话/职务。如果发现被覆盖，请携带该联系人信息向支持团队报告。
- 403/权限不足：未授予联系人权限范围；请重新连接并在授权页面接受该权限。在 Google 上，请确认 OAuth 应用中已启用 People API。