Skip to main content

When Receiving WeChat Work Message Event Push

During interactions between the WeChat Work app and its users, certain user actions trigger the WeChat Work server to push events to the callback URL configured by the developer in the Developer Center, enabling the developer to receive this information. For details on message push, see Receiving Messages and Events.

You can configure the workflow to trigger upon receiving a WeChat Work message event push, and use the received information to process your business data or reply to messages.

Configuration Item Description​

Enabled​

Whether this trigger method is enabled. If disabled, it cannot receive WeChat Work message event push and trigger the workflow anymore.

Push URL​

The interface URL for receiving WeChat Work messages and events. This URL must be configured in the app management backend of WeChat Work. Specific path: WeChat Work backend - App Management - Specific App - Receive Messages - URL

CorpID​

The CorpID of WeChat Work. The specific CorpID can be obtained from the enterprise information in the WeChat Work backend.

Token​

The Token is used to generate signatures and can be manually entered or randomly generated. This Token will be compared with the Token contained in the interface URL to verify security. It must be configured in the server settings for message reception of the WeChat Work app, along with the push URL.

EncodingAESKey​

The EncodingAESKey can be manually entered or randomly generated, and will be used as the encryption and decryption key for message bodies. It must be configured in the server settings for message reception of the WeChat Work app, along with the push URL.

Output Description​

The output structure of the current node is as follows:

{
    "Encrypt": "<xml>...</xml>", // The original message pushed by the WeChat Work server
    "Decrypt":"<xml>...</xml>"  // XML-formatted content after decrypting the original message
    "DecryptJson":{          // Content after converting xml to json data format
        "CreateTime": 1703215311,
        "ToUserName": "toUser",
        "FromUserName": "fromUser",
        "MsgType": "event",
        "Event": "click",
        "AgentID": 102,
        ...
    }
}

Debugging​

The debugging solution provides simulated message push and monitoring message push.

  • Simulated message push is triggered by the platform to simulate the current workflow. The event triggered corresponds to the message type selected in the simulated message push.
  • Listening to message push is triggered by a third party to initiate the current workflow. When selecting this option, the current debugging URL must be configured as the callback URL in the WeChat Work backend. This debugging URL is used during the workflow's editing and debugging phase. After official release, the WeChat Work backend callback URL should be replaced with the URL specified in the configuration items.

Example Description​