Recevoir un push d'événement


Recevoir le push de l'événement

Dans le processus d'interaction entre les utilisateurs de WeChat et les comptes officiels, certaines opérations des utilisateurs amèneront le serveur WeChat à informer le développeur de l'adresse du serveur définie dans le centre de développement via un push d'événement, afin que le développeur puisse obtenir à ces informations. Parmi eux, certains événements push permettent aux développeurs de répondre aux utilisateurs après leur apparition, tandis que d'autres ne le permettent pas. Pour des instructions détaillées, veuillez consulter le message push WeChat et la description de l'événement à la fin de cette page.

Suivre/Ne plus suivre l'événement

Lorsqu'un utilisateur suit ou ne suit plus un compte officiel, WeChat transmettra cet événement à l'URL renseignée par le développeur. Il est pratique pour les développeurs d'envoyer des messages de bienvenue aux utilisateurs ou de dissocier des comptes.

Si le serveur WeChat ne reçoit pas de réponse dans les cinq secondes, il déconnectera la connexion et relancera la demande, en réessayant trois fois au total.

Concernant la nouvelle tentative de duplication des messages, il est recommandé d'utiliser FromUserName + CreateTime pour dédupliquer les messages.

Si le serveur ne peut pas garantir le traitement et la réponse dans les cinq secondes, vous pouvez répondre directement avec une chaîne vide. Le serveur WeChat ne fera rien avec cela et ne lancera pas de nouvelle tentative.


Exemple de paquet Push XML :

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

Description du paramètre :

Paramètre Description
ToUserNameID WeChat du développeur
FromUserNameCompte expéditeur (un OpenID)
CreateTimeTemps de création du message (type entier)
MsgType type de message, événement
Eventtype d'événement, s'abonner (s'abonner), se désabonner (annuler l'abonnement)

Utilisez des outils de débogage Web pour déboguer cette interface

Scannez l'événement de code QR avec des paramètres

Lorsque l'utilisateur scanne le code QR avec la valeur de scène, les deux événements suivants peuvent être poussés :

  1. Si l'utilisateur a Non suivi Compte officiel, les utilisateurs peuvent suivre le compte officiel. Après avoir suivi, WeChat transmettra l'événement suivant avec la valeur de la scène au développeur.

  2. Si l'utilisateur a suivi le compte officiel, WeChat transmettra l'événement d'analyse avec la valeur de la scène au développeur.

1. Lorsque l'utilisateur ne suit pas, poussez l'événement après avoir suivi l'utilisateur

Exemple de package de données XML push :

<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>

Description du paramètre :

Paramètre Description
ToUserNameID WeChat du développeur
FromUserNameCompte expéditeur (un OpenID)
CreateTimeTemps de création du message (type entier)
MsgType type de message, event
Event type d'événement, Subscribe
EventKey valeur de la clé d'événement, qrscene_ est le préfixe, suivi de la valeur du paramètre du code QR
TicketLe ticket QR code peut être utilisé pour échanger contre la photo du code QR

2. Événement push lorsque l'utilisateur a suivi

Exemple de paquet XML push :

<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>

Description du paramètre :

Paramètre Description
ToUserNameID WeChat du développeur
FromUserNameCompte expéditeur (un OpenID)
CreateTimeTemps de création du message (type entier)
MsgType type de message, event
Event type d'événement, SCAN
EventKeyevent KEY, est un entier non signé de 32 bits, utilisé lors de la création d'un code QR QR. code scene_id
TicketLe ticket du code QR peut être utilisé pour échanger contre la photo du code QR

Utilisez l'outil de débogage Web pour déboguer l'interface

Signaler l'événement de localisation géographique

Une fois que l'utilisateur a accepté de signaler la localisation géographique, chaque fois qu'il entre dans la session du compte officiel, la localisation géographique sera signalée lors de l'entrée , ou toutes les 5 secondes après l'entrée dans la session. La localisation géographique est signalée une fois par seconde et le compte public peut modifier les paramètres ci-dessus sur le site Internet de la plateforme publique. Lors du signalement d'un emplacement géographique, WeChat transmettra l'événement de localisation géographique signalé vers l'URL renseignée par le développeur.

Exemple de paquet XML push :

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[LOCATION]]></Event>
<Latitude>23.137466</Latitude>
<Longitude>113.352425</Longitude>
<Precision>119.385040</Precision>
</xml>

Description du paramètre :

Paramètre Description
ToUserNameID WeChat du développeur
FromUserNameCompte expéditeur (un OpenID)
CreateTimeTemps de création du message (type entier)
MsgTypeType de message, événement
EventType d'événement, LOCATION
LatitudeLatitude de localisation géographique
Longitude Localisation géographique longitude
Précision Géolocalisation précision

Utilisez des outils de débogage Web pour déboguer cette interface

Événements de menu personnalisés

Une fois que l'utilisateur a cliqué sur le menu personnalisé, WeChat transmettra l'événement de clic au développeur. Veuillez noter que cliquer sur le menu fera apparaître un sous-menu et. ne générera pas de rapport.

Evénement push lorsque vous cliquez sur le menu pour extraire le message

Exemple de package de données XML push :

<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>

Description du paramètre :

Paramètre Description
ToUserNameID WeChat du développeur
FromUserNameCompte expéditeur (un OpenID)
CreateTimeTemps de création du message (type entier)
MsgType type de message, event
Event type d'événement, CLICK
EventKeyevent KEY, correspondant à la valeur KEY dans l'interface de menu personnalisée


Evénement push en cliquant sur le lien de saut de menu

Exemple de package de données XML push :

<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>

Description du paramètre :

Paramètre Description
ToUserNameID WeChat du développeur
FromUserNameCompte expéditeur (un OpenID)
CreateTimeTemps de création du message (type entier)
MsgType type de message, event
Event type d'événement, VIEW
EventKeyevent KEY, définir l'URL de saut

Utiliser les outils de débogage Web Débogage de cette interface

1474853764453255.jpg