Boutique Shopify

La source Boutique Shopify permet à Relancia de lire les commandes de votre boutique en ligne. Vous pouvez ainsi relancer automatiquement les clients qui n’ont pas finalisé un achat.

Cette page vous guide pas à pas, depuis la création de l’application privée dans Shopify jusqu’à l’import des premières commandes dans Relancia.

Ce que cette source permet de faire

• voir les nouvelles commandes dans Relancia
• détecter les clients qui ont ajouté un produit sans acheter
• relancer les clients qui ont abandonné leur panier
• envoyer un email de confirmation après une commande
• suivre les retours et les remboursements

Ce dont vous avez besoin

Avant de commencer, préparez :

• une boutique Shopify active (plan minimum : Shopify Basic)
• un accès administrateur à votre boutique
• l’URL de votre boutique (par exemple atelier-martin.myshopify.com)

Comprendre le parcours en 5 étapes

Pour brancher Shopify dans Relancia, vous allez suivre ce parcours :

1. Activer le développement d’apps dans votre admin Shopify
2. Créer une application privée pour Relancia
3. Configurer les droits (scopes) sur les commandes et les clients
4. Installer l’application et récupérer la clé Admin API
5. Copier les identifiants dans Relancia

Étape 1 : activer le développement d’apps

1. connectez-vous à admin.shopify.com
2. dans le menu de gauche, ouvrez Paramètres (l’icône engrenage en bas)
3. cliquez sur Applications et canaux de vente
4. cliquez sur Développer des applications (en haut à droite de la section)
5. si Shopify vous demande de confirmer, cliquez sur Autoriser le développement d’applications personnalisées

Étape 2 : créer une application privée

1. sur la page Applications personnalisées, cliquez sur Créer une application
2. donnez un nom à l’application (par exemple Relancia)
3. dans le champ Email du développeur d’applications, entrez votre email
4. cliquez sur Créer une application

Shopify crée l’application et vous amène sur sa page de configuration.

Étape 3 : configurer les droits (scopes)

Avant d’installer l’application, configurez les droits dont Relancia a besoin.

1. dans le menu de gauche de l’application, cliquez sur Configuration
2. ouvrez la section Accès à l’API Admin
3. dans la liste des scopes, activez au minimum :
   • read_orders : lire les commandes
   • read_customers : lire les clients
   • read_products : lire les produits (utile pour certaines relances)
   • read_returns : lire les retours
   • read_inventory : lire le stock (optionnel)
4. vous pouvez aussi activer write_orders si vous voulez modifier des commandes depuis Relancia
5. cliquez sur Enregistrer

Étape 4 : installer l’application

1. dans le menu de gauche, cliquez sur Installer l’application
2. cliquez sur Installer en haut à droite
3. Shopify affiche un récapitulatif des droits accordés
4. confirmez en cliquant sur Installer

Une fois installée, l’application apparaît dans la liste de vos applications installées.

Étape 5 : récupérer les clés d’API

Sur la page de l’application installée, dans l’onglet Clés d’API :

1. copiez la Clé d’API Admin (Admin API access token) : c’est la Clé privée boutique
2. copiez la Clé API (API key) : c’est la Clé de vérification
3. gardez aussi l’URL de la boutique : visible en haut, par exemple atelier-martin.myshopify.com

La clé d’API Admin ne s’affiche qu’une seule fois. Si vous la perdez, révoquez-la et créez-en une nouvelle.

Configurer le webhook Shopify (optionnel mais recommandé)

Pour que Relancia reçoive les événements Shopify en temps réel (nouvelle commande, panier abandonné, etc.) :

1. dans l’admin Shopify, ouvrez Paramètres puis Notifications
2. en bas de la page, cliquez sur Créer un webhook
3. dans Événement, choisissez par exemple Création de commande
4. dans Format, choisissez JSON
5. dans URL, collez l’URL fournie par Relancia (zone Liens à copier)
6. cliquez sur Enregistrer le webhook

Répétez l’opération pour les autres événements qui vous intéressent.

Étape 1 : ouvrir la source dans Relancia

Une fois votre application Shopify configurée :

1. connectez-vous à app.relancia.pro
2. dans le menu de gauche, ouvrez Sources
3. cliquez sur Ajouter un service
4. dans la liste, choisissez Boutique Shopify

L’interface Relancia affiche trois zones :

• Informations à remplir
• Clés privées
• Liens à copier

Étape 2 : remplir les informations

Renseignez les champs un par un :

• Domaine de la boutique : votre URL *.myshopify.com (par exemple atelier-martin.myshopify.com)
• Version de connexion : laissez la valeur par défaut proposée par Relancia
• Version des retours : laissez la valeur par défaut proposée par Relancia

Ne mettez pas https:// devant le domaine, juste la partie *.myshopify.com.

Étape 3 : ajouter les clés privées

Dans la zone Clés privées :

• Clé privée boutique : collez la Clé d’API Admin (Admin API access token) récupérée dans Shopify
• Clé de vérification : collez la Clé API (API key) récupérée dans Shopify

Ces clés sont sensibles. Ne les partagez jamais.

Étape 4 : copier le lien du webhook

Si Relancia affiche une URL dans la zone Liens à copier :

1. copiez l’URL
2. retournez dans l’admin Shopify
3. ouvrez Paramètres puis Notifications
4. créez un webhook Shopify avec cette URL (voir section « Configurer le webhook Shopify »)

Étape 5 : enregistrer et tester

1. dans Relancia, cliquez sur Enregistrer
2. cliquez sur Tester
3. Relancia contacte l’API Shopify et vérifie la connexion
4. si tout est bon, le statut passe à Prêt

Vérifier l’import des commandes

Une fois la source active :

1. ouvrez la page Contacts dans Relancia
2. les clients Shopify devraient apparaître
3. ouvrez la page Appels ou Messages (selon votre configuration)
4. les événements Shopify devraient remonter

Les premières commandes peuvent mettre quelques minutes à apparaître.

Que faire si la source reste en À vérifier

Vérifiez les points suivants dans l’ordre :

• le Domaine de la boutique est bien au format *.myshopify.com sans https://
• la Clé privée boutique correspond bien à la Clé d’API Admin (et non à une autre clé)
• la Clé de vérification correspond bien à la Clé API de l’application
• les droits read_orders et read_customers sont activés dans l’application Shopify
• l’application est bien installée (et non seulement créée)
• le token n’a pas été révoqué

Que faire si Shopify retourne une erreur 401

Cela signifie un problème d’authentification :

• vérifiez que la clé d’API est correcte (régénérez-la si nécessaire)
• vérifiez que l’application est installée
• vérifiez que les droits demandés sont bien activés

Que faire si Shopify retourne une erreur 403

Cela signifie un problème de droits :

• retournez dans Shopify, ouvrez l’application, onglet Configuration
• vérifiez que les scopes read_orders et read_customers sont activés
• sauvegardez et réinstallez l’application si nécessaire

Bonnes pratiques

• limitez les droits de l’application à la lecture seule si possible
• ne partagez jamais votre Clé privée boutique
• notez la date d’expiration de la clé : Shopify peut vous demander de la renouveler
• reliez Shopify seulement après avoir configuré WhatsApp ou Emails
• testez l’import avec une commande réelle avant d’activer des relances
• faites une sauvegarde des clés dans un gestionnaire de mots de passe

Aller plus loin

• Boutique PrestaShop : si vous utilisez PrestaShop plutôt que Shopify
• Emails : pour envoyer des relances aux clients Shopify
• Import et relance : pour relancer une base importée

Documentation officielle Shopify

Pour aller plus loin, voici les liens directs vers la documentation Shopify :

• Admin Shopify : l’accueil de votre boutique
• Documentation sur les apps personnalisées
• API Admin Shopify
• Documentation sur les webhooks
• Aide Shopify - Applications personnalisées

Accès rapides à votre boutique

Une fois l’application installée, voici les chemins utiles dans l’admin Shopify :

• Paramètres (icône engrenage en bas à gauche)
• Applications et canaux de vente : pour voir vos applications installées
• Notifications : pour gérer les webhooks
• Paramètres > Modes de paiement : pour vérifier les modes de paiement