跳转至

接收消息

消息接收

当 App 内用户向应用公众帐号发消息时,融云服务器将 POST 消息数据包(XML格式)到开发者配置的消息接收 URL 上。

  • 融云服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。
  • 关于重试的消息排重,推荐使用 MsgID 排重。
  • 假如开发者服务器无法保证在五秒内处理并回复,可以直接回复空字符串,融云服务器不会对此作任何处理,且不会发起重试。

http 请求方式:POST

请求接收方式:参见 API 接收签名规则

文本消息格式

XML 格式

<xml>
<ToUserName><![CDATA[toUserId]]></ToUserName>
<FromUserName><![CDATA[fromUserName]]></FromUserName>
<CreateTime>134223445860</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[content]]></Content>
<MsgId>msgId</MsgID>
</xml>

参数说明

名称 说明
ToUserName 公众号 Id
FromUserName 发送方用户 Id
CreateTime 消息创建时间
MsgType 消息类型,此处为 text
Content 文本消息内容
MsgId 消息 Id
图片消息格式

XML 格式

<xml>
<ToUserName><![CDATA[toUserName]]></ToUserName>
<FromUserName><![CDATA[fromUserName]]></FromUserName>
<CreateTime>134223445860</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
<PicUrl><![CDATA[this is a url]]></PicUrl>
<MsgId>msgId</MsgID>
</xml>

参数说明

名称 说明
ToUserName 公众号 Id
FromUserName 发送方用户 Id
CreateTime 消息创建时间
MsgType 消息类型,此处为 image
PicUrl 图片链接
MsgId 消息 Id
语音消息格式

XML 格式

<xml>
<ToUserName><![CDATA[toUserName]]></ToUserName>
<FromUserName><![CDATA[fromUserName]]></FromUserName>
<CreateTime>134223445860</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<VoiceUrl><![CDATA[this is url]]></VoiceUrl>
<Format><![CDATA[AMR]]></Format>
<MsgId>msgId</MsgID>
</xml>

参数说明

名称 说明
ToUserName 公众号 Id
FromUserName 发送方用户 Id
CreateTime 消息创建时间
MsgType 消息类型,此处为 voice
VoiceUrl 语音链接
Format 语音格式,目前支持 AMR 格式
MsgId 消息 Id
位置消息格式

XML 格式

<xml>
<ToUserName><![CDATA[toUserName]]></ToUserName>
<FromUserName><![CDATA[fromUserName]]></FromUserName>
<CreateTime>134223445860</CreateTime>
<MsgType><![CDATA[location]]></MsgType>
<Location_X>15.501</Location_X>
<Location_Y>142.324</Location_Y>
<Label><![CDATA[POI信息]]></Label>
<MsgId>msgId</MsgID>
</xml>

参数说明

名称 说明
ToUserName 公众号 Id
FromUserName 发送方用户 Id
CreateTime 消息创建时间
MsgType 消息类型,此处为 location
Location_X 纬度
Location_Y 经度
Label 地理位置信息
MsgId 消息 Id
图文消息格式

XML 格式

<xml>
 <ToUserName><![CDATA[toUserName]]></ToUserName>
 <FromUserName><![CDATA[fromUserName]]></FromUserName>
 <CreateTime>134223445860</CreateTime>
 <MsgType><![CDATA[imgtxt]]></MsgType>
 <Title><![CDATA[title]]></Title>
 <Description><![CDATA[description]]></Description>
 <PicUrl><![CDATA[picUrl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 <MsgId>msgId</MsgID>
</xml>

参数说明

名称 说明
ToUserName 开发者帐号
FromUserName 发送方帐号
CreateTime 消息创建时间
MsgType 消息类型,此处为 imgtxt
Title 消息的标题
Description 消息文本内容
PicUrl 图片地址
Url 跳转的地址
MsgId 消息 Id