概述-使用接收消息

POST

http://127.0.0.1/%EF%BC%9Ahttp://api.3dept.com/

最后修改时间：2022-08-30 03:03:37

责任人：未设置

开启接收消息模式后，企业微信会将消息发送给企业填写的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 参数

Body 参数application/xml

示例

<?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

curl --location --request POST 'http://127.0.0.1/%EF%BC%9Ahttp://api.3dept.com/?msg_signature=ASDFQWEXZCVAQFASDFASDFSS&timestamp=13500001234&nonce=123412323' \
--header 'Content-Type: application/xml' \
--data-raw '<?xml version="1.0" encoding="UTF-8"?>
<xml>
  <ToUserName>string</ToUserName>
  <AgentID>string</AgentID>
  <Encrypt>string</Encrypt>
</xml>'

返回响应

🟢200成功

application/json

Body

示例

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

修改于 2022-08-30 03:03:37

概述-获取企业微信服务器的ip段

发送应用消息