Skip to main content
Shopify est l’intégration phare d’Actero. Une fois connectée, ton agent répond aux WISMO (« où est ma commande ? »), gère retours, échanges, suivi, recommande des produits et personnalise chaque réponse avec le profil client — sans toucher à ta caisse.

​
Prérequis

  • Une boutique Shopify active (plan Basic, Shopify, Advanced ou Plus — peu importe)
  • Le rôle Owner ou Staff avec permission « Apps » dans ton compte Shopify
  • Un compte Actero avec au moins le plan Free (50 tickets/mois) — plan Starter ou supérieur recommandé pour les playbooks panier abandonné

​
Installer Actero depuis le Shopify App Store

L’app Actero est en cours d’examen par Shopify et pas encore publiée sur l’App Store. En attendant, le bouton Intégrations → Shopify → Connecter t’affiche un message : écris-nous et on connecte ta boutique manuellement. Les étapes ci-dessous décrivent l’installation telle qu’elle se passera dès la publication.
L’installation est gratuite et passe par le flow OAuth officiel — tu vois exactement ce que l’agent peut lire avant de valider.
1

Ouvre la fiche Actero sur le Shopify App Store

Depuis le Shopify App Store, cherche Actero et clique Ajouter l’app. Tu peux aussi partir d’Actero : Intégrations → Shopify → Connecter — on te redirige vers la fiche. Tu n’as aucune adresse à saisir : Shopify sait de quelle boutique il s’agit.
2

Valide les scopes requis et optionnels

Shopify affiche deux blocs distincts : les permissions requises (sans elles, l’agent ne peut pas fonctionner) et les permissions optionnelles (tu peux les décliner — l’agent dégradera gracieusement les fonctionnalités concernées). Voir Scopes demandés.
3

Approuve l'installation

Tu reviens automatiquement sur actero.fr, sur une page qui confirme que ta boutique est connectée. L’installation ne déclenche aucun paiement : tu choisis ta formule ensuite, et elle est facturée par Shopify, sur la même facture que le reste de tes apps.
4

Crée ton compte Actero (première installation seulement)

Si tu découvres Actero par l’App Store, tu n’as pas encore de compte : la page de confirmation te propose d’en créer un. Ta boutique se rattache automatiquement au compte dès l’inscription — tu n’as aucun identifiant de boutique à recopier, aucun jeton à coller.Si tu avais déjà un compte Actero, cette étape est sautée : la boutique est rattachée immédiatement et tu arrives directement sur ton dashboard.
5

Active le widget de chat

Le widget est livré comme une extension de thème (theme app extension) — Actero ne modifie jamais ton theme.liquid. Active le bloc Actero AI Support depuis Boutique en ligne → Thèmes → Personnaliser → Widgets d’application (App embeds), puis enregistre. La page Bulle SAV d’Actero indique alors « Bulle vue sur la boutique ».
Si tu n’as pas encore configuré ton agent, regarde le quickstart — c’est la suite logique de cette connexion.

​
Bouton « Open app » dans Shopify Admin

Une fois installée, Actero apparaît dans Apps dans ton Shopify Admin. Cliquer dessus t’envoie automatiquement vers le bon endroit :
  • Boutique déjà connectée → redirection directe vers ton dashboard Actero
  • Boutique connectée mais pas encore rattachée à un compte → page de confirmation avec la création de compte
  • Première fois → relance du flow OAuth pour finaliser l’install
Tu n’as donc jamais à coller manuellement une URL : Shopify Admin reste ton point d’entrée.

​
Scopes demandés

Actero sépare scopes requis et optionnels. Tu peux décliner les optionnels sans casser l’install ; les fonctionnalités correspondantes restent simplement inactives jusqu’à ce que tu les accordes.

​
Scopes requis

Lecture des commandes et des expéditions. Indispensable pour répondre aux WISMO et donner un ETA fiable au client.
Identifier le client qui pose la question, personnaliser le ton et reconnaître les clients VIP.
Répondre aux questions catalogue (taille, matière, prix) et stock (« est-ce qu’il en reste en M ? »).
Détecter les paniers abandonnés pour le playbook de relance.
Répondre aux questions sur la politique et le statut des retours.
Actero ne demande aucun scope de thème (read_themes / write_themes). Le widget de chat est une extension de thème (theme app extension) que tu actives depuis l’éditeur de thème — aucune modification de ton code n’est nécessaire.

​
Scopes optionnels

Donne du contexte d’upsell dans les conversations (devis en cours, panier construit par un staff). Sans ce scope, l’agent ignore les drafts.
Permet à l’agent de citer un tarif de livraison en direct (« combien coûte une livraison express vers Lyon ? »). Sans ce scope, l’agent répond avec une formulation générique.
Actero ne demande que des scopes en lecture — aucun scope d’écriture (commandes, produits, stock, thème) ni de paiement. Les demandes de remboursement sont escaladées à ton équipe, qui les traite elle-même dans Shopify Admin ; l’agent n’encaisse jamais et ne modifie jamais une commande, un produit ou ton inventaire.

​
Webhooks configurés automatiquement

À l’installation, Actero enregistre cinq webhooks. Tous sont signés HMAC-SHA256 et vérifiés en temps constant (crypto.timingSafeEqual) côté Actero.

​
Conformité (obligatoires App Store)

Chaque appel à un webhook de conformité est tracé (hash SHA-256 du payload, jamais le payload brut) dans un journal d’audit append-only conservé pour démontrer la conformité RGPD.

​
Métier

Tu peux désactiver un playbook depuis Automatisation sans toucher à l’intégration Shopify.

​
Quelles données circulent

  • Commandes (numéro, statut, total, items, tracking) → réponses WISMO et SAV
  • Clients (nom, email, langue, historique) → personnalisation du ton, reconnaissance des VIP
  • Produits (titre, description, variantes, prix, stock) → questions catalogue
  • Paniers abandonnés (items, total, email, URL de checkout) → relances automatiques
Tout est stocké chiffré côté Actero (Supabase, RLS activée, isolation par client_id). Aucune donnée n’est jamais partagée avec un autre marchand.

​
Une boutique par compte

Un compte Actero se connecte à une boutique Shopify, quel que soit le plan. Si tu vends dans plusieurs pays avec Shopify Markets, c’est une seule boutique : l’agent couvre tous tes marchés et domaines. Si tu gères deux boutiques distinctes, crée un second compte Actero : chaque agent reste isolé et garde son ton, sa base de connaissances et ses métriques.
Une seule plateforme e-commerce active par compte. Si tu connectes ensuite WooCommerce ou Webflow, Actero te demande de déconnecter Shopify d’abord.

​
Désinstallation

Deux chemins, même résultat :
  • Depuis Shopify Admin → Apps → Actero → Supprimer l’app. Shopify déclenche le webhook app/uninstalled ; Actero révoque le token, désactive le widget et marque ta boutique comme désinstallée dans les secondes qui suivent.
  • Depuis Actero → Intégrations → Shopify → Déconnecter. Effet équivalent côté Actero, plus suppression manuelle des webhooks via l’API Shopify Admin.
Les conversations passées restent dans ton historique pour des raisons RGPD (export et suppression possibles depuis Export RGPD). Si Shopify déclenche shop/redact 48h après la désinstallation, toutes les données scoped à ta boutique sont effacées définitivement côté Actero.

​
Problèmes fréquents

Vérifie que Shopify est bien en statut Connecté dans Intégrations. L’agent matche d’abord par email client, puis par numéro de commande. Si le client a passé sa commande en invité avec une autre adresse email que celle utilisée dans la conversation, demande-lui de confirmer son email d’achat.
Le secret HMAC a probablement tourné (rotation côté Shopify). Déconnecte puis reconnecte l’intégration depuis Actero — les webhooks sont régénérés avec un secret frais.
Trois choses à vérifier : (1) le playbook panier abandonné est activé dans Automatisation, (2) un service d’envoi est configuré (Resend, Gmail ou SMTP/IMAP), (3) le client a bien laissé son email à l’étape checkout (sans email, pas de relance possible).
Vérifie que le bloc Actero AI Support est activé dans les App embeds : Boutique en ligne → Thèmes → Personnaliser → Widgets d’application (App embeds). S’il est déjà activé, désactive-le puis réactive-le pour forcer un rechargement du thème.
Reconnecte l’intégration avec le nouveau domaine. Tes commandes restent lisibles par l’agent, le nouveau token prend le relais.
Utilise Tester mon agent (plan Starter et plus) ou, sur toute formule, le test de démarrage. Rien n’est envoyé à tes clients et rien n’est écrit dans Shopify (accès en lecture seule). Mais ces tests passent par le vrai agent : ils comptent dans ton quota de tickets du mois, et un test qui escalade envoie la vraie alerte à ton équipe. Voir Tester ton agent.

​
FAQ

Pas encore : l’app est en cours d’examen par Shopify. Une fois publiée, l’installation passera par le flow OAuth officiel Shopify : les scopes seront visibles, révocables à tout moment et auditables depuis Shopify Admin → Apps → Actero → Voir les détails de l’app. En attendant, écris à contact@actero.fr pour une connexion manuelle.
Non. Le rattachement de ta boutique reste valable 30 jours après l’installation. Reviens sur la page de confirmation depuis Shopify Admin → Apps → Actero, crée ton compte, et la boutique se rattache. Passé ce délai, il suffit de relancer l’installation depuis Shopify Admin.
Non : l’agent lit les commandes en direct dans Shopify quand un client en parle, et seulement sur le plan Pro. À l’installation, Actero importe tes produits actifs (100 au plus, dans la limite de la base de connaissances de ton plan) et lit les pages de politiques de ton site. Les fiches produit sont une photo prise à l’installation : elles ne se mettent pas à jour seules.
Tu choisis. Par défaut, l’agent signe avec le nom de ta marque. Tu peux activer une signature explicite (« Réponse assistée par notre agent IA ») depuis Configurer l’agent → Identité.
Si tu réinstalles dans les 48h, tes données sont encore là — tu retrouves ton agent configuré tel quel. Au-delà, Shopify a déclenché shop/redact et tout a été effacé : tu repars d’une page blanche.