Dify Agent可通过LangBot统一桥接或Webhook直连方式接入企业微信与钉钉。需满足管理员权限、Agent已发布并启用工具调用、Dify服务可公网访问三项前提；LangBot支持双平台一键配置；钉钉可选Webhook加签直连；企微需配置官方应用回调URL并启用Dify内置Webhook接收。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让Dify构建的AI Agent在企业微信和钉钉里直接响应员工提问、自动推送日报、处理会议预约等任务，无需开发接口、不写一行后端代码，仅靠平台配置与轻量部署即可完成双向消息互通。
接入前必须确认的三项前提
登录钉钉开放平台与企业微信管理后台，确认已拥有企业管理员权限；【未开通管理员权限将无法创建应用、获取凭证、配置机器人】。
已在Dify中完成Agent创建并发布为「生产环境」，且该Agent已启用「工具调用」能力（如需发送消息、读取群成员、操作日历等）。
确保Dify服务对外可访问——若为内网部署，需配置公网反向代理或使用内网穿透工具（如frp），LangBot或Webhook回调必须能直连Dify的API端点。
零代码接入：用LangBot统一桥接企业微信与钉钉
LangBot作为多IM协议适配器，支持同时对接企业微信+钉钉+飞书，避免为每个平台重复开发。
执行 docker run -d --name langbot -p 3000:3000 -e DIFY_API_BASE_URL=https://your-dify-domain.com -e DIFY_API_KEY=sk-xxx langbot/langbot:latest 启动服务。
访问 http://localhost:3000 进入LangBot控制台，点击「流水线」→「+新建」，名称填“Dify-Agent-Prod”，运行器选“Dify服务API”，填入Dify应用的API Base URL与API Key，应用类型选“Agent（含Tool Calling）”。
在「机器人」页签点击「+」，平台分别选择“企业微信”和“钉钉”，各填一次：企业微信侧填“CorpID”“Secret”“Token”“EncodingAESKey”（均来自企微管理后台→应用管理→自建应用）；钉钉侧填“AppKey”“AppSecret”（来自钉钉开放平台→凭证与基础信息）；绑定同一流水线。
保存后，LangBot会自动监听两个平台的事件回调。此时在企微/钉钉中添加对应机器人，私聊发送“你好”，即可触发Dify Agent响应——消息体、会话ID、用户身份均由LangBot自动注入并透传。
钉钉单点接入：Webhook方式直连Dify Agent
适用于已有钉钉自定义机器人、且不希望引入LangBot中间层的场景。
第一步：在钉钉群右上角⚙️→「机器人」→「添加机器人」→「自定义机器人」→安全设置选「加签」，复制生成的加签密钥和 webhook 地址末尾的 access_token。
第二步：登录Dify，进入目标Agent编辑页 → 左侧菜单「工具」→「添加工具」→ 搜索“DingTalk Bot” → 点击添加 → 在弹出配置框中填入刚才复制的 access_token 和加签密钥 → 保存。
第三步：返回Agent工作流画布，在「开始节点」右侧点击「+变量」，新增变量：dingtalk_chat_id（字符串，默认值留空）、dingtalk_sender_id（字符串，默认值留空）。这两个字段由钉钉回调自动注入，Dify Agent内部逻辑可直接引用。
第四步：在工作流任意节点中拖入「发送钉钉消息」工具，设置消息类型为“text”或“markdown”，内容模板中可用 {{user_message_text}} 获取原始提问，用 {{dingtalk_chat_id}} 确保回复到正确会话上下文。发布Agent后，钉钉群内 @机器人 提问，消息即被Dify接收并执行完整Agent流程。
企业微信原生接入：通过官方Webhook与Dify API联动
企业微信不支持加签模式的自定义机器人，必须使用「应用消息推送」机制，走企微服务器主动回调路径。
① 登录企业微信管理后台 → 应用管理 → 自建应用 → 创建新应用 → 记录“AgentID”“Secret”“CorpID”。
② 在应用详情页 → 「接收消息」开启，配置“Token”“EncodingAESKey”，并设置回调URL为：https://your-dify-domain.com/v1/chat-messages/webhook/wecom（该端点由Dify内置提供，无需额外开发）。
③ 回到Dify Agent编辑页 → 「设置」→「Webhook」→ 开启「启用Webhook接收」→ 勾选「企业微信」→ 粘贴上一步填写的Token与EncodingAESKey → 保存。
④ 企业微信后台点击「验证URL」，Dify将自动响应验签请求；验证通过后，所有群聊/私聊消息都会经企微服务器加密推送到Dify，由Dify Agent解析、执行、构造响应消息体，并调用企微API原路发回。
注意：企微消息体含敏感字段（如user_id、chatid），Dify会自动解密并映射为变量 wecom_user_id、wecom_chat_id，可在提示词或条件分支中直接使用。
