在Dify中对接HubSpot CRM需完成OAuth2授权、三类对象对齐、阶段映射、多层级数据关联及LLM画像生成，最终通过HubSpot字段、钉钉推送或Dify看板交付结构化智能画像。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Dify中对接HubSpot CRM，让系统自动为销售漏斗各阶段客户生成结构化智能画像，需打通身份标识、阶段映射与AI推理链路。HubSpot的Contact、Deal、Company三类对象必须与Dify业务对象精确对齐，否则画像将缺失关键维度。
配置HubSpot OAuth2授权并获取访问令牌
进入HubSpot开发者门户（developers.hubspot.com），创建新应用，勾选contacts、deals、companies三项权限范围；复制Client ID和Client Secret。
在Dify控制台「Settings → Environment Variables」中新增变量：HUBSPOT_CLIENT_ID、HUBSPOT_CLIENT_SECRET、HUBSPOT_REDIRECT_URI（设为https://your-dify-domain.com/callback/hubspot）。
新建一个Custom Tool，类型选「OAuth2 Authorization」，填入上述变量，授权成功后Dify会自动存储access_token与refresh_token。⚠️【必须启用offline_access scope，否则token 1小时后失效，导致画像生成中断】
定义客户阶段映射规则与数据拉取逻辑
HubSpot的Deal Stage（如appointmentscheduled、qualifiedtobuy、proposal sent）需映射为Dify内部统一阶段标签。在Dify工作流中新建「Stage Mapping」JSON Schema：
{"appointmentscheduled":"商机识别","qualifiedtobuy":"方案制定","proposal sent":"谈判成交","closedwon":"签约客户"}
使用HTTP Request工具调用HubSpot Deal API：GET https://api.hubapi.com/crm/v3/objects/deals?properties=dealname,hs_pipeline_stage,amount,createdate&limit=100，Header中注入Authorization: Bearer {{access_token}}。
对每条Deal记录，通过关联Contact ID拉取对应联系人属性（如jobtitle、company、lastmeetingdate），再通过关联Company ID补全行业、员工规模等字段——这三重关联缺一不可，否则画像缺少组织级上下文。
构建客户智能画像生成工作流
第一步：从HubSpot同步的Deal数据触发工作流，提取hs_pipeline_stage值。
第二步：根据Stage Mapping表查出对应Dify阶段标签，例如proposal sent→谈判成交。
第三步：拼装客户上下文JSON，包含三个层级字段：
• 个体层（Contact）：职位、最近沟通时间、历史邮件打开率
• 关系层（Deal）：当前阶段、预估金额、竞对提及次数（从notes中NLP提取）
• 组织层（Company）：行业、年营收区间、技术栈（从网站自动识别）
第四步：将该JSON送入LLM节点，Prompt明确要求输出Markdown格式画像卡片，含「决策影响力评估」「当前阻力点」「下一步跟单建议」三段式结构。模型需固定为Qwen2.5-72B，因小模型无法稳定解析多源嵌套字段。
部署画像结果至销售看板与钉钉推送
方法一：调用HubSpot的Custom Object API，将生成的画像文本写入Deal对象的自定义字段ai_customer_profile，销售在HubSpot界面侧边栏实时查看。
方法二：配置Dify Webhook，当画像生成完成时，向钉钉群机器人发送富文本卡片，包含客户头像、阶段进度条、AI建议摘要及跳转HubSpot链接。
方法三：在Dify内置仪表盘中添加「漏斗阶段画像分布」图表，X轴为阶段标签，Y轴为“画像完整度”（字段填充率≥80%才计入），点击任一柱体可下钻查看原始画像详情。
