Configurer l'intégration Shopify
Avec l'intégration Shopify, votre agent IA lit les données en direct de votre boutique Shopify. Les clients qui demandent "où est ma commande ?", "l'avez-vous encore en stock ?" ou "mon retour est-il approuvé ?" obtiennent une réponse immédiate, en langage naturel, 24h/24.
En bref
Heyloha se connecte à votre boutique Shopify via une custom app. Vous le configurez vous-même en 5 minutes depuis le dashboard Heyloha. Lecture seule, chiffré, sans code.
Ce que votre agent peut faire
- Vérifier le statut d'une commande. L'agent trouve une commande par numéro et répond avec les détails d'expédition et de suivi.
- Rechercher des produits. L'agent parcourt votre catalogue par mot-clé, marque ou type et retourne jusqu'à 10 résultats avec prix et disponibilité.
- Vérifier le stock. L'agent récupère les stocks en direct par variante. En cas de stock faible, il dit "il en reste quelques-uns" plutôt qu'un nombre exact.
- Rapporter le statut d'un retour. L'agent recherche les retours associés à une commande et rapporte le statut en langage naturel.
Les quatre capacités sont en lecture seule. L'agent ne peut ni modifier de commande, ni annuler, ni changer le stock.
Prérequis
- Un compte Heyloha avec au moins un agent IA créé.
- Accès admin à votre boutique Shopify, spécifiquement la capacité de créer des custom apps.
- Environ 5 minutes.
Pas besoin de développeur, de compte Shopify Partner ou de code. Le flux custom app fonctionne sur tous les plans Shopify.
Connecter Shopify
Ouvrir les paramètres Shopify dans Heyloha
Dans le dashboard Heyloha, cliquez sur Paramètres dans le menu de gauche. Sous Systèmes externes, cliquez sur Shopify. Vous verrez une carte par site web. Cliquez sur "Connecter Shopify" sur le site web à lier.
Autoriser le développement de custom apps (nouvelles boutiques)
Les boutiques créées à partir de 2026 ont le développement de custom apps désactivé par défaut. Dans l'admin Shopify, allez dans Paramètres → Apps et canaux de vente → Développer des apps. Si vous voyez un bouton "Autoriser le développement de custom apps", cliquez-le et confirmez.
Créer la custom app dans Shopify
Allez dans Paramètres → Apps et canaux de vente → Développer des apps et cliquez sur "Créer une app". Donnez-lui un nom reconnaissable, par exemple "Heyloha".
Configurer les scopes Admin API
Cliquez sur l'onglet Configuration, puis sur Configurer à côté de Admin API integration. Cochez exactement ces quatre scopes : read_orders, read_products, read_inventory et read_returns. Enregistrez.
Installer l'app et copier le token
Allez dans l'onglet API credentials et cliquez sur "Installer l'app" en haut. Le token Admin API apparaît (commence par shpat_ suivi de 32 caractères). Copiez-le immédiatement : Shopify ne l'affiche qu'une seule fois.
Coller domaine et token dans Heyloha
Dans la fenêtre Heyloha, collez votre domaine de boutique (se termine toujours par .myshopify.com, même avec un domaine personnalisé) et le token Admin API. Cliquez sur Connecter. La carte passe à Connecté avec votre domaine et la date.
Vous avez oublié de copier le token ? Shopify ne l'affiche qu'une seule fois. Vous devrez désinstaller et réinstaller l'app pour en obtenir un nouveau.
Ça fonctionne ?
Pour vérifier que la connexion marche :
- Ouvrez le widget de chat Heyloha sur votre site (ou un autre canal).
- Posez une question comme "Vendez-vous [produit connu] ?". L'agent devrait retourner des résultats avec prix et disponibilité.
- Demandez le statut d'une de vos commandes (par exemple "où est la commande #1001 ?"). L'agent répond ou demande d'abord l'email client, selon votre politique de vérification.
L'agent dit encore "quelqu'un va vous recontacter" après la connexion ? Un scope manque probablement ou le token est incorrect. Voir Dépannage ci-dessous.
Gérer la connexion
Mettre en pause
Désactivez l'interrupteur Actif sur la carte. L'agent arrête immédiatement d'appeler Shopify pour ce site web. Plus de recherches de commandes, plus de recherches de produits. Réactivation en un clic, sans reconnexion.
Faire tourner le token
Sur la carte connectée, cliquez sur le menu trois points et choisissez "Faire tourner le token". Générez un nouveau token Admin API dans Shopify (même app, onglet API credentials) et collez-le. Le nouveau remplace l'ancien sans interruption.
Faites-le si l'ancien token a été partagé par erreur, si un collègue a réinstallé l'app, ou si un audit de sécurité exige une rotation périodique.
Se déconnecter
Dans le menu trois points, choisissez Déconnecter. Heyloha demande confirmation et liste ce que l'agent perdra : statut de commande, recherche de produits, vérification de stock, statut de retour. Après confirmation, le token est définitivement supprimé.
Sécurité
- Le token Admin API est stocké chiffré (AES-256). La clé est en dehors de la base de données.
- Le token n'apparaît jamais dans les réponses API, les logs ou les messages d'erreur. En cas de 401, Heyloha log "auth échouée pour intégration X", pas le token.
- L'agent ne peut que lire : aucune modification de commande, stock ou produit.
- Isolé par site web. Un agent pour la boutique A ne peut littéralement pas voir les données de la boutique B. Vérifié à chaque appel.
Dépannage
"Autoriser le développement de custom apps" manquant dans Shopify
Votre rôle Shopify n'a pas la permission "Développer des apps". Le propriétaire (ou un admin avec permissions complètes) doit l'activer une fois, ou accorder la permission à votre compte.
"Le domaine doit se terminer par .myshopify.com"
Vous avez collé un domaine personnalisé (par exemple www.acme.com) au lieu du domaine interne Shopify (acme.myshopify.com). Trouvez le domaine interne dans Shopify admin → Paramètres → Domaines sous "Gérés par Shopify".
"Ce n'est pas un token Shopify valide"
Le token doit commencer par shpat_ suivi de 32 caractères hexadécimaux. Erreurs fréquentes : copie de l'API key ou API secret au lieu du token Admin API, espaces copiés autour, ou token Storefront API utilisé.
L'agent dit encore "quelqu'un va vous recontacter"
Causes possibles : la connexion est désactivée (vérifiez la carte), un scope manque (voir bannière), ou le token a été révoqué dans Shopify. Réinstallez l'app, copiez le nouveau token et utilisez "Faire tourner le token" dans Heyloha.
Questions fréquentes
Ça marche sur tous les plans Shopify ?
Oui. Le flux custom app est disponible sur tous les plans Shopify, y compris Basic, Advanced, Plus et les essais gratuits.
L'agent peut-il modifier des commandes ?
Pas encore. Les quatre capacités sont en lecture seule. Les actions d'écriture comme l'annulation ou le remboursement ne sont volontairement pas déployées : elles demandent de meilleurs flux de vérification client.
Mes clients verront-ils "Shopify" dans le chat ?
Non. L'agent répond en langage naturel sans nommer le système sous-jacent. Il dit "votre commande a été expédiée avec DHL", pas "selon Shopify, votre commande...".
Configurer les intégrations CRM et webhookConfigurer l'intégration HubSpot