> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter Shopify

> Connectez votre boutique Shopify à Automations avec votre propre application Dev Dashboard — sans revue App Store, sans fenêtre de connexion

Shopify n'offre pas d'application de connexion partagée pour les plateformes tierces : une application installée par de nombreuses boutiques doit d'abord passer la revue du Shopify App Store. Famulor connecte donc **votre** boutique via **votre propre** application Shopify. Vous la créez en quelques minutes dans le Shopify Dev Dashboard, l'installez sur votre boutique, puis collez son Client ID et son secret dans Famulor. Famulor les échange contre un jeton Admin API et le renouvelle automatiquement.

Ce que vous obtenez : tous les **déclencheurs et actions** Shopify du [App Catalog](/fr/automations/app-catalog) — commandes, produits, clients, stocks, traitements et remises — ainsi que les outils Shopify que vos assistants peuvent appeler depuis une conversation via une automatisation.

<Note>
  C'est différent de la connexion **Shopify (Storefront MCP)**, qui ne lit que le catalogue public, les paniers et les politiques d'une boutique et ne nécessite aucune application. Utilisez ce guide lorsqu'une automatisation doit lire ou modifier des données de la boutique via l'Admin API.
</Note>

## Avant de commencer

* Vous êtes **propriétaire ou membre de l'équipe avec les droits de développement d'applications** de la boutique Shopify.
* Votre espace de travail Famulor dispose de la plateforme Automation dans son forfait et des **Beta Features** activées (Settings → Workspace → Beta Features).
* Gardez le nom permanent de la boutique à portée de main — le `acme` de `acme.myshopify.com` (Admin Shopify → Paramètres → Domaines). Votre domaine personnalisé ne fonctionnera pas.

La configuration prend environ dix minutes. Le Client ID et le secret restent chez le connecteur d'applications ; Famulor ne les stocke jamais dans votre espace de travail.

## Étape 1 — Ouvrir le Dev Dashboard

Dans votre admin Shopify, tapez **App development** dans la barre de recherche et ouvrez l'entrée des paramètres, ou allez dans **Paramètres → Applications et canaux de vente → Développer des applications**.

<Frame caption="Admin Shopify : recherche « App development »">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/01-search-app-development.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=f076bd5885bef804aa505f9c4e21c404" alt="Recherche dans l'admin Shopify avec App development mis en évidence" width="1696" height="991" data-path="images/automations/shopify/01-search-app-development.png" />
</Frame>

Cliquez sur **Build apps in Dev Dashboard**. Ignorez l'option d'application personnalisée héritée — Shopify la retire progressivement, et la connexion de Famulor utilise le nouveau modèle d'application.

<Frame caption="Ouvrir le Dev Dashboard depuis App development">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/02-build-apps-dev-dashboard.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=95c1e0e6799d6db04c61af12c4888bc9" alt="Page App development avec le bouton Build apps in Dev Dashboard" width="1696" height="951" data-path="images/automations/shopify/02-build-apps-dev-dashboard.png" />
</Frame>

## Étape 2 — Créer l'application

Dans le Dev Dashboard, cliquez sur **Create app** (en haut à droite).

<Frame caption="Dev Dashboard → Create app">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/03-dev-dashboard-create-app.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=19f88b9006e5a5102308de07fbdc892b" alt="Page des applications du Dev Dashboard avec le bouton Create app" width="1696" height="996" data-path="images/automations/shopify/03-dev-dashboard-create-app.png" />
</Frame>

Choisissez **Start from Dev Dashboard**, donnez à l'application un nom que vous reconnaîtrez plus tard (par exemple `famulor-voice`) et cliquez sur **Create**. Shopify CLI n'est pas nécessaire.

<Frame caption="Nommer l'application et cliquer sur Create">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/04-create-app-name.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=69ef0f25e0d71c448a59558c5e8d6b4e" alt="Boîte de dialogue Create an app avec le champ du nom de l'application" width="1696" height="994" data-path="images/automations/shopify/04-create-app-name.png" />
</Frame>

## Étape 3 — Configurer une version avec les scopes dont Famulor a besoin

Ouvrez **Versions** et cliquez sur **Create a version**. Laissez **App URL** sur un espace réservé comme `https://example.com` — Famulor n'héberge pas d'application intégrée — et laissez les URL de redirection vides. Ce type de connexion ne les utilise pas.

<Frame caption="Créer une version : nom et URLs">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/05-create-version.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=2208a9a879742d5adc7c7414f8d59ec4" alt="Formulaire Create a version avec le nom de l'application et les URLs" width="1696" height="991" data-path="images/automations/shopify/05-create-version.png" />
</Frame>

Faites défiler jusqu'à **Access → Scopes** et cliquez sur **Select scopes**.

<Frame caption="Access → Scopes → Select scopes">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/06-access-scopes.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=f27c9baa97ceee40edb0218318cc3d26" alt="Section Access avec le champ Scopes et le lien Select scopes" width="1696" height="991" data-path="images/automations/shopify/06-access-scopes.png" />
</Frame>

Cochez les scopes Admin API pour les données que vos automatisations doivent toucher. Un ensemble par défaut raisonnable :

| Domaine                | Scopes                                                                                                                  |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Commandes              | `read_orders`, `write_orders` (ajoutez `read_all_orders` pour les commandes de plus de 60 jours)                        |
| Produits et stocks     | `read_products`, `write_products`, `read_inventory`, `write_inventory`                                                  |
| Clients                | `read_customers`, `write_customers`                                                                                     |
| Traitement             | `read_fulfillments`, `write_fulfillments`, `read_assigned_fulfillment_orders`, `write_assigned_fulfillment_orders`      |
| Remises et brouillons  | `read_discounts`, `write_discounts`, `read_draft_orders`, `write_draft_orders`, `read_price_rules`, `write_price_rules` |
| Configuration boutique | `read_locations`, `read_shipping`, `write_shipping`, `read_content`, `write_content`                                    |

Ne cocher que les scopes `read_*` pour les domaines utilisés convient aussi. Si une automatisation échoue plus tard avec une erreur de permission, ajoutez le scope ici, publiez une nouvelle version puis reconnectez-vous dans Famulor.

<Frame caption="Choisir les scopes Admin API">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/07-select-scopes-dialog.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=507869128a985676258890d95ff8d0f6" alt="Boîte de dialogue Select scopes listant les scopes Admin API" width="1696" height="1215" data-path="images/automations/shopify/07-select-scopes-dialog.png" />
</Frame>

Cliquez sur **Release** en bas. Dans la boîte de dialogue, vous pouvez nommer la version (par exemple `v1`) — puis confirmez **Release**.

<Frame caption="Publier la version">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/09-release-version.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=643f9234087287fbdbbe55a6ac7c5a50" alt="Boîte de dialogue Release this new version" width="1696" height="1074" data-path="images/automations/shopify/09-release-version.png" />
</Frame>

La nouvelle version est maintenant marquée **Active**.

<Frame caption="La version est active">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/10-version-active.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=ffb5894768431e3046b026ecfee8d249" alt="Liste des versions avec la nouvelle version marquée Active" width="1696" height="911" data-path="images/automations/shopify/10-version-active.png" />
</Frame>

## Étape 4 — Définir la distribution et installer l'application sur votre boutique

Famulor échange les identifiants de l'application contre un jeton Admin API via le grant client-credentials de Shopify. Shopify ne l'autorise qu'une fois l'application **installée sur la boutique**, et l'application comme la boutique doivent appartenir à la même organisation Shopify — ce qui est le cas lorsque vous créez l'application depuis votre propre boutique.

1. Dans le menu de gauche de l'application, ouvrez **Distribution** (sur certains comptes, sous **Home → Distribution**).
2. Choisissez **Custom distribution** et confirmez. La distribution personnalisée est le bon choix pour une application que seule(s) votre/vos propre(s) boutique(s) utilise(nt) ; elle ne nécessite aucune revue App Store.
3. Entrez le domaine `.myshopify.com` de votre boutique, cliquez sur **Generate link** et ouvrez le lien d'installation.
4. Dans votre admin Shopify, examinez les scopes demandés et cliquez sur **Installer**.

<Warning>
  La distribution ne peut être définie qu'une seule fois par application. Choisissez **Custom** — une application publique nécessiterait la revue App Store de Shopify avant que toute boutique puisse l'installer.
</Warning>

## Étape 5 — Copier le Client ID et le secret

Dans les **Settings** de l'application, vous trouverez **Credentials**. Copiez le **Client ID**, révélez et copiez le **Secret**.

<Frame caption="Settings → Credentials : Client ID et Secret">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/11-credentials.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=44f802ade9e0b2b401edb4fe444820a0" alt="Page des paramètres de l'application avec Client ID et Secret" width="1696" height="987" data-path="images/automations/shopify/11-credentials.png" />
</Frame>

Traitez le secret comme un mot de passe. Si vous le faites tourner un jour dans Shopify, reconnectez-vous dans Famulor avec la nouvelle valeur.

## Étape 6 — Connecter dans Famulor

1. Dans Famulor, ouvrez **Automations → Connections** et cliquez sur **Add connection**.
2. Choisissez **Browse apps (Beta)**, recherchez **Shopify** et sélectionnez-le.
3. Entrez le **nom de la boutique** (`acme` ou `acme.myshopify.com` — Famulor le simplifie), le **Client ID** et le **Client secret**.
4. Cliquez sur **Connect Shopify**.

<Frame caption="Famulor : connecter Shopify avec votre propre application">
  <img src="https://mintcdn.com/ouraicall/GpprSBwVbHUR2cht/images/automations/shopify/12-famulor-connect-shopify.png?fit=max&auto=format&n=GpprSBwVbHUR2cht&q=85&s=fdf46a201f9eaf0d02c025a2acdfdaff" alt="Boîte de dialogue de connexion Famulor pour Shopify avec nom de la boutique, Client ID et Client secret" width="1296" height="1117" data-path="images/automations/shopify/12-famulor-connect-shopify.png" />
</Frame>

Famulor valide immédiatement les identifiants auprès de Shopify. En cas de succès, la connexion apparaît comme **ok** dans la liste des Connections, et Shopify est disponible dans l'App Catalog pour chaque automatisation de l'espace de travail.

## Dépannage

| Message                                                         | Signification                                                                           | Solution                                                                                                                         |
| --------------------------------------------------------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| *Shopify does not know this Client ID*                          | L'ID n'appartient à aucune application, ou contient une faute de frappe.                | Recopiez-le depuis Dev Dashboard → votre application → Settings → Credentials.                                                   |
| *Shopify rejected the client secret*                            | Secret incorrect ou changé.                                                             | Révélez le secret actuel dans Settings → Credentials, ou faites-le tourner et utilisez la nouvelle valeur.                       |
| *The app is not installed on this store yet*                    | L'étape 4 a été sautée, ou le lien d'installation a été ouvert pour une autre boutique. | Définissez Custom distribution, générez le lien pour cette boutique et installez.                                                |
| *This store name does not exist*                                | Un domaine personnalisé ou une faute de frappe a été saisi.                             | Utilisez le nom permanent depuis Settings → Domains (`acme` pour `acme.myshopify.com`).                                          |
| Une étape d'automatisation échoue avec une erreur de permission | Un scope manque à la version de l'application.                                          | Ajoutez le scope à l'étape 3, publiez une nouvelle version, puis exécutez **Replace credentials** sur la connexion dans Famulor. |

## Reconnexion et suppression

* **Remplacer les identifiants :** ouvrez la connexion sous Automations → Connections et choisissez **Edit**. Saisissez le nouveau Client ID et secret ; Famulor remplace les identifiants d'application stockés en une seule étape.
* **Supprimer :** la suppression de la connexion retire aussi les identifiants de l'application du connecteur d'applications. Les automatisations qui utilisaient la connexion affichent *Connect needed* jusqu'à ce que vous reconnectiez Shopify.
* Pour révoquer l'accès côté Shopify, désinstallez l'application de votre boutique ou faites tourner le secret dans le Dev Dashboard.

## Voir aussi

* [App Catalog](/fr/automations/app-catalog) — les déclencheurs et actions Shopify disponibles
* [Référence des nœuds d'automatisation](/fr/automations/nodes)
* [Vue d'ensemble des automatisations](/fr/automations/overview)
