把 AI 工作流接入现有 CRM 系统需要注意什么？

照着这篇做完，你能把 AI 工作流安全接进现有 CRM，既不撞 API 限流，也不让模型直接污染主数据。

第一步：先拿到数据模型和 API 凭据

这一步要做的是搞清楚 CRM 里哪些字段可读可写，并拿到调用凭据，做完你会得到一张字段映射表和一组 OAuth Token。

以 Salesforce 为例：登录后进入「设置（Setup）」→「平台工具」→「集成」→「API」，确认已启用 API；再到「应用程序」→「应用程序管理器」→「新建连接的应用程序」，勾选「启用 OAuth 设置」，回调地址填你的服务地址，Scope 至少勾 api 和 refresh_token。保存后拿到 Consumer Key 和 Consumer Secret。

HubSpot 则在「设置」→「集成」→「私有应用（Private Apps）」新建，Scope 勾 crm.objects.contacts.read、crm.objects.contacts.write、crm.objects.deals.read，一次性拿到 Access Token。

然后导出字段清单：Salesforce 用「设置」→「对象管理器」→ 选 Lead/Contact/Opportunity →「字段和关系」，把 API 名称（如 FirstName、Phone、StageName）抄进映射表，注意区分「标签名」和「API 名」，AI 只能认 API 名。

注意：别用管理员个人账号的 Session ID 做集成，密码一改就全挂。一律走 Connected App 或 Private App，并单独建一个集成专用账号。

第二步：设计触发点和回写点，别让 AI 直接写主数据

这一步要定下 AI 从哪里读、往哪写，做完你会有一条「建议先进中间对象、人工确认再回写」的链路。

在 Salesforce 新建自定义对象 AI_Suggestion__c，字段建议为：Source_Record__c（查找关系，指向 Lead）、Suggest_Type__c（选项列表：评分/摘要/下一步动作）、Confidence__c（数字 0-100）、Model_Version__c（文本）、Status__c（选项列表：待审核/已采纳/已驳回）。

触发用 Flow：「设置」→「流程自动化」→「Flow」→ 新建「记录触发流程」，对象选 Lead，触发条件设为「记录已创建或已更新」，动作调用「HTTP Callout」指向你的 AI 服务。

回写只在 Status__c 被改为「已采纳」时发生，用 Apex Trigger 或第二个 Flow 完成。

注意：不要给集成账号「修改所有数据」权限，只给 AI_Suggestion__c 的创建权限和 Lead 的读权限，回写由系统账号执行。

第三步：把幂等、并发和限流提前算清楚

这一步解决重复写入和调用超限，做完你能稳定跑批量任务而不被 CRM 封禁。

Salesforce 企业版的 API 请求上限是 24 小时滚动窗口内的配额，超出返回 REQUEST_LIMIT_EXCEEDED。批量场景改用 Bulk API 2.0，单个作业最多 1.5 亿条、每个批次默认 10000 条。

幂等靠外部 ID：给 AI_Suggestion__c 加一个「外部 ID」类型的字段 Ext_Job_Id__c，写入时用 upsert 并指定该字段，同一个任务 ID 重复提交只会更新不会新建。

重试策略用指数退避：失败后等 1s、2s、4s、8s、16s，最多 5 次；HTTP 400 类错误不要重试，直接落库标记失败。

注意：并发长请求（时长超过 20 秒）Salesforce 有单独上限，普通企业版约 10 个。AI 推理慢，务必把「调用模型」和「写回 CRM」拆成两个异步步骤。

第四步：脱敏、合规和审计留痕

这一步保证客户隐私不出边界，做完你能通过安全审查。

发给外部模型前，对手机号、邮箱、身份证做掩码或哈希：手机号保留后四位，邮箱只保留域名。Salesforce 可用「Shield 平台加密」或字段级审计；HubSpot 对删除请求要走 DELETE /crm/v3/objects/contacts/{contactId} 并同步调用 GDPR 删除接口。

每次 AI 调用把 Prompt_Version__c、Model_Version__c、Request_Time__c、Token_Cost__c 写进审计对象，出问题能回溯是哪一版提示词导致的。

第五步：先在沙箱灰度，再想好怎么回滚

这一步避免上线即事故。Salesforce 进入「设置」→「环境」→「沙箱」→「新建沙箱」，类型选 Developer，刷新间隔 1 天，先在沙箱跑通全链路。

灰度按负责人或记录类型放量，先开 5% 的记录，观察一周采纳率。回滚很简单：进入「设置」→「流程自动化」→「Flow」，把流程状态从「有效」切回「无效」，再批量把 Status__c 标为「已驳回」，主数据不受影响。

小结

• 凭据走 Connected App / Private App，别用个人 Session。
• AI 输出先进中间对象，人工确认后再回写主数据。
• 幂等键 + 指数退避，批量改用 Bulk API。
• 字段名一律用 API 名，标签名只给人看。
• 脱敏在前、审计在后，两个都不能省。
• 沙箱验证、按比例灰度、Flow 一键停用就是回滚方案。