跳到主要内容

配置通过企业微信接收个人消息

本文档介绍如何在 NineData 中配置企业微信个人消息接收渠道，以便您在任务流转的关键节点，通过企业微信个人渠道及时接收消息通知。

功能概述​

NineData 支持在控制台中为个人单独配置消息接收渠道。通过【个人消息接收】配置，您可以：

  • 为特定成员绑定专属的消息通知渠道（如企业微信个人消息）。
  • 在不影响系统默认订阅配置的前提下，接收更及时、更直观的个人通知。
  • 针对特定订阅类型与流程节点，启用或关闭个人渠道消息。

个人消息接收配置完成后，当相关任务在指定流程节点发生状态变化时，系统将同时通过默认订阅方式和个人消息渠道向目标成员发送通知。

前提条件​

  • 已创建或加入组织，并且该组织已开通数据库 DevOps 专业版或数据库 DevOps 企业版，同时请确保您的包年包月订阅未过期。更多信息，请参见管理组织。
  • 当前账号已切换到目标组织。更多信息，请参见切换到组织。
  • 已通过企业管理员账号登录企业微信管理后台。
  • 已准备好一个可用于发送消息的企业微信自建应用。
  • 已通过系统管理员权限账号登录 NineData 平台。

注意事项​

  • 本文实测使用的是手机号码作为通知字段，并已验证发送成功。实测中，使用登录名进行测试时返回 81013 user & party & tag all invalid，因此更推荐优先使用手机号码。
  • 企业微信侧除应用凭证外，还需要配置 Token、EncodingAESKey 和 API 接收消息中的回调地址。
  • 如果 NineData 测试消息发送报错 60020 not allow to access from your ip，请将报错信息中的来源 IP 加入企业微信应用的企业可信IP。本次测试环境实际加入的 IP 为 121.199.39.25。
  • 本文实测发现，企业微信 API 接收消息 页面的保存顺序建议为：先在 NineData 中完成测试并保存应用配置，再返回企业微信页面保存回调配置。

步骤一：准备企业微信应用信息​

  1. 登录企业微信管理后台，在应用管理中打开目标自建应用。

  2. 在应用详情页记录以下信息：

    • AgentId（对应 NineData 中的 应用 ID）
    • Secret（单击查看，再按提示发送到企业微信客户端中查看）

    personal_wecom_app_detail_20260311

  3. 确认可见范围中已包含目标接收成员。

  4. 单击企业可信IP右侧的配置，如后续测试报错 60020，请将 NineData 报错信息中返回的来源 IP 加入可信 IP 列表。

步骤二：在 NineData 中获取回调地址​

  1. 登录 NineData 控制台。

  2. 在左侧导航栏，单击消息中心 > 订阅管理，然后单击个人渠道管理页签。

  3. 在当前页签中找到企业微信个人渠道卡片，单击其下方的立即配置，打开配置企业微信渠道窗口。

  4. 在弹出的配置窗口底部记录回调地址，后续需要将该地址填入企业微信的API 接收消息配置页。

步骤三：在企业微信中生成 Token 和 EncodingAESKey​

  1. 返回企业微信应用详情页，在接收消息区域单击设置API接收。

  2. 在接收消息服务器配置页面中：

    • 在 URL 中填写步骤二记录的 NineData 回调地址。
    • 单击 Token 右侧的随机获取。
    • 单击 EncodingAESKey 右侧的随机获取。

  3. 记录刚刚生成的 Token 和 EncodingAESKey。

  4. 此时建议先不要立即保存，先返回 NineData 完成测试并保存绑定配置。

    personal_wecom_api_receive_20260311

步骤四：返回 NineData 完成测试并保存应用绑定​

  1. 回到 NineData 的配置企业微信渠道窗口，根据下表填写参数。

    参数说明
    企业 ID输入企业微信的 CorpID，通常为以 ww 开头的企业标识。
    AppSecret输入步骤一中获取的应用 Secret。
    应用 ID输入步骤一中记录的 AgentId。
    通知字段支持登录名、手机号码、邮箱。本次测试使用的是手机号码。
    Encoding AesKey输入步骤三生成的 EncodingAESKey。
    签名 Token输入步骤三生成的 Token。
    接收人信息填写目标企业微信成员的详细接收方式。本次测试填写的是接收成员的手机号码。

  2. 单击测试消息发送，确认页面提示测试通过，然后单击确定保存配置。

    personal_wecom_test_20260311

步骤五：返回企业微信保存 API 接收消息配置​

  1. 再次回到企业微信的API 接收消息页面。

  2. 填入与 NineData 中保存一致的如下信息：

    • URL：NineData 配置窗口中的回调地址
    • Token：NineData 中填写的签名 Token
    • EncodingAESKey：NineData 中填写的 Encoding AesKey

  3. 保持默认勾选的消息事件类型即可，然后单击保存。

  4. 若保存失败并提示回调地址请求不通过，请确认 NineData 侧是否已先使用相同的 Token 和 EncodingAESKey 完成保存，然后重试。

步骤六：启用订阅管理中的个人渠道​

个人渠道绑定完成后，还需要在订阅管理中启用，消息才会实际发送。

  1. 登录 NineData 控制台。

  2. 在左侧导航栏，单击消息中心 > 订阅管理。
  3. 在订阅管理页签，找到目标需要通知到企业微信个人渠道的订阅类型，在其右侧个人渠道列打勾即可。关于订阅管理的更多信息，请参见订阅管理。

配置完成后，当任务走到需要通知的节点时，配置了个人渠道的目标用户即可在其企业微信中收到消息提醒。

最后于 更新