被动响应消息

来自企业号开发者接口文档
2015年6月25日 (四) 07:56Wikiadmin（讨论 | 贡献）的版本

(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳转至： 导航、 搜索

被动响应消息

企业收到普通消息、成员关注事件、菜单click事件、成员进入应用事件后，可以被动响应消息。企业响应的消息同样应该经过加密，并带上msg_signature、timestamp、nonce及密文，其中timestamp、nonce由企业指定，msg_signature、密文经特定算法生成，具体算法参见附录。

以下是标准的回包：

<xml>
   <Encrypt><![CDATA[msg_encrypt]]></Encrypt>
   <MsgSignature><![CDATA[msg_signature]]></MsgSignature>
   <TimeStamp>timestamp</TimeStamp>
   <Nonce><![CDATA[nonce]]></Nonce>
</xml>

以下是各类型消息的明文XML结构：


text消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName> 
   <CreateTime>1348831860</CreateTime>
   <MsgType><![CDATA[text]]></MsgType>
   <Content><![CDATA[this is a test]]></Content>
</xml>
参数 说明
ToUserName 成员UserID
FromUserName 企业号CorpID
CreateTime 消息创建时间（整型）
MsgType 消息类型，此时固定为：text
Content 文本消息内容


image消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>1348831860</CreateTime>
   <MsgType><![CDATA[image]]></MsgType>
   <Image>
       <MediaId><![CDATA[media_id]]></MediaId>
   </Image>
</xml>
参数 说明
ToUserName 成员UserID
FromUserName 企业号CorpID
CreateTime 消息创建时间（整型）
MsgType 消息类型，此时固定为：image
MediaId 图片文件id，可以调用上传媒体文件接口获取


voice消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>1357290913</CreateTime>
   <MsgType><![CDATA[voice]]></MsgType>
   <Voice>
       <MediaId><![CDATA[media_id]]></MediaId>
   </Voice>
</xml>
参数 说明
ToUserName 成员UserID
FromUserName 企业号CorpID
CreateTime 消息创建时间（整型）
MsgType 消息类型，此时固定为：voice
MediaId 语音文件id，可以调用上传媒体文件接口获取


video消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>1357290913</CreateTime>
   <MsgType><![CDATA[video]]></MsgType>
   <Video>
       <MediaId><![CDATA[media_id]]></MediaId>
       <Title><![CDATA[title]]></Title>
       <Description><![CDATA[description]]></Description>
   </Video>
</xml>
参数 说明
ToUserName 成员UserID
FromUserName 企业号CorpID
CreateTime 消息创建时间（整型）
MsgType 消息类型，此时固定为：video
MediaId 视频文件id，可以调用上传媒体文件接口获取
Title 视频消息的标题
Description 视频消息的描述


news消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>12345678</CreateTime>
   <MsgType><![CDATA[news]]></MsgType>
   <ArticleCount>2</ArticleCount>
   <Articles>
       <item>
           <Title><![CDATA[title1]]></Title> 
           <Description><![CDATA[description1]]></Description>
           <PicUrl><![CDATA[picurl]]></PicUrl>
           <Url><![CDATA[url]]></Url>
       </item>
       <item>
           <Title><![CDATA[title]]></Title>
           <Description><![CDATA[description]]></Description>
           <PicUrl><![CDATA[picurl]]></PicUrl>
           <Url><![CDATA[url]]></Url>
       </item>
   </Articles>
</xml>
参数 说明
ToUserName 成员UserID
FromUserName 企业号CorpID
CreateTime 消息创建时间（整型）
MsgType 消息类型，此时固定为：news
ArticleCount 图文条数，默认第一条为大图。图文数不能超过10，否则将会无响应
Title 图文消息标题
Description 图文消息描述
PicUrl 图片链接，支持JPG、PNG格式，较好的效果为大图360*200，小图200*200
Url 点击图文消息跳转链接


取自“https://qydev.weixin.qq.com/wiki/index.php?title=被动响应消息&oldid=1316”