Intégrations e-commerce

Collectez des avis clients
automatiquement

Installez notre plugin sur votre boutique en ligne. Après chaque commande, vos clients reçoivent automatiquement une invitation à déposer un avis vérifié sur GlobeReviews. Zéro intervention manuelle.

PrestaShop WooCommerce Shopify Magento

API REST Tester l'intégration Codes d'erreur FAQ

Comment ça fonctionne

Installez le plugin

Uploadez le module dans votre CMS en 2 minutes

Configurez la clé API

Collez votre clé API depuis l'espace marchand GlobeReviews

Un client commande

Le plugin envoie automatiquement les données à GlobeReviews

Avis collecté

Le client reçoit un email et dépose un avis vérifié

Prérequis

Plan Premium GlobeReviews — L'accès API est réservé aux marchands Premium (79€ HT/mois ou 790€ HT/an). Voir les tarifs
Clé API — Générez-la dans Espace Marchand > Intégrations
Profil marchand revendiqué — Votre fiche entreprise doit être revendiquée et votre abonnement actif

PrestaShop

Compatible : 1.7 — 8.x

Le module GlobeReviews pour PrestaShop s'intègre nativement dans votre back-office. Il intercepte automatiquement les changements de statut de commande et envoie les données client à l'API GlobeReviews pour déclencher une demande d'avis après un délai configurable.

Fonctionnalités

Installation en 2 minutes via le back-office
Choix du statut déclencheur (Livré, Expédié, Payé...)
Envoi automatique de l'email client, prénom, n° de commande et liste produits
Widget de confiance automatique dans le footer
Compatible PrestaShop 1.7 à 8.x
Logs d'erreurs dans le journal PrestaShop

Installation

1Téléchargez le fichier ZIP du module ci-dessous
2Dans votre back-office PrestaShop, allez dans Modules > Gestionnaire de modules
3Cliquez sur « Installer un module » et uploadez le ZIP
4Une fois installé, cliquez sur « Configurer »
5Collez votre clé API GlobeReviews (disponible dans Espace Marchand > Intégrations)
6Entrez votre slug marchand GlobeReviews (ex: mon-entreprise)
7Sélectionnez le statut de commande déclencheur (recommandé : « Livré »)
8Activez le module et sauvegardez

Télécharger le plugin PrestaShop (v1.0.0)

Documentation technique — PrestaShop

Hook / Événement

actionOrderStatusPostUpdate

Widget : displayFooter

Données transmises à GlobeReviews

ID de commande (préfixé PS-)
Plateforme (prestashop)
Email client
Prénom et nom du client
Date de commande
Montant total TTC
Devise
Liste des produits (nom + référence)

Clés de configuration

Clé	Description
`GLOBEREVIEWS_API_KEY`	Clé API Premium GlobeReviews
`GLOBEREVIEWS_MERCHANT_SLUG`	Identifiant marchand pour le widget
`GLOBEREVIEWS_TRIGGER_STATUS`	ID du statut de commande déclencheur
`GLOBEREVIEWS_ENABLED`	Activer/désactiver l'envoi (0 ou 1)

Configuration côté GlobeReviews

Dans Espace Marchand > Intégrations > Paramètres, vous pouvez configurer :

Délai d'envoi — Nombre de jours après la commande (1 à 30, défaut : 7)
Langue— Français ou Anglais pour l'email d'invitation
Activation— Activer/désactiver l'envoi automatique sans modifier le plugin

WooCommerce

Compatible : 5.0+ (WordPress 5.0+, PHP 7.4+)

Le plugin GlobeReviews pour WooCommerce utilise le système d'intégration natif de WooCommerce. Il se déclenche automatiquement lorsqu'une commande passe au statut « Terminée » et envoie les informations nécessaires à l'API GlobeReviews.

Fonctionnalités

Installation standard WordPress (upload ZIP)
Configuration dans WooCommerce > Réglages > Intégration
Déclenchement automatique sur commande terminée
Transmission de tous les produits de la commande (nom + SKU)
Widget de confiance dans le footer du thème
Compatible WooCommerce 5.0+ et WordPress 5.0+
Utilise wp_remote_post() — aucune dépendance cURL

Installation

1Téléchargez le fichier ZIP du plugin ci-dessous
2Dans votre admin WordPress, allez dans Extensions > Ajouter
3Cliquez sur « Téléverser une extension » et uploadez le ZIP
4Activez le plugin « GlobeReviews - Avis Clients »
5Allez dans WooCommerce > Réglages > Intégration
6Cochez « Envoyer les commandes à GlobeReviews »
7Collez votre clé API GlobeReviews
8Entrez votre slug marchand et sauvegardez

Télécharger le plugin WooCommerce (v1.0.0)

Documentation technique — WooCommerce

Hook / Événement

woocommerce_order_status_completed

Widget : wp_footer

Données transmises à GlobeReviews

ID de commande (préfixé WC-)
Plateforme (woocommerce)
Email de facturation
Prénom et nom de facturation
Date de création de commande
Montant total
Devise
Liste des produits (nom + SKU)

Clés de configuration

Clé	Description
`enabled`	Activer/désactiver l'envoi des commandes
`api_key`	Clé API Premium GlobeReviews
`merchant_slug`	Identifiant marchand pour le widget

Configuration côté GlobeReviews

Dans Espace Marchand > Intégrations > Paramètres, vous pouvez configurer :

Délai d'envoi — Nombre de jours après la commande (1 à 30, défaut : 7)
Langue— Français ou Anglais pour l'email d'invitation
Activation— Activer/désactiver l'envoi automatique sans modifier le plugin

Shopify

Compatible : Toutes les boutiques Shopify (Basic, Shopify, Advanced, Plus)

L'intégration Shopify ne nécessite aucune application à installer. Vous avez le choix entre trois méthodes selon votre niveau technique : webhook natif Shopify (recommandé, 2 min), automatisation Shopify Flow (no-code, dispo sur tous les plans depuis 2023), ou simple lien dans l'email de confirmation (zéro config). Notre plugin officiel Shopify, distribué sur le Shopify App Store avec installation en un clic, arrive prochainement.

Fonctionnalités

Méthode 1 — Webhook natif : configuration en 2 minutes, aucune app
Méthode 2 — Shopify Flow : automatisation no-code (Basic et +)
Méthode 3 — Lien Liquid dans l'email de confirmation : zéro config
Authentification sécurisée via votre clé API GlobeReviews
Extraction automatique : email client, nom, produits, montant
Widget de confiance embedable via un snippet de thème
Plugin officiel Shopify App Store : bientôt disponible

Installation

1Générez votre clé API dans Espace Marchand > Intégrations > Clés API
2Notez le préfixe de votre clé (affiché dans le dashboard, ex: gr_live_abc12345)
3Dans votre admin Shopify, allez dans Paramètres > Notifications > Webhooks
4Cliquez sur « Créer un webhook »
5Événement : sélectionnez « Order fulfillment »
6Format : JSON
7URL : collez https://globe-reviews.com/api/webhooks/shopify?key=VOTRE_PRÉFIXE (remplacez VOTRE_PRÉFIXE par le préfixe de votre clé API)
8Cliquez sur « Sauvegarder » — c'est terminé !
9Pour le widget, ajoutez ce code dans votre thème (theme.liquid, avant </body>) :

Plugin officiel Shopify App Store — bientôt disponible

Un plugin natif, installation en un clic depuis le Shopify App Store, OAuth automatique et widget produit intégré au thème, est en cours de développement et de review chez Shopify. En attendant, trois méthodes simples sont déjà disponibles ci-dessous.

Recommandé

Méthode 1 — Webhook natif Shopify (2 min)

Vous recevez automatiquement les commandes expédiées. C'est la méthode la plus robuste : Shopify gère les retries en cas d'échec et transmet l'intégralité des données produit.

Dans Shopify : Paramètres > Notifications > Webhooks > Créer un webhook, événement « Order fulfillment », format JSON, URL à coller :

https://globe-reviews.com/api/webhooks/shopify?key=VOTRE_PRÉFIXE_API

Remplacez VOTRE_PRÉFIXE_API par le préfixe de votre clé, visible dans Espace Marchand > Intégrations.

No-code

Méthode 2 — Shopify Flow

Si vous préférez une interface visuelle sans toucher aux webhooks, créez un workflow dans Shopify Flow (inclus sur tous les plans depuis 2023, gratuit).

Depuis votre admin, installez Shopify Flow via l'App Store (gratuit, 30 sec).
Créez un nouveau workflow : trigger « Order fulfilled ».
Ajoutez une action « Send HTTP request ».
Méthode : POST. URL : https://globe-reviews.com/api/webhooks/orders.
Headers : Content-Type: application/json et x-api-key: gr_live_VOTRE_CLE.
Body (JSON) : utilisez les variables Shopify Flow pour orderId, customer.email, etc. Voir la section Référence API pour le schéma.
Activez le workflow — terminé.

Minimal

Méthode 3 — Lien dans l'email de confirmation (zéro config)

Pour les plus pressés : collez un bouton « Donner mon avis »directement dans votre template d'email de confirmation de commande. Pas d'API, pas de webhook, mais pas d'"achat vérifié" automatique non plus.

Dans Shopify : Paramètres > Notifications > Confirmation de commande > Modifier le code, collez avant la balise </body> :

<a href="https://globe-reviews.com/deposer-avis?merchant=VOTRE_SLUG&order={{ order_name }}&email={{ email }}"
   style="display:inline-block;padding:12px 24px;background:#00b67a;color:#fff;
          text-decoration:none;border-radius:8px;font-weight:bold;">
  Donner mon avis sur GlobeReviews
</a>

Remplacez VOTRE_SLUG par l'identifiant de votre fiche GlobeReviews (ex: mon-entreprise).

Documentation technique — Shopify

Hook / Événement

orders/fulfilled (Shopify Webhook)

Widget : Snippet dans theme.liquid

Données transmises à GlobeReviews

ID de commande Shopify (préfixé shopify-)
Plateforme (shopify)
Email client
Prénom et nom du client
Date de création
Montant total
Devise
Produits de la commande (titre + SKU)

Clés de configuration

Clé	Description
`key (query param)`	Préfixe de votre clé API GlobeReviews — identifie votre boutique

Configuration côté GlobeReviews

Dans Espace Marchand > Intégrations > Paramètres, vous pouvez configurer :

Délai d'envoi — Nombre de jours après la commande (1 à 30, défaut : 7)
Langue— Français ou Anglais pour l'email d'invitation
Activation— Activer/désactiver l'envoi automatique sans modifier le plugin

Magento 2

Compatible : Magento 2.3+

Le module GlobeReviews pour Magento 2 utilise un observer sur l'événement d'expédition. Il se déclenche automatiquement lorsqu'une expédition est créée et envoie les données de commande à l'API GlobeReviews pour déclencher une demande d'avis.

Fonctionnalités

Observer natif Magento 2 sur l'événement d'expédition
Configuration via Stores > Configuration > GlobeReviews
Envoi automatique : email client, nom, produits, montant, devise
Compatible Magento 2.3+
Logs d'erreurs dans le journal Magento

Installation

1Téléchargez le fichier ZIP du module ci-dessous
2Décompressez dans app/code/GlobeReviews/Reviews/ de votre installation Magento
3Exécutez : bin/magento module:enable GlobeReviews_Reviews
4Exécutez : bin/magento setup:upgrade
5Exécutez : bin/magento cache:flush
6Allez dans Stores > Configuration > GlobeReviews
7Collez votre clé API et votre slug marchand
8Activez le module et sauvegardez

Télécharger le plugin Magento 2 (v1.0.0)

Documentation technique — Magento 2

Hook / Événement

sales_order_shipment_save_after (observer)

Widget : Bloc CMS ou layout XML

Données transmises à GlobeReviews

ID de commande (préfixé MAG-)
Plateforme (magento)
Email client
Prénom et nom du client
Date de commande
Montant total
Devise
Liste des produits

Clés de configuration

Clé	Description
`globereviews/general/api_key`	Clé API Premium GlobeReviews
`globereviews/general/merchant_slug`	Identifiant marchand
`globereviews/general/enabled`	Activer/désactiver

Configuration côté GlobeReviews

Dans Espace Marchand > Intégrations > Paramètres, vous pouvez configurer :

Délai d'envoi — Nombre de jours après la commande (1 à 30, défaut : 7)
Langue— Français ou Anglais pour l'email d'invitation
Activation— Activer/désactiver l'envoi automatique sans modifier le plugin

Référence API REST

Pour les développeurs qui souhaitent intégrer GlobeReviews dans un CMS personnalisé ou un système sur mesure.

POST /api/webhooks/orders

Enregistre une commande pour déclencher l'envoi d'une invitation d'avis après le délai configuré.

Headers requis

Content-Type: application/json
x-api-key: gr_live_votre_cle_api

Body (JSON)

{
  "orderId": "CMD-12345",        // Requis — ID unique de la commande
  "platform": "api",             // Optionnel — "prestashop", "shopify", "woocommerce", "magento", "api"
  "customer": {
    "email": "[email protected]", // Requis — Email du client
    "firstName": "Jean",           // Optionnel
    "lastName": "Dupont"           // Optionnel
  },
  "orderDate": "2026-04-15T10:30:00Z", // Requis — Date ISO 8601 (max 90 jours)
  "orderTotal": 89.90,                  // Optionnel — Montant TTC
  "currency": "EUR",                    // Optionnel — Défaut : EUR
  "products": [                          // Optionnel — Liste des produits
    { "name": "T-shirt bleu", "sku": "TSH-001" }
  ]
}

Réponses

201Commande créée

{ "success": true, "orderId": "cl...", "sendAt": "2026-04-22T10:30:00Z" }

409Commande déjà enregistrée (idempotent)

{ "error": "Cette commande a déjà été enregistrée." }

401Clé API invalide ou plan non Premium

429Rate limit dépassé (100 requêtes/minute)

Exemple cURL

curl -X POST https://globe-reviews.com/api/webhooks/orders \
  -H "Content-Type: application/json" \
  -H "x-api-key: gr_live_votre_cle_api" \
  -d '{
    "orderId": "CMD-12345",
    "platform": "api",
    "customer": { "email": "[email protected]", "firstName": "Jean" },
    "orderDate": "2026-04-15T10:30:00Z",
    "orderTotal": 89.90,
    "products": [{ "name": "T-shirt bleu", "sku": "TSH-001" }]
  }'

Widget de confiance

Affichez votre note GlobeReviews directement sur votre site pour renforcer la confiance de vos visiteurs. Le widget fonctionne sur tous les CMS, sans plugin — il suffit d'ajouter une ligne de code.

Remplacez votre-slugpar l'identifiant de votre fiche marchand (visible dans l'URL de votre page GlobeReviews : globe-reviews.com/avis/votre-slug).

Tester votre intégration

Validez votre intégration avant la mise en production, sans attendre une vraie commande.

Envoyez un test

Depuis votre terminal, lancez la requête cURL ci-dessous avec votre clé API.

Vérifiez dans le dashboard

La commande apparaît en quelques secondes dans Espace marchand > Intégrations > Commandes.

Recevez l'email

Utilisez votre propre adresse, réglez le délai d'envoi à 1 jour pour voir le rendu final.

Requête de testcURL

curl -X POST https://globe-reviews.com/api/webhooks/orders \
  -H "Content-Type: application/json" \
  -H "x-api-key: gr_live_VOTRE_CLE" \
  -d '{
    "orderId": "TEST-001",
    "platform": "api",
    "customer": { "email": "[email protected]", "firstName": "Test" },
    "orderDate": "2026-04-19T10:00:00Z",
    "orderTotal": 1.00
  }'

Réponse attendue : HTTP 201 avec {"success":true,…}. Changez TEST-001 à chaque essai pour éviter un 409.

Codes d'erreur HTTP

Ce que renvoie l'API et comment y réagir côté client.

Code	Signification	Action recommandée
`201`	Commande créée, invitation programmée.	Rien — c'est le cas normal.
`400`	Payload invalide (email, date, orderDate > 90 jours).	Vérifier les champs envoyés. Ne pas retry.
`401`	Clé API invalide, révoquée, ou plan non Premium.	Vérifier la clé et l'abonnement.
`409`	Commande déjà enregistrée (même orderId).	Traiter comme un succès.
`429`	Rate limit dépassé (100 req/min par marchand).	Backoff exponentiel + retry.
`5xx`	Erreur serveur GlobeReviews.	Retry avec backoff (1s, 2s, 4s, 8s).

FAQ et dépannage

Les questions les plus fréquentes sur l'intégration.

Le module ne s'installe pas dans mon CMS. Que faire ?

Vérifiez que vous avez téléchargé la dernière version du ZIP depuis cette page. Les anciens ZIPs (avant avril 2026) avaient une arborescence incorrecte. Téléchargez à nouveau et réessayez. Pour Magento, n'oubliez pas bin/magento module:enable GlobeReviews_Reviews puis setup:upgrade.

Mes commandes n'arrivent pas dans GlobeReviews. Que vérifier ?

1) Clé API correctement collée, sans espace, et active. 2) Abonnement Premium actif. 3) Plugin activé dans l'admin. 4) Pour PrestaShop : le statut déclencheur correspond à celui de vos commandes (ex. Livré). 5) Consultez les logs de votre CMS (PrestaShop → Paramètres avancés > Logs, WooCommerce → Statut > Logs, Magento → var/log/system.log).

Quel délai entre la commande et l'email d'invitation ?

Configurable dans l'espace marchand (1 à 30 jours). Recommandé : 7 jours pour les produits, 3 jours pour les services, 1 jour pour les produits numériques.

Le même client est-il contacté plusieurs fois ?

Non. GlobeReviews dédoublonne automatiquement : pas plus d'une invitation par couple (marchand, email) sur 30 jours glissants.

Une erreur GlobeReviews peut-elle bloquer ma boutique ?

Non. Nos plugins utilisent un timeout court (5 s) et un try/catch silencieux : même si GlobeReviews est indisponible, le changement de statut de commande dans votre CMS se fait normalement.

Puis-je utiliser une clé API pour plusieurs boutiques ?

Oui, tant que toutes les boutiques correspondent au même marchand. Pour plusieurs fiches marchandes distinctes, il faut une clé par fiche.

Combien de clés API puis-je avoir ?

Jusqu'à 3 clés actives simultanément. Pratique pour isoler prod / staging / preprod.

Puis-je passer en HTTPS uniquement ?

L'API GlobeReviews ne répond que sur HTTPS. Aucune configuration particulière n'est requise.

Comment révoquer une clé ?

Espace marchand > Intégrations > Clés API > bouton Révoquer. La révocation est immédiate.

Puis-je tester sur un environnement de staging ?

Les plugins officiels proposent un champ URL de l'API configurable. Si GlobeReviews vous fournit un environnement de test, collez cette URL dans ce champ sans republier le plugin.

Prêt à automatiser vos avis clients ?

Souscrivez au plan Premium, générez votre clé API, et installez le plugin en 2 minutes.

Voir les tarifs Premium Accéder à mon espace marchand

Collectez des avis clientsautomatiquement

Comment ça fonctionne

Installez le plugin

Configurez la clé API

Un client commande

Avis collecté

Prérequis

PrestaShop

Fonctionnalités

Installation

Hook / Événement

Données transmises à GlobeReviews

Clés de configuration

Configuration côté GlobeReviews

WooCommerce

Fonctionnalités

Installation

Hook / Événement

Données transmises à GlobeReviews

Clés de configuration

Configuration côté GlobeReviews

Shopify

Fonctionnalités

Installation

Plugin officiel Shopify App Store — bientôt disponible

Méthode 1 — Webhook natif Shopify (2 min)

Méthode 2 — Shopify Flow

Méthode 3 — Lien dans l'email de confirmation (zéro config)

Hook / Événement

Données transmises à GlobeReviews

Clés de configuration

Configuration côté GlobeReviews

Magento 2

Fonctionnalités

Installation

Hook / Événement

Données transmises à GlobeReviews

Clés de configuration

Configuration côté GlobeReviews

Référence API REST

POST /api/webhooks/orders

Headers requis

Body (JSON)

Réponses

Exemple cURL

Widget de confiance

Tester votre intégration

Envoyez un test

Vérifiez dans le dashboard

Recevez l'email

Codes d'erreur HTTP

FAQ et dépannage

Prêt à automatiser vos avis clients ?

Collectez des avis clients
automatiquement