# Receive messages and events

Use ['

When a user sends a message in a customer service session, or an event is pushed by certain user actions, the WeChat server sends packets of the message or event to a developer's completed content.URL / Cloud development cloud functions / Cloud hosting services (for details, see [Message Push]]).Developers can use the Send Customer Service Message interface to respond asynchronously to requests.

The structure of the push JSON and XML digital packet for each message type is as follows.

# Text Message

When a user sends a text message in a customer service session, the following data packet is generated:

# XML format

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
   <FromUserName><![CDATA[fromUser]]></FromUserName>
   <CreateTime>1482048670</CreateTime>
   <MsgType><![CDATA[text]]></MsgType>
   <Content><![CDATA[this is a test]]></Content>
   <MsgId>1234567890123456</MsgId>
</xml>

# JSON format

{
  "ToUserName": "toUser",
  "FromUserName": "fromUser",
  "CreateTime": 1482048670,
  "MsgType": "text",
  "Content": "this is a test",
  "MsgId": 1234567890123456
}

# Parameter explaination

parameter	Introductions
ToUserName	Original ID of Weixin Mini Program
FromUserName	Sender's openid
CreateTime	Message Creation Time (integer)
MsgType	text
Content	Text message content
MsgId	Message id, 64-bit integer

# Photo message

When a user sends a picture message in a customer service session, the following data packet is generated:

# XML format

<xml>
      <ToUserName><![CDATA[toUser]]></ToUserName>
      <FromUserName><![CDATA[fromUser]]></FromUserName>
      <CreateTime>1482048670</CreateTime>
      <MsgType><![CDATA[image]]></MsgType>
      <PicUrl><![CDATA[this is a url]]></PicUrl>
      <MediaId><![CDATA[media_id]]></MediaId>
      <MsgId>1234567890123456</MsgId>
</xml>

# JSON format

{
  "ToUserName": "toUser",
  "FromUserName": "fromUser",
  "CreateTime": 1482048670,
  "MsgType": "image",
  "PicUrl": "this is a url",
  "MediaId": "media_id",
  "MsgId": 1234567890123456
}

# Parameter explaination

parameter	Introductions
ToUserName	Original ID of Weixin Mini Program
FromUserName	Sender's openid
CreateTime	Message Creation Time (integer)
MsgType	image
PicUrl	Image Link (generated by the system)
MediaId	Picture message media id, you can call [to get temporary material]((getTempMedia) interface to pull data.
MsgId	Message id, 64-bit integer

# Weixin Mini Program Card Message

When a user sends a Weixin Mini Program card message in a customer service session, the following digital packet is generated:

# XML format

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>1482048670</CreateTime>
  <MsgType><![CDATA[miniprogrampage]]></MsgType>
  <MsgId>1234567890123456</MsgId>
  <Title><![CDATA[Title]]></Title>
  <AppId><![CDATA[AppId]]></AppId>
  <PagePath><![CDATA[PagePath]]></PagePath>
  <ThumbUrl><![CDATA[ThumbUrl]]></ThumbUrl>
  <ThumbMediaId><![CDATA[ThumbMediaId]]></ThumbMediaId>
</xml>

# JSON format

{
  "ToUserName": "toUser",
  "FromUserName": "fromUser",
  "CreateTime": 1482048670,
  "MsgType": "miniprogrampage",
  "MsgId": 1234567890123456,
  "Title":"title",
  "AppId":"appid",
  "PagePath":"path",
  "ThumbUrl":"",
  "ThumbMediaId":""
}

# Parameter explaination

parameter	Introductions
ToUserName	Original ID of Weixin Mini Program
FromUserName	Sender's openid
CreateTime	Message Creation Time (integer)
MsgType	miniprogrampage
MsgId	Message id, 64-bit integer
Title	title
AppId	Weixin Mini Program AppID
PagePath	Weixin Mini Program Page path
ThumbUrl	Temporary cdn link for cover image
ThumbMediaId	Temporary material id for cover image

# Enter the session event

When the user enters a customer service session at the Weixin Mini Program "Customer Service Session Button," the following digital packet will be generated:

# XML format

<xml>
    <ToUserName><![CDATA[toUser]]></ToUserName>
    <FromUserName><![CDATA[fromUser]]></FromUserName>
    <CreateTime>1482048670</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[user_enter_tempsession]]></Event>
    <SessionFrom><![CDATA[sessionFrom]]></SessionFrom>
</xml>

# JSON format

{
  "ToUserName": "toUser",
  "FromUserName": "fromUser",
  "CreateTime": 1482048670,
  "MsgType": "event",
  "Event": "user_enter_tempsession",
  "SessionFrom": "sessionFrom"
}

# Parameter explaination

parameter	Introductions
ToUserName	Original ID of Weixin Mini Program
FromUserName	Sender's openid
CreateTime	Event creation time (integer)
MsgType	event
Event	Event type, user_enter_tempsession
SessionFrom	The session-from attribute that the developer sets in the customer service session button