本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版。Dify 通过你在企业微信管理后台创建的自建应用接入企业微信。该应用:
- 向成员发送请求,每条请求都是一条带链接的文本消息,链接指向 Dify 中的表单。
- 让 Dify 读取有权使用该应用的成员。
开始之前
企业微信只接受来自特定 IP 地址的调用,这些地址要由你添加到应用中。添加 IP 之前,企业微信会要求你验证一个公司名下的域名。确认以下几点:- 你是企业微信组织的管理员,或能与管理员配合操作。
- 你知道 Dify 服务器发出请求时使用的公网 IP 地址。企业微信看到的就是这个地址,它可能与 Dify 域名指向的地址不同。在服务器上运行
curl ifconfig.me即可查看。 - 你有一个公司名下的域名,其 ICP 备案主体为你的公司或关联公司,并且你能在该域名网站的根目录下放置文件。
CONSOLE_WEB_URL已设为成员能打开的地址,因为每条消息中的链接都指向这里。
创建应用
在 企业微信管理后台 中进入 应用管理 > 应用,在 自建 下点击 创建应用。然后:- 上传 应用logo,并在 应用名称 中填写成员能认出的名称,例如「Dify」:成员会看到请求来自这个名称的应用。
- 在 可见范围 中点击 选择部门 / 成员,选中所有需要接收请求的人。然后点击 创建应用。
信任 Dify 服务器的 IP
- 在应用页面找到 企业可信IP,点击 配置。
-
在弹出的对话框中点击 设置可信域名,然后:
- 在第一个 可信域名 框中填写公司的域名。
- 点击底部的 申请校验域名,下载校验文件,放到该域名网站的根目录下。
- 点击 确定。
- 回到 企业可信IP > 配置,填入 Dify 服务器的公网 IP 地址并保存。 等待约 1 分钟让设置生效,再到 Dify 中连接。
在 Dify 中连接
-
在 设置 > 渠道 中找到企业微信,点击 连接。
如果已连接其他 IM(即时通讯应用),改为点击 替换。操作前先了解 替换会清除哪些内容。
-
填入企业微信中的以下信息:
- Corp ID:管理后台 我的企业 页面底部的 企业ID。
- Agent ID:应用页面上的 AgentId。
- Secret:在应用页面点击 Secret 旁的 查看,再点击 发送。企业微信会通过 企业微信团队 发来一条消息,在企业微信中打开该消息并点击 前往查看。
在企业微信中更改其中任何一项后,都要在 Dify 中同步更新。 - 点击 连接。Dify 会先检查连接,再保存。
同步并绑定成员
-
在 渠道 中点击 立即同步。同步到的所有成员都会归入 未匹配。
Dify 当前不支持自动匹配企业微信成员。
- 在 联系人 中 逐一手动绑定成员,先绑定你自己,以便测试。如果有两位成员同名,可根据各自下方显示的企业微信用户 ID 区分。
发送测试请求
绑定你自己的 IM 身份后,给自己发一条测试请求:- 如需快速确认消息能否送达,使用人工介入节点 消息模板 中的 测试消息:在 测试渠道 中选择企业微信,点击 保存并测试。这会直接把消息发给你,不运行工作流。
- 如需检查完整流程,在该节点中开启调试模式,选择企业微信,然后测试运行工作流。收到消息后,打开链接,登录并响应,确认运行继续进行。
成员看到的内容
每条请求都是应用发来的一条文本消息,根据节点的 消息模板 生成:先是主题,然后是带链接的正文。
以企业微信消息形式发送的请求
故障排除
连接失败,API 错误码为 60020
连接失败,API 错误码为 60020
企业微信不接受来自 Dify 服务器 IP 地址的请求。在 企业可信IP 中 添加服务器的公网 IP,等待约 1 分钟后再次点击 连接。如果已添加过地址,确认它就是 Dify 服务器发出请求时使用的地址。
连接时提示「WeCom rejected the credential test」
连接时提示「WeCom rejected the credential test」
企业 ID 或 Secret 有误。从 我的企业 复制 企业ID,并从你的应用复制 Secret。
连接时提示「WeCom could not verify the configured corporation directory boundary」
连接时提示「WeCom could not verify the configured corporation directory boundary」
AgentId 有误,或与 Secret 不属于同一个应用。从同一个应用复制 AgentId 和 Secret。
测试请求发送失败
测试请求发送失败
Dify 发不出请求:测试消息 提示「测试失败,请检查渠道配置后重试。」,或调试模式下的运行失败并提示「No one can approve this step.」。检查以下几项:
- 你自己的 IM 身份已绑定。
- 你在应用的 可见范围 内。
- Dify 服务器当前的公网 IP 已在 企业可信IP 中。
同步失败,或配置成功后不再收到消息
同步失败,或配置成功后不再收到消息
通常是 Dify 服务器的公网 IP 变了,企业微信不再接受其请求。如需确认,在 渠道 中打开企业微信的设置,点击 测试连接。如果错误码是 60020,在 企业可信IP 中添加新的 IP。