Connecter Shopify
À quoi sert cette connexion ?
Section intitulée « À quoi sert cette connexion ? »Shopify permet à ELChat d’assister les visiteurs dans la recherche de produits, la gestion de leur panier ELChat et la création d’un paiement à partir d’une commande brouillon. L’administration peut aussi consulter les performances de vente et les paiements abandonnés.
Fonctionnalité à vérifier — nouvelles boutiques. La version actuelle d’ELChat attend un ancien jeton API Admin permanent au format
shpat_.... Shopify n’autorise plus la création de nouvelles applications personnalisées directement depuis l’administration de la boutique. Les applications existantes continuent de fonctionner, mais le parcours Dev Dashboard actuel doit être validé avec ELChat avant toute nouvelle connexion.
Ce dont vous avez besoin
Section intitulée « Ce dont vous avez besoin »| Identifiant | Rôle dans ELChat | Exemple fictif |
|---|---|---|
| Domaine de boutique | Cible l’administration Shopify | ma-boutique.myshopify.com |
| Jeton API Admin | Autorise les appels au nom de l’application | shpat_xxxxxxxxxxxxxxxxxxxxx |
N’utilisez pas le domaine public personnalisé : ELChat attend le domaine permanent *.myshopify.com.
Étape 1 — Préparer Shopify
Section intitulée « Étape 1 — Préparer Shopify »Si une application personnalisée existante est déjà installée
Section intitulée « Si une application personnalisée existante est déjà installée »- Ouvrez l’application personnalisée utilisée pour ELChat.
- Vérifiez ses autorisations API Admin.
- Accordez les accès nécessaires aux produits, commandes, clients et commandes brouillon en lecture et/ou écriture selon les capacités ci-dessous.
- Récupérez son jeton d’accès API Admin au format
shpat_....
Les fonctions actuelles utilisent le catalogue, les commandes, les clients, les paiements abandonnés et les commandes brouillon. Le détail exact des noms de scopes à sélectionner pour un nouveau projet Shopify est : Information à compléter après adaptation d’ELChat au parcours Dev Dashboard actuel.
Consultez la documentation Shopify sur les jetons Admin avant de créer ou modifier une application.
Si vous n’avez aucune application existante
Section intitulée « Si vous n’avez aucune application existante »Ne générez pas un jeton au hasard. La création actuelle passe par le Shopify Dev Dashboard ou la CLI et peut produire des jetons dont le cycle de vie diffère de celui attendu par ELChat.
Information à compléter : procédure ELChat validée pour provisionner et renouveler un jeton d’une nouvelle application Shopify.
Étape 2 — Connecter Shopify à ELChat
Section intitulée « Étape 2 — Connecter Shopify à ELChat »- Ouvrez Dashboard > votre site > Actions IA > Connecteurs.
- Sur la carte Shopify, cliquez sur Connecter.
- Renseignez le domaine
ma-boutique.myshopify.com, sanshttps://ni chemin supplémentaire. - Collez le jeton API Admin
shpat_.... - Validez.
Étape 3 — Vérifier la connexion
Section intitulée « Étape 3 — Vérifier la connexion »La carte doit afficher Connecté. Demandez ensuite à ELChat de rechercher un produit publié connu et vérifiez son prix et son stock. N’utilisez la génération de paiement qu’après ce test de lecture, car elle crée une vraie commande brouillon.
Que peut faire ELChat avec Shopify ?
Section intitulée « Que peut faire ELChat avec Shopify ? »| Domaine | Capacité réellement disponible | Type |
|---|---|---|
| Catalogue | Rechercher un produit, consulter ses détails et son stock | Lecture |
| Panier ELChat | Consulter, ajouter, retirer, vider et changer une quantité | État local ELChat |
| Client | Créer un client | Écriture |
| Paiement | Créer une vraie commande brouillon et retourner son URL de facture/paiement | Écriture |
| Commandes | Consulter le statut d’une commande | Lecture |
| Ventes | Consulter un résumé et les produits les plus vendus | Lecture administrateur |
| Abandons | Lister les paiements abandonnés | Lecture administrateur |
ELChat ne crée pas de produit, ne modifie pas le stock, ne rembourse pas de commande et ne lance pas directement un prélèvement Shopify.
Limitations
Section intitulée « Limitations »- Le panier est conservé par ELChat et n’est pas la session de panier native du thème Shopify.
- La création de paiement produit une commande brouillon réelle ; aucun paiement n’est prélevé par cette action.
- Les meilleures ventes et le résumé sont calculés sur un échantillon plafonné à 250 commandes pour la période.
- La liste des paiements abandonnés est plafonnée à 50 éléments par appel.
- La compatibilité avec le nouveau modèle de jetons Shopify doit être validée avant une première connexion moderne.
Reconnecter ou déconnecter
Section intitulée « Reconnecter ou déconnecter »Pour remplacer un jeton, déconnectez Shopify dans ELChat, reconnectez-le avec le nouveau jeton, puis testez une recherche produit. Révoquez ensuite l’ancien accès depuis Shopify. Le bouton Désactiver arrête l’utilisation dans ELChat, mais la révocation dans Shopify reste nécessaire pour invalider le jeton.
Problèmes fréquents
Section intitulée « Problèmes fréquents »Le jeton n’est pas au format attendu
Section intitulée « Le jeton n’est pas au format attendu »ELChat attend actuellement un jeton API Admin shpat_.... Un autre type de jeton peut appartenir au nouveau modèle Shopify et ne pas être compatible.
Accès refusé sur une fonction précise
Section intitulée « Accès refusé sur une fonction précise »Les permissions de l’application sont insuffisantes. Vérifiez les accès aux produits, commandes, clients et commandes brouillon, puis réinstallez ou réautorisez l’application si Shopify le demande.
Mauvaise boutique ou aucune donnée
Section intitulée « Mauvaise boutique ou aucune donnée »Utilisez le domaine permanent myshopify.com, pas le domaine public, et vérifiez que le jeton provient de cette même boutique.
Sécurité
Section intitulée « Sécurité »Le jeton API Admin peut donner accès à des données personnelles et commerciales. Conservez-le comme un mot de passe, limitez les autorisations de l’application et révoquez immédiatement tout jeton exposé.