Actions Shopify
Connectez une boutique Shopify pour que votre agent puisse rechercher dans votre catalogue et consulter le statut d’une commande dans la conversation.
Connectez une boutique Shopify à votre agent : il pourra répondre aux questions produits à partir de votre catalogue en direct et consulter le statut d’une commande pendant une conversation. Ceci est distinct de l’ajout du widget de chat sur votre boutique en ligne — voir Intégration Shopify pour cela.
Connecter d’abord votre boutique
Les deux actions nécessitent une boutique connectée.
- Accédez à l’onglet Actions de votre agent
- Ouvrez Intégrations et repérez la carte Shopify
- Saisissez le domaine de votre boutique au format
store-name.myshopify.com - Complétez l’écran d’autorisation de Shopify
La carte affiche ensuite l’état de la connexion et vous permet de Reconnecter ou de Déconnecter. Si la connexion nécessite votre attention, une bannière orange apparaît avec une invite à reconnecter.
La connexion est propre à chaque agent. Chaque agent connecte sa propre boutique, de sorte qu’un agent qui doit répondre pour une boutique différente obtient sa propre connexion plutôt que d’en partager une.
Quels accès sont demandés
Sur l’écran d’autorisation, Agentkit demande exactement deux portées en lecture seule :
| Portée | Utilisée pour |
|---|---|
read_products | Rechercher dans votre catalogue |
read_orders | Consulter le statut d’une commande |
Aucune portée d’écriture n’est demandée. La connexion utilise également le jeton hors ligne par défaut de Shopify — la demande omet volontairement l’option d’octroi par utilisateur — afin que l’agent continue de fonctionner après que la personne ayant connecté la boutique s’est déconnectée.
Ce sont les portées demandées par l’implémentation actuelle. Shopify décide séparément des données qu’une application est autorisée à recevoir : certains champs client et commande sont protégés, et le fait de se voir accorder read_orders ne garantit pas à lui seul que chaque champ sera renvoyé.
Les deux actions
Chaque action est ajoutée et configurée séparément sous Actions.
Rechercher des produits
Permet à l’agent de rechercher dans le catalogue de la boutique connectée lorsqu’un visiteur pose une question sur les produits, les prix ou la disponibilité. Elle peut restreindre les résultats par requête, par un prix maximum optionnel et par une limite de résultats.
Les résultats contiennent uniquement les produits actifs publiés sur votre boutique en ligne. La disponibilité provient du stock global du produit dans Shopify et tient compte des produits dont le stock n'est pas suivi.
La consigne « Quand l’utiliser » par défaut est « Use when the user wants to find products, compare prices, or check whether an item is available. » (en français, en substance : « À utiliser lorsque le visiteur souhaite trouver des produits, comparer des prix ou vérifier la disponibilité d’un article. ») Modifiez-la pour correspondre à la façon dont vos visiteurs s’expriment.
Statut de commande
Recherche une seule commande. Le visiteur doit fournir à la fois le numéro de commande et l’e-mail de commande, et les deux doivent correspondre à la même commande avant que quoi que ce soit ne soit renvoyé.
Cette combinaison est une mesure de confidentialité : un numéro de commande seul est facile à deviner ou à surprendre, il ne suffit donc jamais. Si la commande n’existe pas, ou si l’e-mail ne correspond pas à la commande, l’agent reçoit la même réponse générique « We could not find an order matching those details. » (en français, en substance : « Nous n’avons trouvé aucune commande correspondant à ces informations. ») — il ne peut pas savoir lequel des deux était erroné, et le visiteur non plus.
Les commandes plus anciennes peuvent produire la même réponse « introuvable » même lorsque le numéro et l’e-mail sont corrects : Agentkit demande la portée standard read_orders de Shopify, qui couvre les commandes récentes de la boutique (environ les 60 derniers jours), et non l’historique complet des commandes, approuvé séparément. Si les recherches sur les commandes anciennes comptent pour votre boutique, attendez-vous à devoir orienter les visiteurs concernés vers votre support à la place.
La consigne « Quand l’utiliser » par défaut est « Use when the user asks for an order status or tracking details and can provide the order number and checkout email. » (en français, en substance : « À utiliser lorsque le visiteur demande le statut d’une commande ou des informations de suivi et peut fournir le numéro de commande et l’e-mail de commande. »)
Deux conditions pour activer une action
Les deux doivent être remplies avant qu’une action puisse être activée :
- Une boutique connectée - sans cela, le bouton d’activation affiche un message intégré renvoyant vers Actions → Intégrations
- Un forfait payant - la même exigence que pour API personnalisée, Recherche web, Lire les liens de documents et les actions de réservation
Vous pouvez toujours créer, modifier et enregistrer l’une ou l’autre action pendant qu’elle est désactivée, même sans qu’aucun des deux prérequis ne soit rempli. Les conditions ne s’appliquent qu’à l’activation.
Dépannage
L’autorisation OAuth est terminée, mais les recherches de commande ne renvoient rien. Vérifiez le format du numéro de commande utilisé par votre boutique et confirmez que l’e-mail que vous testez est bien l’e-mail de commande associé à cette commande. Vérifiez ensuite l’éligibilité de l’application aux données client et commande protégées sur la boutique — l’accès à ces données doit être nécessaire à l’application et peut être restreint par Shopify. Demander des portées plus larges ne change rien à cela, et une reconnexion ne garantit pas l’approbation.
L’agent répond à partir du contenu d’entraînement plutôt que du catalogue. Précisez la consigne « Quand l’utiliser » pour que les questions sur les produits, les prix et la disponibilité soient clairement dirigées vers l’action de recherche.
La carte affiche un avertissement de reconnexion. L’autorisation enregistrée n’est plus utilisable. Cliquez sur Reconnecter et complétez à nouveau l’écran d’autorisation. La reconnexion rétablit la connexion mais pas les actions : lorsque l’autorisation enregistrée échoue, les deux actions Shopify sont désactivées automatiquement, et l’écran d’autorisation ne les réactive pas. Après la reconnexion, retournez dans Actions et réactivez chaque action que vous souhaitez utiliser.