第三方应用开发 服务端API 消息推送 接收消息与事件 消息格式
消息格式
最后更新:2019/10/23
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
消息格式
最后更新:2019/10/23

目录

  • 文本消息
  • 图片消息
  • 语音消息
  • 视频消息
  • 位置消息
  • 链接消息
  • 开启接收消息模式后,企业成员在企业微信应用里发送消息时,企业微信会将消息同步到企业应用的后台。
    如何接收消息已经在使用接收消息说明,本小节是对普通消息结构体的说明。
    消息类型支持:文本、图片、语音、视频、位置以及链接信息。
    注:以下出现的xml包仅是接收的消息包中的Encrypt参数解密后的内容说明

    文本消息

    消息示例:

    <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,整型。可在应用的设置页面查看

     

    图片消息

    消息示例:

    <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,整型。可在应用的设置页面查看

     

    语音消息

    消息示例:

    <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,整型。可在应用的设置页面查看

     

    视频消息

    消息示例:

    <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>1351776360</CreateTime>
       <MsgType><![CDATA[location]]></MsgType>
       <Location_X>23.134</Location_X>
       <Location_Y>113.358</Location_Y>
       <Scale>20</Scale>
       <Label><![CDATA[位置信息]]></Label>
       <MsgId>1234567890123456</MsgId>
       <AgentID>1</AgentID>
       <AppType><![CDATA[wxwork]]></AppType>
    </xml>
    

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName成员UserID
    CreateTime消息创建时间(整型)
    MsgType消息类型,此时固定为: location
    Location_X地理位置纬度
    Location_Y地理位置经度
    Scale地图缩放大小
    Label地理位置信息
    MsgId消息id,64位整型
    AgentID企业应用的id,整型。可在应用的设置页面查看
    AppTypeapp类型,在企业微信固定返回wxwork,在微信不返回该字段

     

    链接消息

    消息示例:

    <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>
       <Url><![CDATA[URL]]></Url>
       <PicUrl><![CDATA[this is a url]]></PicUrl>
       <MsgId>1234567890123456</MsgId>
       <AgentID>1</AgentID>
    </xml>
    
    

    参数说明:

    参数说明
    ToUserName企业微信CorpID
    FromUserName成员UserID
    CreateTime消息创建时间(整型)
    MsgType消息类型,此时固定为:link
    Title标题
    Description描述
    Url链接跳转的url
    PicUrl封面缩略图的url
    MsgId消息id,64位整型
    AgentID企业应用的id,整型。可在应用的设置页面查看

     

    上一篇
    更新模版卡片消息
    下一篇
    事件格式