必须完成认证接入、字段映射、评分规则配置和动作编排四环节：先在zoho developer console创建crm应用获取client id/secret及grant token，再在dify配置oauth2工具并授权连接，接着用http节点拉取线索数据并结构化映射字段，然后通过python节点按规则计算分数，最后用条件分支触发企业微信通知、延时邮件或归档培育。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中自动识别新线索的优先级并触发对应跟进动作，比如高分线索立刻发企业微信通知、中等线索延后2小时推送邮件、低分线索归档进待培育池，必须让Dify能实时读取Zoho CRM中的线索数据并执行评分逻辑。这需要完成认证接入、字段映射、评分规则配置和动作编排四个关键环节。
获取Zoho CRM API访问凭证
登录Zoho Developer Console（https://api-console.zoho.com），进入「Projects」→「Create New Project」，选择「CRM API」作为应用类型。
填写应用名称（如“Dify-Sales-Orchestrator”）、重定向URI（填Dify工作流回调地址，例如https://your-dify-domain.com/callback/zoho），勾选zohocrm.users.ALL和zohocrm.modules.ALL权限。
创建完成后，在「Client Configuration」页复制【Client ID】和【Client Secret】——这两个值后续在Dify中配置OAuth2工具时必须严格一致，输错一个字符会导致整个集成失败且无明确报错提示。
点击「Generate Grant Token」，跳转到Zoho账号授权页，用拥有CRM管理员权限的账号完成授权，页面将返回一个临时的【Grant Token】，有效期仅10分钟，需立即复制保存。
在Dify中创建Zoho CRM连接工具
进入Dify控制台 → 「Settings」→ 「Tools」→ 「+ Add Tool」→ 选择「OAuth2」类型。
填写工具名称为“Zoho CRM Connector”，在「Authorization URL」栏填入https://accounts.zoho.com/oauth/v2/auth，在「Token URL」栏填入https://accounts.zoho.com/oauth/v2/token。
粘贴上一步获取的Client ID与Client Secret；将「Scope」设为ZohoCRM.modules.ALL；「Redirect URL」必须与Zoho控制台中填写的完全一致，包括末尾斜杠与否。
保存后点击「Authorize」，Dify会跳转至Zoho登录页，输入管理员账号完成授权，成功后自动返回并显示「Connected」状态。
Dify 3.9.2更新重点增强系统安全性，引入 Chainguard 安全基础镜像并同步社区版 CVE 修复，同时优化 OpenSearch 向量存储兼容性、插件参数传输机制及 Helm 部署配置。新增工作流模型节点缓存能力，可减少重复凭证查询，显著提升复杂工作流初始化速度，为企业级 AI 应用提供更稳定、高效的运行体验。
配置线索数据拉取与结构化处理
新建一个Workflow，在「Nodes」中添加「HTTP Request」节点，选择刚创建的Zoho CRM Connector作为认证方式。
设置请求方法为GET，URL为https://www.zohoapis.com/crm/v5/Leads?fields=id,Company,Email,Phone,Lead_Status,Annual_Revenue,City,Industry,Created_Time&sort_by=Created_Time&sort_order=desc&per_page=200——这里必须显式声明fields参数，否则Zoho默认只返回id和模块名，缺失关键评分字段会导致后续逻辑全部失效。
在「Response Parsing」中启用JSON解析，并添加字段映射规则：将Zoho返回的Annual_Revenue映射为Dify内部字段revenue，Industry映射为industry，City映射为city；未映射字段将被丢弃。
添加「Python Code」节点，编写评分逻辑：对每条线索计算得分（示例规则：年营收≥100万加30分，行业属金融/医疗加20分，有手机号加10分，城市为北上广深加15分），输出带score字段的结构化列表。
按分数段触发差异化跟进动作
方法一：使用条件分支节点
在评分节点后添加「Condition」节点，设置判断路径：score >= 65 → 高优先级路径；score >= 40 and score → 中优先级路径；其余 → 低优先级路径。
高优先级路径接「Webhook」节点，目标URL为企业微信机器人地址，消息体包含线索公司名、联系人、评分及直达CRM记录页的链接；中优先级路径接「Delay」节点（延迟7200秒）→「Email」节点（调用SMTP工具发送定制模板）；低优先级路径接「Database Insert」节点，写入Dify内置知识库的“待培育线索”表。
方法二：用单个HTTP Request调用Zoho CRM更新接口
构造PATCH请求到https://www.zohoapis.com/crm/v5/Leads/{lead_id}，Body中动态填入{"data":[{"$se_module":"Leads","id":"{lead_id}","Score":{score},"Followup_Status":"{status}"}]}，其中status根据score映射为“Immediate Action”/“Scheduled Review”/“Nurture Queue”；此方式不依赖外部服务，但需确保Zoho CRM字段Score和Followup_Status已在后台启用并设为可编辑。
