将您的工作区连接到示例CRM，实现联系人、公司和交易数据的自动同步。本指南介绍如何启用集成、配置同步设置及排查常见问题。
开始之前
启用集成前，请确保具备以下条件：
要求 | 详情 |
管理员权限 | 您必须是工作区管理员或所有者才能启用集成 |
示例CRM账户 | 团队计划或更高级别的有效账户 |
启用API访问 | 在示例CRM中于设置 > 开发者 > API访问开启 |
已验证域名 | 您的发送域名必须验证以同步邮件活动 |
数据映射计划 | 首次同步前确定字段映射，避免重复数据 |
步骤1：找到集成
前往设置 > 集成。
在集成目录中搜索“示例CRM”。
点击连接。
提示时使用您的示例CRM凭据登录。
批准所请求的权限。
步骤2：选择同步内容
连接后，选择要同步的对象。每种对象类型的同步行为和刷新间隔不同。
对象 | 同步方向 | 默认刷新间隔 | 备注 |
联系人 | 双向 | 5分钟 | 默认按电子邮件地址匹配 |
公司 | 双向 | 15分钟 | 按域名匹配 |
交易 / 商机 | 单向（CRM到应用） | 15分钟 | 除非启用高级同步，否则只读 |
备注 | 单向（应用到CRM） | 实时 | 仅同步标记为“可共享”的备注 |
任务 | 双向 | 10分钟 | 需要任务同步附加组件 |
自定义对象 | 可配置的 | 可配置的 | 仅适用于企业计划 |
步骤3：配置字段映射
字段映射决定系统间数据的对应关系。错误映射是导致重复或缺失记录的最常见原因。
源字段（示例CRM） | 目标字段 | 数据类型 | 必填 |
| 名字 | 文本 | 是 |
| 姓氏 | 文本 | 是 |
| 主邮箱 | 邮箱 | 是 |
| 电话号码 | 电话 | 否 |
| 负责人 | 引用 | 否 |
| 生命周期阶段 | 枚举 | 否 |
| 交易金额 | 货币 | 否 |
| 最后活动日期 | 日期 | 否 |
| （未映射） | 文本 | 否 |
您可以在集成 > 示例CRM > 字段映射下添加自定义映射。未映射字段在同步时会被忽略，但仍可用于未来映射。
步骤4：设置同步规则
同步规则控制允许在系统间流动的数据，有助于防止不必要的覆盖。
规则 | 启用时的行为 | 禁用时的行为 |
冲突时覆盖 | 以最近更新的记录为准 | 现有应用数据永不被覆盖 |
同步已删除的记录 | 任一系统删除即两边删除 | 两系统删除必须手动操作 |
合并重复联系人 | 自动合并邮箱匹配项 | 重复项标记供人工审核 |
同步历史数据 | 首次同步回填最多24个月历史 | 仅同步后续新增活动 |
按团队限制 | 仅同步所选团队拥有的记录 | 同步所有记录，无论归属 |
步骤5：开启集成
检查对象选择、字段映射和同步规则。
点击启用同步。
首次同步可能需几分钟到数小时，视数据量而定。
首次同步完成后您将收到通知。
同步状态参考
状态 | 含义 | 需要操作 |
激活 | 同步正常运行 | 无 |
已暂停 | 管理员手动暂停同步 | 从集成设置恢复 |
错误 – 认证 | API 凭证已过期或被撤销 | 重新连接集成 |
错误 – 速率限制 | 向 Example CRM 发送请求过多 | 等待自动重试，或联系支持 |
错误 – 映射冲突 | 必填字段未映射或不匹配 | 检查字段映射设置 |
部分完成 | 部分对象同步成功，部分失败 | 查看同步日志了解详情 |
常见问题
联系人未同步 请确认联系人有有效且非重复的邮箱。默认跳过无邮箱联系人。
出现重复公司 通常是公司匹配依赖名称而非域名。请到字段映射确认现有记录的域名字段已填写。
同步卡在“初始化” 大账户（5万+记录）首次同步可能需数小时。超过12小时请联系支持并提供工作区ID。
同步后部分字段为空 请确认步骤3中字段已映射。未映射字段无论源数据如何均显示为空。
禁用集成
前往设置 > 集成 > Example CRM。
点击断开连接。
选择是保留之前同步的数据还是删除它。
确认断开连接。
断开连接不会删除已同步的记录，除非您明确选择该选项。
相关文章
在Example CRM中设置API访问
管理重复记录
了解同步日志和错误代码
高级同步插件概述
内容
