跳到主要内容

收到企业微信消息事件推送时

在企业微信的应用和企微用户产生交互的过程中，用户的某些操作会使得企微服务端通过事件推送的形式推送到开发者在开发者中心处设置的推送接收地址，从而开发者可以获取到该信息。企微的消息推送详情可见接收消息与事件。

您可以设置工作流在「收到企微消息事件推送时」触发，并使用收到的信息，操作您的业务数据，或进行消息回复。

配置项说明​

是否启用​

是否启用该触发方式，关闭后无法再接收微信消息事件推送和触发工作流。

接收推送 URL​

接收企微消息和事件的接口 URL。需要在将此 URL 填写至企微的应用管理后台，具体路径为：企微后台-应用管理-指定应用-接收消息-URL

企业ID​

企微的企业 ID，具体 ID 内容可以通过企微后台的企业信息中获取。

Token​

Token 用作生成签名，可手动填写或随机升成。该 Token 会和接口 URL 中包含的 Token 进行比对，从而验证安全性。需要填写至企微应用接收消息的服务器配置中，同接收推送 URL。

EncodingAESKey​

EncodingAESKey 可手动填写或随机生成，将用作消息体加解密密钥。需要填写至企微应用接收消息的服务器配置中，同接收推送 URL。

输出说明​

当前节点的 output 输出结构如下：

{
    "Encrypt": "<xml>...</xml>", //企微服务端推送的原文
    "Decrypt":"<xml>...</xml>"  // 将原文进行解密后的xml格式内容
    "DecryptJson":{          // xml协助转换为json数据格式后内容
        "CreateTime": 1703215311,
        "ToUserName": "toUser",
        "FromUserName": "fromUser",
        "MsgType": "event",
        "Event": "click",
        "AgentID": 102,
        ...
    }
}

调试​

调试方案提供了模拟消息推送和监听消息推送

  • 模拟消息推送由平台来模拟触发当前工作流，触发的事件为当前在模拟消息推送中选择的消息类型；
  • 监听消息推送由第三方来触发当前工作流。选择监听消息推送的情况下，需要将当前的监听调试URL填写到企微的后台推送URL中。调试URL用于当前工作流的编辑调试态，在正式发布后，需要将企微后台推送URL换成配置项中的URL；

示例说明​