{"id":131,"date":"2026-09-30T20:17:55","date_gmt":"2026-09-30T18:17:55","guid":{"rendered":"https:\/\/hostiaz.com\/blog\/?p=131"},"modified":"2026-09-30T20:17:55","modified_gmt":"2026-09-30T18:17:55","slug":"webhooks-woocommerce-integration","status":"publish","type":"post","link":"https:\/\/hostiaz.com\/blog\/2026\/09\/30\/webhooks-woocommerce-integration\/","title":{"rendered":"Webhooks WooCommerce : connecter la boutique sans traiter deux fois"},"content":{"rendered":"

Une boutique transmet une commande \u00e0 un outil de gestion. Le syst\u00e8me re\u00e7oit la notification, mais la connexion se coupe avant qu\u2019il confirme sa r\u00e9ception. La m\u00eame commande peut ensuite faire l\u2019objet d\u2019une nouvelle notification, lors d\u2019une mise \u00e0 jour ou d\u2019une relance ma\u00eetris\u00e9e de l\u2019int\u00e9gration. Ne supposez pas qu\u2019un \u00e9chec de livraison entra\u00eene automatiquement une nouvelle tentative. Sans contr\u00f4le des doublons, une int\u00e9gration risque de cr\u00e9er deux documents pour une seule commande. Concevoir le traitement compte autant que configurer l\u2019adresse destinataire.<\/p>\n

D\u00e9finir l\u2019\u00e9v\u00e9nement utile<\/h2>\n

Un webhook WooCommerce envoie une notification vers une URL lors d\u2019un \u00e9v\u00e9nement configur\u00e9. Le sujet, l\u2019adresse de livraison, l\u2019\u00e9tat et le secret font partie des \u00e9l\u00e9ments \u00e0 examiner dans la configuration. La documentation officielle d\u00e9crit \u00e9galement les journaux disponibles pour comprendre les envois.<\/p>\n

Choisissez l\u2019\u00e9v\u00e9nement selon le besoin m\u00e9tier. La cr\u00e9ation d\u2019une commande ne signifie pas toujours que son r\u00e8glement est confirm\u00e9. Une int\u00e9gration de pr\u00e9paration de colis doit donc pr\u00e9ciser \u00e0 quel \u00e9tat elle autorise l\u2019exp\u00e9dition. \u00c9crivez cette condition avant de choisir le sujet de notification.<\/p>\n

Prot\u00e9ger et reconna\u00eetre la r\u00e9ception<\/h2>\n

Le destinataire doit v\u00e9rifier l\u2019authenticit\u00e9 des notifications selon le m\u00e9canisme document\u00e9, notamment la signature associ\u00e9e au secret. Ne publiez pas ce secret dans une page ou dans un ticket. Limitez aussi les permissions de l\u2019int\u00e9gration \u00e0 ce dont elle a besoin et pr\u00e9voyez son remplacement si un acc\u00e8s est compromis.<\/p>\n

Conservez une r\u00e9f\u00e9rence au traitement effectu\u00e9. Selon l\u2019op\u00e9ration, cette r\u00e9f\u00e9rence peut associer l\u2019\u00e9v\u00e9nement re\u00e7u, la commande et l\u2019action m\u00e9tier. La conception doit distinguer un doublon du m\u00eame traitement et une v\u00e9ritable mise \u00e0 jour ult\u00e9rieure. Utiliser seulement le num\u00e9ro de commande pour refuser tout nouvel \u00e9v\u00e9nement emp\u00eacherait de traiter les \u00e9volutions n\u00e9cessaires.<\/p>\n

Tester les interruptions et les doublons<\/h2>\n

Dans un environnement d\u2019essai, envoyez deux fois une notification de test et v\u00e9rifiez qu\u2019elle ne cr\u00e9e pas deux op\u00e9rations identiques. Simulez \u00e9galement un refus, un d\u00e9lai de r\u00e9ponse et une donn\u00e9e incompl\u00e8te. Le r\u00e9sultat attendu doit \u00eatre \u00e9crit pour chaque cas : mise en attente, refus explicite ou intervention humaine.<\/p>\n

Exemple fictif : un outil cr\u00e9e une \u00e9tiquette, puis \u00e9choue pendant l\u2019enregistrement de sa r\u00e9f\u00e9rence. Au prochain essai, il doit retrouver l\u2019\u00e9tiquette existante ou appliquer une proc\u00e9dure ma\u00eetris\u00e9e. Relancer aveugl\u00e9ment l\u2019ensemble du travail peut engager un deuxi\u00e8me co\u00fbt ou produire un colis suppl\u00e9mentaire.<\/p>\n

Rapprocher la boutique et le destinataire<\/h2>\n

Un code de r\u00e9ponse favorable ne prouve pas que toutes les op\u00e9rations ult\u00e9rieures sont termin\u00e9es. Comparez les commandes attendues avec les r\u00e9f\u00e9rences cr\u00e9\u00e9es dans le syst\u00e8me externe. Les journaux doivent permettre de retrouver une notification sans stocker inutilement des informations personnelles.<\/p>\n

Le suivi des actions planifi\u00e9es WooCommerce<\/a> compl\u00e8te cette v\u00e9rification lorsque l\u2019int\u00e9gration repose sur une file de t\u00e2ches. Notre guide sur la surveillance des parcours WordPress<\/a> propose de partir des r\u00e9sultats attendus plut\u00f4t que de la seule disponibilit\u00e9 de la page d\u2019accueil.<\/p>\n

Pr\u00e9voir l\u2019exploitation quotidienne<\/h2>\n

D\u00e9signez la personne qui traite les notifications en \u00e9chec et le d\u00e9lai au-del\u00e0 duquel un contr\u00f4le manuel commence. Documentez les conditions d\u2019une relance et les effets qu\u2019elle peut d\u00e9clencher. En cas de changement de stockage, les tests HPOS<\/a> doivent inclure ce connecteur.<\/p>\n

Pour d\u00e9limiter une intervention, WPASSIST pr\u00e9sente ses interventions WordPress<\/a>. Fournissez le sujet du webhook, un exemple anonymis\u00e9, les heures concern\u00e9es et la diff\u00e9rence entre la boutique et l\u2019outil destinataire. Ces \u00e9l\u00e9ments permettent de rechercher la cause sans partager les secrets de l\u2019int\u00e9gration.<\/p>\n

\"\u00c9v\u00e9nement<\/a>
Sch\u00e9ma illustratif Hostiaz \u00b7 \u00c9v\u00e9nement \u2192 Notification \u2192 Traitement unique \u2192 Rapprochement \u00b7 S\u00e9lectionnez pour agrandir.<\/figcaption><\/figure>\n