企业微信应用消息与通讯录配置¶

使用企业微信自建应用后，智能体可以向应用可见范围内的成员发送应用消息并查询通讯录。需要企业微信消息触发 MOI 时，再配置消息回调。

准备企业微信自建应用¶

需要能够登录企业微信管理后台并管理自建应用。没有管理员权限时，请由管理员创建应用并提供同一应用的 CorpID、AgentID 和 Secret。

打开 应用管理 > 应用管理。

在“自建”区域点击 创建应用。

填写应用名称，例如“MOI 通知”；在 可见范围 中至少选择用于测试的成员，然后点击 创建应用。

在 我的企业 > 企业信息 中复制“企业 ID”，它对应 MOI 的 CorpID。

回到 应用管理 > 应用管理，打开刚创建的应用。复制 AgentId 和 Secret；它们分别对应 MOI 的 AgentID 和 Secret。

返回 资源中心 > 工具库 > 企业微信，点击 新增 > 应用消息/通讯录。

填写名称、CorpID、AgentID 和 Secret。需要接收消息回调时，再点击生成创建 Callback Token；只有在企业微信使用加密消息时才生成 EncodingAESKey。

点击保存后测试连接。测试通过表示 MOI 可以使用当前 CorpID、AgentID 和 Secret 调用企业微信应用接口；它不表示消息已经送达成员。

只有需要“企业微信中的新消息触发智能体或任务”时，才配置这一部分。

保存实例后，进入实例详情并复制 公网回调 URL。
编辑实例，为 Callback Token 点击生成并复制值。企业微信使用加密模式时，同时生成并复制 EncodingAESKey。

在 MOI 生成回调校验值。¶
在企业微信自建应用的“接收消息”设置中填入公网回调 URL、Callback Token，以及需要时的 EncodingAESKey，完成地址校验。
回到 MOI 实例详情，新增一条转发规则，选择收到消息后要触发的智能体或任务。
用企业微信向该应用发送一条测试消息，确认目标被触发。

将实例绑定到目标智能体，要求它向可见范围内的测试成员发送一条消息，再在企业微信客户端确认收到消息。

现象	先检查	下一步
连接测试失败	CorpID、AgentID、Secret 是否来自同一企业和同一应用	重新复制三个值；检查应用权限和可信 IP 设置。
无法发送消息	测试成员是否在应用可见范围	把成员加入可见范围后重试。
回调地址校验失败	回调 URL、Callback Token、EncodingAESKey 是否来自同一实例	重新复制；明文模式不要填写 EncodingAESKey。
已校验但没有触发	MOI 是否已有启用的转发规则	新增规则并指定目标智能体或任务。

最后更新于 2026 年 9 月 9 日