Shopify
Connectez votre boutique Shopify une fois et vos agents répondent à partir de votre catalogue, de vos commandes et de votre stock. La configuration prend environ cinq minutes, se fait entièrement dans Cuneiform Chat, et ne demande ni modification du thème ni extension à installer.
Shopify fonctionne sur tous les forfaits, y compris l’essai gratuit. Connecter une boutique ne coûte rien de plus.
Ce que vous obtenez
Une fois la boutique connectée, votre agent de boutique peut :
- Répondre aux questions sur le catalogue à partir de vos produits, variantes, options et prix réels
- Lire le stock et le prix depuis votre catalogue synchronisé, tenu à jour par les webhooks, pour ne pas proposer ce que vous venez d’épuiser
- Recommander des produits en stock plutôt que ce dont il se souvient
- Consulter des commandes pour les acheteurs capables de prouver que la commande est la leur
- Envoyer des mises à jour de statut aux acheteurs qui s’y abonnent, dans la même conversation
- Amener un acheteur décidé à votre checkout Shopify avec son panier intact
Prérequis
- Une boutique Shopify que vous administrez
- Un espace de travail Cuneiform Chat et un compte Owner ou Admin dessus — connecter une boutique est une action d’administration
- Au moins un agent, ou de la place dans votre forfait pour en créer un (voir Votre agent de boutique)
Les comptes collaborateur ne peuvent pas terminer la configuration. Une partie se passe dans le Dev Dashboard de votre admin Shopify, que Shopify ne propose pas aux comptes collaborateur. Si une agence gère votre boutique, cette partie revient au propriétaire de la boutique — ou à un compte staff disposant des permissions sur les apps.
Comment fonctionne la connexion
Vous créez une petite application dans votre propre admin Shopify, vous l’installez sur votre boutique, et vous collez ses identifiants dans Cuneiform Chat. Les données de votre boutique ne quittent votre compte Shopify par aucune autre voie, et l’application vous appartient plutôt qu’à nous.
Le pas-à-pas vit dans le produit, où il peut vous montrer les valeurs exactes à saisir pour votre boutique : elles dépendent de votre espace de travail et de la version de l’API que nous exécutons, donc une copie ici deviendrait obsolète sans vous prévenir.
Pour commencer : ouvrez Commerce → Shopify dans Cuneiform Chat et suivez les étapes de l’écran de connexion. Il vous guide pour créer l’application, demander les permissions ci-dessous, l’installer, puis coller les identifiants.
Installer l’application est une étape à part entière. Dans le Dev Dashboard de Shopify, publier une version de votre application n’équivaut pas à l’installer sur votre boutique. Si vous vous arrêtez à la publication, les identifiants sont refusés au moment de les coller — et l’écran de connexion le dit explicitement.
Les permissions que nous demandons
Votre application demande cinq permissions en lecture seule. Il n’y a aucune permission d’écriture dans l’ensemble : elle ne peut rien modifier dans votre boutique.
| Permission | Pourquoi nous en avons besoin |
|---|---|
read_products | Lire votre catalogue : produits, variantes, options, prix, images |
read_inventory | Lire les niveaux de stock pour que l’agent ne recommande que le disponible |
read_orders | Retrouver la commande d’un acheteur et lui envoyer des mises à jour |
read_fulfillments | Indiquer l’avancement de l’expédition de ces commandes |
read_customers | Rapprocher le téléphone de l’acheteur de la commande sur laquelle il interroge |
Lecture seule veut dire lecture seule. L’application ne peut pas créer, modifier ou supprimer de produits ; ne peut pas ajuster le stock ; ne peut pas créer, modifier ou annuler de commandes ; et ne peut pas encaisser. Chaque achat se conclut sur votre propre checkout Shopify.
Si une permission n’est pas accordée
Shopify restreint l’accès aux clients et aux commandes sur ses forfaits les moins chers : une boutique en Basic ou Starter peut donc ne pas pouvoir accorder read_orders ni read_customers. Dans ce cas la connexion aboutit quand même et Cuneiform Chat vous indique les permissions manquantes — sur l’écran de connexion, puis sur Commerce → Shopify → Connection tant que le manque persiste.
Tout ce qui dépend d’une permission absente reste désactivé plutôt que d’échouer en silence ; les victimes habituelles sont la consultation de commandes et les mises à jour de statut. Une fois que le forfait de votre boutique les couvre, déconnectez puis reconnectez la boutique pour que les nouvelles permissions soient prises en compte.
Ouvrir Cuneiform Chat dans votre admin Shopify
En option, votre application peut être marquée embedded, ce qui fait s’ouvrir votre tableau de bord Cuneiform Chat à l’intérieur d’admin.shopify.com, aux côtés du reste de l’administration de votre boutique — configuration, état de la connexion, réglages et tableau de bord. L’écran de connexion vous fournit les deux valeurs que Shopify réclame. Passer cette étape ne change rien au fonctionnement de l’intégration ; cela change seulement l’endroit d’où vous l’ouvrez.
Une boutique par espace de travail
Un espace de travail connecte une boutique Shopify. Il peut aussi avoir une boutique WooCommerce connectée en même temps — voir Commerce.
Si vous tentez de connecter une boutique déjà rattachée à un autre espace de travail, la tentative est refusée plutôt que de la reprendre silencieusement.
Modifier les permissions ou les identifiants plus tard
Il n’y a pas de bouton « Reconnect » distinct. Les permissions et les identifiants de votre application sont enregistrés à la connexion et ne sont pas réécrits ensuite : tout changement fait côté Shopify — ajouter un scope, faire tourner le client secret — parvient à Cuneiform Chat en déconnectant puis reconnectant la boutique.
Reconnecter rejoue le démontage décrit dans Déconnexion : lisez-le d’abord si des Storefronts sont rattachées à la boutique.
Après la connexion
- Votre catalogue commence à se synchroniser immédiatement. Voir Catalogue et connaissances pour ce que couvre la synchronisation et comment elle reste à jour.
- Un agent devient votre agent de boutique, choisi pour vous à la connexion. Voir Votre agent de boutique.
- Les mises à jour de statut sont actives par défaut, et la seule condition appartient à l’acheteur : il s’y abonne après avoir vérifié sa commande. Voir Commandes.
Les prix et la devise de votre boutique
Les prix se synchronisent avec les montants que votre boutique détient, dans la devise de votre propre boutique — celle que nomment les réglages de votre boutique Shopify. Nous la lisons dans la boutique, jamais chez l’acheteur, et les acheteurs la voient sous la forme du code à trois lettres accolé au montant : USD 19,99, EUR 19,99, BDT 1900.
Un code plutôt qu’un symbole, c’est délibéré. $ à lui seul désigne le dollar de quatre pays différents, et un symbole faux affirmé avec aplomb sur un prix est pire qu’un code sans ambiguïté.
La devise est relue lors de la réconciliation nocturne du catalogue : si vous la changez dans Shopify, le code cité suit sous un jour. Jusqu’à ce premier passage nocturne, une boutique connectée avant que nous ne la lisions cite des montants sans code — le prix reste juste, il n’est simplement pas encore étiqueté.
La tarification Shopify Markets n’est pas répercutée. Si vous vendez sur plusieurs marchés dotés de leurs propres devises, Shopify présente à chaque acheteur un prix local sur votre boutique. Nous stockons une devise par boutique — celle de votre boutique — donc l’agent cite la même à tous les acheteurs, où qu’ils soient.
Les montants restent justes dans la devise dont ils portent l’étiquette ; ils ne sont simplement pas les chiffres convertis par marché que ce même acheteur verrait sur votre site. Le paiement n’est pas affecté : l’acheteur termine sur votre checkout Shopify, qui applique vos règles de marché comme d’habitude.
Dépannage
Les identifiants ont été refusés
La cause la plus fréquente : l’application a été publiée mais jamais installée sur la boutique — ce sont deux actions distinctes dans le Dev Dashboard de Shopify. L’écran de connexion distingue ce cas d’un véritable écart d’identifiants, alors lisez le message qu’il affiche plutôt que de supposer que le Client ID et le Secret sont faux.
La consultation de commandes et les mises à jour d’expédition sont indisponibles
Regardez sur Commerce → Shopify → Connection s’il y a un avis de permission manquante. Sur les forfaits Shopify les moins chers, read_orders et read_customers peuvent être impossibles à accorder — voir Si une permission n’est pas accordée.
Le catalogue est vide juste après la connexion
Le premier import récupère tout le catalogue et prend quelques minutes sur une grande boutique. S’il paraît toujours vide ensuite, lancez Re-sync now depuis Commerce → Shopify → Catalog & Data. Tant que le catalogue est vide, la checklist de l’onglet Overview propose aussi un Sync now en un clic.
L’agent ne répond pas aux questions sur les produits
Vérifiez que vous parlez bien à l’agent de boutique — celui rattaché à la boutique au moment de la connexion. Sa page affiche un panneau en lecture seule indiquant qu’il est géré par votre boutique. Les autres agents ne portent pas les outils commerce.
Un Member n’arrive pas à connecter la boutique
Connecter une boutique demande la permission Integration connect, que possèdent les Owners et les Admins, mais pas les Members.
Déconnexion
Déconnectez depuis Commerce → Shopify → Disconnect. La déconnexion :
- Supprime la connexion enregistrée et le catalogue synchronisé
- Efface les connaissances produit construites à partir de ce catalogue, de sorte que les agents cessent d’y répondre
- Réinitialise l’habilitation commerce de l’agent de boutique, rétablit sa persona commerce si vous ne l’avez jamais modifiée, et archive l’agent lui-même — reconnecter la même boutique le récupère avec ses réglages et son historique de versions intacts
- Supprime définitivement toute Storefront rattachée à cette boutique, ainsi que son historique d’analytics. Les Storefronts que vous avez construites à la main ne sont pas touchées
- Archive les Agent Forms commerce venus avec la boutique
- Supprime les suggestions de quiz générées par l’IA, pour qu’une reconnexion future reparte de zéro
Si une boutique WooCommerce est encore connectée, seules les étapes valables pour tout l’espace de travail sont ignorées — archiver les Agent Forms commerce et supprimer les suggestions de quiz. Le catalogue, les connaissances produit, les Storefronts, les analytics et l’agent propres à la boutique Shopify sont toujours démontés.
Votre application reste installée dans votre admin Shopify. Se déconnecter ici retire notre côté de la relation, pas l’application que vous avez créée — elle appartient à votre boutique. Supprimez-la depuis votre admin Shopify si vous voulez qu’elle disparaisse.
Voir aussi
- Vue d’ensemble de Commerce — ce qu’apporte la connexion d’une boutique
- WooCommerce — l’autre plateforme prise en charge
- Catalogue et connaissances — comment le catalogue se synchronise et reste à jour
- Commandes — consultation des commandes et mises à jour de statut
- Checkout — amener un acheteur jusqu’à l’achat