接收普通消息
普通消息是指员工向企业号应用发送的消息,包括文本、图片、语音、视频、地理位置等类型。普通消息会推送到每个应用在管理端设置的URL(以下假设该URL为http://api.3dept.com)。
Http请求方式: POST
http://api.3dept.com/?msg_signature=ASDFQWEXZCVAQFASDFASDFSS×tamp=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,整型。可在应用的设置页面查看 |
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,整型。可在应用的设置页面查看 |
时间: 2024-08-24 08:59:08