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 |
---|---|
ToUserName | ID WeChat du développeur |
FromUserName | Compte expéditeur (un OpenID) |
CreateTime | Temps de création du message (type entier) |
MsgType | type de message, événement |
Event | type 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 :
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.
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 |
---|---|
ToUserName | ID WeChat du développeur |
FromUserName | Compte expéditeur (un OpenID) |
CreateTime | Temps 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 |
Ticket | Le 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 |
---|---|
ToUserName | ID WeChat du développeur |
FromUserName | Compte expéditeur (un OpenID) |
CreateTime | Temps de création du message (type entier) |
MsgType | type de message, event |
Event | type d'événement, SCAN |
EventKey | event KEY, est un entier non signé de 32 bits, utilisé lors de la création d'un code QR QR. code scene_id |
Ticket | Le 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 |
---|---|
ToUserName | ID WeChat du développeur |
FromUserName | Compte expéditeur (un OpenID) |
CreateTime | Temps de création du message (type entier) |
MsgType | Type de message, événement |
Event | Type d'événement, LOCATION |
Latitude | Latitude 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 |
---|---|
ToUserName | ID WeChat du développeur |
FromUserName | Compte expéditeur (un OpenID) |
CreateTime | Temps de création du message (type entier) |
MsgType | type de message, event |
Event | type d'événement, CLICK |
EventKey | event 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 |
---|---|
ToUserName | ID WeChat du développeur |
FromUserName | Compte expéditeur (un OpenID) |
CreateTime | Temps de création du message (type entier) |
MsgType | type de message, event |
Event | type d'événement, VIEW |
EventKey | event KEY, définir l'URL de saut |
Utiliser les outils de débogage Web Débogage de cette interface