[wechat official account H5] generates a QR code with parameters to enter the official account attention page to listen to user-defined menu bar for official account events (server)

official account Generate QR code with parameters Scan the code with parameters to enter the following official account page  

Official documents ：https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Receiving_event_pushes.html

Temporary QR code request description

http Request mode : POST URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN POST data format ：json POST Data example ：{"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}} Or you can use the following POST Two dimensional code parameters in the form of data creation string ：{"expire_seconds": 604800, "action_name": "QR_STR_SCENE", "action_info": {"scene": {"scene_str": "test"}}}

Permanent QR code request description

http Request mode : POST URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN POST data format ：json POST Data example ：{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}} Or you can use the following POST Two dimensional code parameters in the form of data creation string ： {"action_name": "QR_LIMIT_STR_SCENE", "action_info": {"scene": {"scene_str": "test"}}}

Parameter description

Parameters	explain
expire_seconds	Effective time of the QR code , In seconds . No more than 2592000（ namely 30 God ）, If this field is not filled in , The default validity period is 30 second .
action_name	QR code type ,QR_SCENE Is a temporary integer parameter value ,QR_STR_SCENE Is a temporary string parameter value ,QR_LIMIT_SCENE Is a permanent integer parameter value ,QR_LIMIT_STR_SCENE Is a permanent string parameter value
action_info	QR code details
scene_id	Scene value ID, Temporary QR code 32 Bit non 0 integer , The maximum value for permanent QR code is 100000（ Currently, only parameters are supported 1--100000）
scene_str	Scene value ID（ In string form ID）, String type , The length is limited to 1 To 64

  The code scanning belt parameters are processed after entering the official account

Official documents ：https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Receiving_event_pushes.html

Scan QR code events with parameters

When users scan QR code with scene value , Two types of events may be pushed ：

1. If the user has not paid attention to the official account , Users can pay attention to the official account. , After following, wechat will push the following events with scenario value to the developer .
2. If the user has paid attention to the official account number , Wechat will push the event with scenario value scan to the developer .

1. When the user is not paying attention , Push events after attention

push XML Packet example ：

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[subscribe]]></Event>
  <EventKey><![CDATA[qrscene_123123]]></EventKey>
  <Ticket><![CDATA[TICKET]]></Ticket>
</xml>

Parameter description ：

Parameters	describe
ToUserName	Developer WeChat ID
FromUserName	Sender account （ One OpenID）
CreateTime	Message creation time （ integer ）
MsgType	Message type ,event
Event	Event type ,subscribe
EventKey	event KEY value ,qrscene_ The prefix , The following is the parameter value of the QR code
Ticket	Two dimensional coded ticket, Can be exchanged for QR code pictures

2. Event push when the user has followed

push XML Packet example ：

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[SCAN]]></Event>
  <EventKey><![CDATA[SCENE_VALUE]]></EventKey>
  <Ticket><![CDATA[TICKET]]></Ticket>
</xml> 

Parameter description ：

Parameters	describe
ToUserName	Developer WeChat ID
FromUserName	Sender account （ One OpenID）
CreateTime	Message creation time （ integer ）
MsgType	Message type ,event
Event	Event type ,SCAN
EventKey	event KEY value , It's a 32 Bit unsigned integer , That is, the QR code when the QR code is created scene_id
Ticket	Two dimensional coded ticket, Can be exchanged for QR code pictures

official account Users click or cancel following Event monitoring

Official documents ：https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Receiving_event_pushes.html

Focus on / Unfollow events

Users are concerned about and cancelling the official account. , Wechat will push this event to the developer to fill in URL. It is convenient for developers to send welcome messages to users or unbind accounts . To protect user data privacy , The developer needs to delete all information of the user when receiving the event of user's cancellation of attention .

If the wechat server does not receive a response within five seconds, it will be disconnected , And reissue the request , Three retries in total .

Message retrying , Recommended FromUserName + CreateTime Weight removal .

If the server cannot guarantee to process and reply within five seconds , Can reply empty string directly , Wechat server will not handle this , And will not initiate a retry .

push XML Packet example ：

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[subscribe]]></Event>
</xml>

Parameter description ：

Parameters	describe
ToUserName	Developer WeChat ID
FromUserName	Sender account （ One OpenID）
CreateTime	Message creation time （ integer ）
MsgType	Message type ,event
Event	Event type ,subscribe( subscribe )、unsubscribe( Unsubscribe )

  official account Custom menu bar  

Official documents ：https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Receiving_event_pushes.html

Custom menu events

After the user clicks the custom menu , Wechat will push click events to developers , Please note that , Click menu to pop up submenu , No escalation .

Event push when clicking menu to pull message

push XML Packet example ：

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[CLICK]]></Event>
  <EventKey><![CDATA[EVENTKEY]]></EventKey>
</xml>

Parameter description ：

Parameters	describe
ToUserName	Developer WeChat ID
FromUserName	Sender account （ One OpenID）
CreateTime	Message creation time （ integer ）
MsgType	Message type ,event
Event	Event type ,CLICK
EventKey	event KEY value , Interface with custom menu KEY Value correspondence

Event push when clicking menu jump link

push XML Packet example ：

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[VIEW]]></Event>
  <EventKey><![CDATA[www.qq.com]]></EventKey>
</xml>

Parameter description ：

Parameters	describe
ToUserName	Developer WeChat ID
FromUserName	Sender account （ One OpenID）
CreateTime	Message creation time （ integer ）
MsgType	Message type ,event
Event	Event type ,VIEW
EventKey	event KEY value , Jump set URL

 

After users' attention   The official account is accessible to the public. OpenID adopt OpenID To get basic user information Please see the document for details

Get basic user information (UnionID Mechanism )

Get basic user information （ Include UnionID Mechanism ）

Developers can use OpenID To get basic user information . Please use https agreement .

Interface call request description http Request mode : GET

https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

  Parameter description

Return instructions

Under normal circumstances , Wechat will return the following JSON Packet to official account ：