Quand quelque chose se passe dans votre boutique, Shopify envoie un message à ce sujet à votre memberarea. Chacun de ces messages est une livraison, et chaque livraison est enregistrée avec son résultat, qu'elle ait fonctionné ou non. Le journal des webhooks est l'endroit où regarder quand un acheteur dit que son cours manque, ou quand vous voulez savoir ce qu'un remboursement ou une modification de produit a réellement produit.
Ouvrir le journal
Ouvrez votre page Shopify à l'adresse /admin/settings/integrations/shopify, ou
ouvrez Paramètres, puis Intégrations, puis Ajouter une intégration
et Shopify. Choisissez ensuite l'onglet Journal des webhooks. Le journal
reste consultable pendant que la boutique est déconnectée, vous pouvez donc
toujours revoir ce qui est arrivé avant.
Jusqu'à l'arrivée de la première livraison, l'onglet indique « Aucun webhook reçu pour l'instant. Passez une commande test dans votre boutique pour vérifier la connexion. » Une commande de test est le moyen le plus rapide de voir la première ligne.
Ce qu'affiche une ligne
La liste n'a pas d'en-têtes de colonnes. Chaque livraison occupe une ligne :
| Où | Ce qui s'affiche |
|---|---|
| Ligne du haut | Le sujet, qui nomme ce qui s'est passé dans la boutique. |
| Ligne en dessous | Une courte note sur ce que votre memberarea a fait de la livraison. En cas d'échec, c'est l'erreur qui s'y trouve. |
| Sous la note | La date et l'heure de réception de la livraison. |
| Badge à droite | Le résultat : Traité, Ignoré, Pas encore traité, Nouvelle tentative ou Échouée. |
| Bouton à côté | Retraiter, uniquement sur les lignes qui peuvent être relancées. |
Cliquez sur une ligne pour ouvrir ses détails. Ils listent ce que la livraison contenait parmi Numéro de commande, Adresse e-mail, Total, Devise et ID Shopify, toujours le nombre de Tentatives, et l'erreur complète s'il y en a eu une. Cliquez à nouveau sur la ligne pour la refermer.
Les sujets que vous verrez sont orders/paid, orders/cancelled,
refunds/create, customers/create, customers/update, customers/delete,
products/update, products/delete et app/uninstalled. Les trois sujets de
confidentialité de Shopify, customers/data_request, customers/redact et
shop/redact, arrivent aussi ici.
Les cinq résultats
Traité signifie que votre memberarea a fait le travail. Pour une commande payée, la note ressemble à « Order SHP-1042 imported, 1 mapped item(s). » et l'acheteur dispose de l'accès associé. Une commande payée pour un produit que personne n'a associé est elle aussi traitée : la note indique « Order SHP-1042 imported, no mapped item. » La commande existe, compte dans votre chiffre d'affaires, et l'acheteur devient membre sans aucun accès. Cela couvre aussi les biens physiques que vous vendez à côté de vos cours.
Ignoré signifie que la livraison a été comprise et qu'il n'y avait rien à faire. La note en donne la raison, par exemple « This product is not mapped. » pour une modification de produit vers lequel aucune association ne pointe, ou « This update is the echo of our own push. » après que vous avez vous-même envoyé un produit dans Shopify.
Pas encore traité signifie que la livraison est arrivée et attend son tour. Une ligne ne devrait pas rester ainsi plus de quelques secondes. Si de nombreuses lignes restent sur Pas encore traité, quelque chose s'est bloqué de notre côté. Écrivez à support@memberarea.io.
Nouvelle tentative signifie que la livraison a échoué et va être retentée d'elle-même. La ligne de note contient l'erreur de la dernière tentative.
Échouée signifie que quelque chose a échoué et que les tentatives automatiques sont épuisées. La ligne de note contient l'erreur, et la ligne propose Retraiter.
Les livraisons en échec sont retentées d'elles-mêmes
Une livraison qui échoue est automatiquement retentée plusieurs fois, avec une pause entre les tentatives. Tant que ces tentatives sont en cours, la ligne affiche Nouvelle tentative, et Tentatives dans les détails augmente à chaque essai. Ce n'est que lorsque la dernière tentative échoue que la ligne passe à Échouée. Une ligne sur Échouée a besoin de vous : corrigez la cause, puis relancez-la. Le journal des webhooks de l'application dans votre admin Shopify affiche les mêmes états, « Retrying » tant que les tentatives ne sont pas épuisées et « Failed » ensuite.
Relancer une livraison
Cliquez sur Retraiter sur la ligne. Le bouton n'existe que pour une livraison qui a échoué, qui est en nouvelle tentative ou qui n'a pas encore été traitée. Une ligne qui compte comme traitée ou ignorée n'en porte pas. La ligne repasse à Pas encore traité puis est traitée avec les données que Shopify a envoyées à l'origine : la relancer après avoir corrigé la cause fait donc tout le travail, pas une version réduite.
Rien n'est exécuté deux fois. Si Shopify renvoie la même livraison, elle ne reçoit pas de seconde ligne. Une commande payée qui arrive deux fois reste une seule commande et débloque l'accès une fois, et un remboursement qui arrive deux fois est comptabilisé une fois. Cliquer sur Retraiter ne double jamais une commande, un accès ou un remboursement.
Filtrer et parcourir le journal
Les boutons au-dessus de la liste la limitent à Traité, Ignoré ou Échouée, et Tous ramène tout. Échouée ne liste que les livraisons dont les tentatives automatiques sont épuisées. Les lignes sur Pas encore traité et Nouvelle tentative n'apparaissent que sous Tous. Actualiser recharge la page sur laquelle vous êtes, vous pouvez donc regarder arriver une nouvelle livraison.
Vingt-cinq livraisons tiennent sur une page, les plus récentes en premier. Les livraisons plus anciennes se trouvent sur les pages suivantes, accessibles sous la liste.
Quand un client signale un cours manquant, filtrez d'abord sur Échouée, puis
sur Ignoré, puis regardez sa ligne orders/paid sous Traité. Entre ces
trois, vous trouverez presque toujours la réponse.
Les notes que vous verrez réellement
| Note | Ce qu'elle signifie et que faire |
|---|---|
| « Order SHP-1042 imported, no mapped item. » | La commande est là, mais son produit ne débloque rien. Associez le produit pour que les prochains acheteurs reçoivent l'accès, voir Associer un produit Shopify à un cours. |
| « This product is not mapped. » | Un produit vers lequel aucune association ne pointe a changé dans la boutique. Rien à faire, sauf si vous vouliez l'associer. |
| « This update is the echo of our own push. » | Shopify a signalé en retour une modification faite par votre memberarea. Rien à faire. |
| « This delivery carried no order id or the order was already imported. » | Soit la livraison n'avait pas d'identifiant de commande, soit la commande est déjà là. Rien à faire. |
| « Refund recorded, the refunded items were not mapped. » | Le remboursement est comptabilisé, mais il portait sur des produits jamais associés : il n'y avait donc aucun accès à retirer. |
| « The order for this refund has not been imported yet, trying again shortly. » | Le remboursement est arrivé avant sa commande. Il est retenté de lui-même, et la ligne affiche Nouvelle tentative entre-temps. S'il finit sur Échouée, cliquez sur Retraiter dès que la ligne de la commande affiche Traité. |
Ce que font les remboursements et les annulations à l'accès, à la commande et aux commissions figure dans Remboursements et annulations dans Shopify.
Uniquement de vraies livraisons de Shopify
Chaque livraison doit porter une signature Shopify valide. Un message sans signature est refusé et n'apparaît jamais dans le journal. Une livraison que Shopify a déclenchée il y a plus de sept jours n'est pas acceptée non plus. Si une ligne attendue manque complètement, vérifiez que la boutique est connectée, voir Connecter votre boutique Shopify.
Les demandes de confidentialité de Shopify
Shopify transmet les demandes de confidentialité des clients de votre boutique, et chacune apparaît comme une ligne.
Lorsqu'un client demande à Shopify de supprimer ses données, une livraison
customers/redact arrive. Votre memberarea supprime le lien vers ce client
Shopify et les livraisons enregistrées à son sujet. Le membre, le contact et
leurs commandes restent : ils appartiennent à votre espace de travail, et le
client a peut-être aussi acheté chez vous ailleurs. La note ressemble à
« Removed 1 link and 4 stored deliveries for Shopify customer 7012345678. The
member itself belongs to the workspace and stays. » Si vous voulez aussi que la
personne disparaisse de votre memberarea, supprimez vous-même le membre ou le
contact.
Lorsqu'un client demande ses données, une livraison customers/data_request
arrive et les propriétaires de votre espace de travail reçoivent un e-mail et
une notification intitulés « Un client Shopify a demandé ses données ». Shopify
attend votre réponse sous 30 jours, et votre memberarea n'envoie pas les données
à votre place. Ce qui se passe d'autre autour de la confidentialité et de la
désinstallation figure dans
Déconnecter Shopify et supprimer les données de la boutique.
Ce qui est conservé
Chaque livraison est enregistrée avec les données que Shopify a envoyées, la relancer fait donc tout le travail. Ces données concernent vos clients, elles sont donc stockées chiffrées. Les livraisons sont supprimées 90 jours après leur arrivée.