概述-使用接收消息

开启接收消息模式后，企业微信会将消息发送给企业填写的URL，企业后台需要做正确的响应。

接收消息协议的说明

企业微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次。如果企业在调试中，发现成员无法收到被动回复的消息，可以检查是否消息处理超时。

当接收成功后，http头部返回200表示接收ok，其他错误码企业微信后台会一律当做失败并发起重试。

关于重试的消息排重，有msgid的消息推荐使用msgid排重。事件类型消息推荐使用FromUserName + CreateTime排重。

假如企业无法保证在五秒内处理并回复，或者不想回复任何内容，可以直接返回200（即以空串为返回包）。企业后续可以使用主动发消息接口进行异步回复。

接收消息请求的说明

假设企业的接收消息的URL设置为http://api.3dept.com。

企业收到消息后，需要作如下处理：

对msg_signature进行校验

解密Encrypt，得到明文的消息结构体（消息结构体后面章节会详说）

如果需要被动回复消息，构造被动响应包

正确响应本次请求

以上1~2步骤可以直接使用解密函数一步到位。
3步骤其实包含加密被动回复消息、生成新签名、构造被动响应包三个步骤，可以直接使用加密函数一步到位。

文档ID: 12977
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90238

请求参数

Query 参数

msg_signature

string

必需

示例值:

ASDFQWEXZCVAQFASDFASDFSS

timestamp

string

必需

示例值:

13500001234

nonce

string

必需

示例值:

123412323

Body 参数application/xml

ToUserName

string

必需

企业微信的CorpID，当为第三方应用回调事件时，CorpID的内容为suiteid

AgentID

string

必需

接收的应用id，可在应用的设置页面获取。仅应用相关的回调会带该字段。

Encrypt

string

必需

消息结构体加密后的字符串

示例

<?xml version="1.0" encoding="UTF-8"?>
<xml>
  <ToUserName>string</ToUserName>
  <AgentID>string</AgentID>
  <Encrypt>string</Encrypt>
</xml>

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

Encrypt

string

必需

经过加密的消息结构体

MsgSignature

string

消息签名

必需

TimeStamp

string

时间戳

必需

Nonce

string

必需

随机数，由企业自行生成

示例

{
  "Encrypt": "string",
  "MsgSignature": "string",
  "TimeStamp": "string",
  "Nonce": "string"
}

接收消息协议的说明#

接收消息请求的说明#

请求参数

示例代码

返回响应

接收消息协议的说明

接收消息请求的说明