Connectez WooCommerce à votre veille tarifaire en quelques minutes

Le plugin Rivalyse Sync écoute les événements price.changed générés par Rivalyse et applique le nouveau prix dans votre WooCommerce en quelques secondes via webhook, ou dans les 30 minutes suivantes via WP-Cron. La synchronisation s'appuie sur le SKU WooCommerce pour identifier chaque produit.

Fonctionnalités incluses :

• Mode Webhook : réception des événements price.changed en temps réel via l'endpoint REST WordPress
• Mode WP-Cron : polling périodique de l'API (configurable, défaut 30 min)
• Correspondance automatique par SKU WooCommerce
• Mise à jour du prix standard et/ou du prix promo
• Support des produits simples et variables
• Vérification HMAC-SHA256 (timing-safe via hash_equals)
• Header X-Module-Version: woocommerce/1.0.0 pour le suivi admin
• Logs via WC_Logger (WooCommerce > Statut > Logs)

Vérifiez que votre environnement répond aux exigences minimales avant d'installer Rivalyse Sync. La version WooCommerce la plus récente est recommandée pour bénéficier des dernières optimisations de l'API REST. L'intégration est disponible à partir du plan Pro (synchronisations jusqu'à 4 fois/jour, 50 endpoints configurables) ou du plan Business+ (synchronisations toutes les 6 heures, endpoints illimités). Aucune dépendance Composer ni librairie externe n'est requise.

L'installation prend moins de 15 minutes, sans compétence serveur requise. Aucune dépendance Composer ni librairie externe n'est nécessaire : Rivalyse Sync est un fichier PHP natif, compatible avec tous les hébergeurs WordPress standard. Le plugin s'active en un clic depuis l'interface d'administration WordPress et enregistre son initialisation dans les logs WooCommerce dès la première activation.

1. Téléchargez le fichier rivalyse-sync.php depuis votre dashboard Rivalyse
2. Copiez-le dans wp-content/plugins/rivalyse-sync/ de votre WordPress
3. WordPress → Extensions → Rechercher "Rivalyse Price Sync" → Activer
4. Allez dans WooCommerce > Rivalyse Sync pour configurer l'URL API, le token JWT et le secret webhook
5. Important : les Pretty Permalinks doivent être actifs pour que l'endpoint REST fonctionne (Réglages > Permaliens)

Une fois activé, le plugin apparaît dans la liste des extensions actives et enregistre son initialisation dans WooCommerce > Statut > Logs.

Deux modes de synchronisation sont disponibles et peuvent fonctionner en parallèle. L'endpoint de notification offre une réactivité maximale (quelques secondes), à privilégier si votre hébergeur accepte les requêtes HTTP entrantes. Le WP-Cron est plus adapté aux hébergements mutualisés : il interroge l'API Rivalyse à intervalle régulier (configurable, défaut 30 minutes) sans dépendre d'une URL de terminaison REST accessible de l'extérieur.

URL de terminaison REST à déclarer dans le dashboard Rivalyse :

Rivalyse envoie une requête POST signée HMAC-SHA256 à cette URL dès qu'un changement de prix est détecté.

Configuration dans WooCommerce > Rivalyse Sync :

• API URL : URL de votre instance Rivalyse
• Token JWT : votre token d'authentification (à renouveler tous les 7 jours)
• Clé HMAC secrète : le secret affiché à la création de l'endpoint dans le dashboard
• Mode : endpoint temps réel, poll, ou les deux simultanément
• Intervalle poll : fréquence du WP-Cron (défaut 30 min)
• Mettre à jour le prix promo : oui / non

Les deux modes peuvent fonctionner simultanément. En cas de doublon, la mise à jour la plus récente est conservée.

Le plugin identifie chaque produit WooCommerce par son SKU (champ "Référence" dans l'administration WooCommerce). Ce SKU doit être identique à celui configuré dans Rivalyse pour que la synchronisation fonctionne. Un SKU vide ou différent suffit à bloquer la mise à jour : la correspondance est stricte, sensible à la casse et aux espaces.

Pour les produits variables, le plugin met à jour uniquement la variante dont le SKU correspond au SKU Rivalyse. Chaque variante doit donc avoir son propre SKU dans WooCommerce. Les variantes sans correspondance ne sont pas modifiées et aucune erreur fatale n'est levée.

Si aucune correspondance n'est trouvée, le plugin enregistre un avertissement dans WooCommerce > Statut > Logs (source rivalyse-sync) pour faciliter le diagnostic.

La sécurité de l'intégration repose sur trois mécanismes complémentaires : authentification JWT, vérification d'intégrité HMAC et contrôle des permissions WordPress. Chaque requête entrante est validée avant tout traitement. Aucune donnée sensible (prix, références, marges) ne transite en clair. Ce modèle de sécurité est conçu pour répondre aux exigences B2B les plus strictes, sans configuration SSL supplémentaire.

• Signature HMAC-SHA256 sur chaque requête entrante (vérification timing-safe via hash_equals)
• Permission WordPress manage_woocommerce requise pour accéder à la page d'administration
• Token JWT expirant après 7 jours, à renouveler depuis le dashboard Rivalyse
• Ne jamais exposer la clé HMAC secrète ou le token JWT dans le code source ou en dépôt Git
• Le plugin envoie le header X-Module-Version pour faciliter le suivi des mises à jour côté admin

En cas de dysfonctionnement, consultez en priorité WooCommerce > Statut > Logs (source rivalyse-sync), où les messages sont horodatés et classés par niveau de sévérité. La majorité des erreurs provient d'une mauvaise configuration du token JWT, d'une discordance de SKU produit ou d'une URL de terminaison REST inaccessible depuis les serveurs Rivalyse. Vérifiez également que votre hébergeur n'applique pas de règle de pare-feu bloquant les requêtes POST entrantes.

Retrouvez ici les réponses aux questions les plus fréquentes sur l'intégration Rivalyse × WooCommerce. Pour les problèmes techniques non couverts, consultez WooCommerce > Statut > Logs (source rivalyse-sync) ou contactez le support Rivalyse depuis votre dashboard.