“接收普通消息”版本间的差异

来自企业号开发者接口文档
跳转至: 导航搜索
接收普通消息
 
第247行: 第247行:
 
| Label
 
| Label
 
| 地理位置信息
 
| 地理位置信息
 +
|-
 +
| MsgId
 +
| 消息id,64位整型
 +
|-
 +
| AgentID
 +
| 企业应用的id,整型。可在应用的设置页面查看
 +
|}
 +
<br />
 +
 +
==='''<strong>link消息</strong>'''===
 +
<xml>
 +
    <ToUserName><![CDATA[toUser]]></ToUserName>
 +
    <FromUserName><![CDATA[fromUser]]></FromUserName>
 +
    <CreateTime>1348831860</CreateTime>
 +
    <MsgType><![CDATA[link]]></MsgType>
 +
    <Title><![CDATA[this is a title!]]></Title>
 +
    <Description><![CDATA[this is a description!]]></Description>
 +
    <PicUrl><![CDATA[this is a url]]></PicUrl>
 +
    <MsgId>1234567890123456</MsgId>
 +
    <AgentID>1</AgentID>
 +
</xml>
 +
{| border="1" cellspacing="0" cellpadding="4" align="center" width="640px"
 +
! style="width:240px"|参数
 +
! stype="width:400px"|说明
 +
|-
 +
| ToUserName
 +
| 企业号CorpID
 +
|-
 +
| FromUserName
 +
| 成员UserID
 +
|-
 +
| CreateTime
 +
| 消息创建时间(整型)
 +
|-
 +
| MsgType
 +
| 消息类型,此时固定为:link
 +
|-
 +
| Title
 +
| 标题
 +
|-
 +
| Description
 +
| 描述
 +
|-
 +
| PicUrl
 +
| 封面缩略图的url
 
|-
 
|-
 
| MsgId
 
| MsgId

2016年2月4日 (四) 10:04的最后版本

接收普通消息

普通消息是指成员向企业号应用发送的消息,包括文本、图片、语音、视频、地理位置等类型。普通消息会推送到每个应用在管理端设置的URL(以下假设该URL为http://api.3dept.com)。

  • 请求说明

Http请求方式: POST

http://api.3dept.com/?msg_signature=ASDFQWEXZCVAQFASDFASDFSS&timestamp=13500001234&nonce=123412323


text消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName> 
   <CreateTime>1348831860</CreateTime>
   <MsgType><![CDATA[text]]></MsgType>
   <Content><![CDATA[this is a test]]></Content>
   <MsgId>1234567890123456</MsgId>
   <AgentID>1</AgentID>
</xml>
参数 说明
ToUserName 企业号CorpID
FromUserName 成员UserID
CreateTime 消息创建时间(整型)
MsgType 消息类型,此时固定为:text
Content 文本消息内容
MsgId 消息id,64位整型
AgentID 企业应用的id,整型。可在应用的设置页面查看


image消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>1348831860</CreateTime>
   <MsgType><![CDATA[image]]></MsgType>
   <PicUrl><![CDATA[this is a url]]></PicUrl>
   <MediaId><![CDATA[media_id]]></MediaId>
   <MsgId>1234567890123456</MsgId>
   <AgentID>1</AgentID>
</xml>
参数 说明
ToUserName 企业号CorpID
FromUserName 成员UserID
CreateTime 消息创建时间(整型)
MsgType 消息类型,此时固定为:image
PicUrl 图片链接
MediaId 图片媒体文件id,可以调用获取媒体文件接口拉取数据
MsgId 消息id,64位整型
AgentID 企业应用的id,整型。可在应用的设置页面查看


voice消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>1357290913</CreateTime>
   <MsgType><![CDATA[voice]]></MsgType>
   <MediaId><![CDATA[media_id]]></MediaId>
   <Format><![CDATA[Format]]></Format>
   <MsgId>1234567890123456</MsgId>
   <AgentID>1</AgentID>
</xml>
参数 说明
ToUserName 企业号CorpID
FromUserName 成员UserID
CreateTime 消息创建时间(整型)
MsgType 消息类型,此时固定为:voice
MediaId 语音媒体文件id,可以调用获取媒体文件接口拉取数据
Format 语音格式,如amr,speex等
MsgId 消息id,64位整型
AgentID 企业应用的id,整型。可在应用的设置页面查看


video消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>1357290913</CreateTime>
   <MsgType><![CDATA[video]]></MsgType>
   <MediaId><![CDATA[media_id]]></MediaId>
   <ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId>
   <MsgId>1234567890123456</MsgId>
   <AgentID>1</AgentID>
</xml>
参数 说明
ToUserName 企业号CorpID
FromUserName 成员UserID
CreateTime 消息创建时间(整型)
MsgType 消息类型,此时固定为:video
MediaId 视频媒体文件id,可以调用获取媒体文件接口拉取数据
ThumbMediaId 视频消息缩略图的媒体id,可以调用获取媒体文件接口拉取数据
MsgId 消息id,64位整型
AgentID 企业应用的id,整型。可在应用的设置页面查看


小视频消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>1357290913</CreateTime>
   <MsgType><![CDATA[shortvideo]]></MsgType>
   <MediaId><![CDATA[media_id]]></MediaId>
   <ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId>
   <MsgId>1234567890123456</MsgId>
   <AgentID>1</AgentID>
</xml>
参数 说明
ToUserName 企业号CorpID
FromUserName 成员UserID
CreateTime 消息创建时间(整型)
MsgType 消息类型,此时固定为:shortvideo
MediaId 视频媒体文件id,可以调用获取媒体文件接口拉取数据
ThumbMediaId 视频消息缩略图的媒体id,可以调用获取媒体文件接口拉取数据
MsgId 消息id,64位整型
AgentID 企业应用的id,整型。可在应用的设置页面查看


location消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>1351776360</CreateTime>
   <MsgType><![CDATA[location]]></MsgType>
   <Location_X>23.134521</Location_X>
   <Location_Y>113.358803</Location_Y>
   <Scale>20</Scale>
   <Label><![CDATA[位置信息]]></Label>
   <MsgId>1234567890123456</MsgId>
   <AgentID>1</AgentID>
</xml>
参数 说明
ToUserName 企业号CorpID
FromUserName 成员UserID
CreateTime 消息创建时间(整型)
MsgType 消息类型,此时固定为:location
Location_X 地理位置纬度
Location_Y 地理位置经度
Scale 地图缩放大小
Label 地理位置信息
MsgId 消息id,64位整型
AgentID 企业应用的id,整型。可在应用的设置页面查看


link消息

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName> 
   <CreateTime>1348831860</CreateTime>
   <MsgType><![CDATA[link]]></MsgType>
   <Title><![CDATA[this is a title!]]></Title>
   <Description><![CDATA[this is a description!]]></Description>
   <PicUrl><![CDATA[this is a url]]></PicUrl>
   <MsgId>1234567890123456</MsgId>
   <AgentID>1</AgentID>
</xml>
参数 说明
ToUserName 企业号CorpID
FromUserName 成员UserID
CreateTime 消息创建时间(整型)
MsgType 消息类型,此时固定为:link
Title 标题
Description 描述
PicUrl 封面缩略图的url
MsgId 消息id,64位整型
AgentID 企业应用的id,整型。可在应用的设置页面查看