by FlowHunt
Commencer
Documentation
MCP Glossaire Ouvrir l'application

Intégrations

Shopify avec une application personnalisée

Connectez une boutique Shopify à AmICited avec votre propre application personnalisée du Shopify Dev Dashboard au lieu de l’application de l’App Store : autorisations, Client ID et secret, et limites.

Ouvrir dans ChatGPT Ouvrir dans Claude

La manière habituelle de connecter Shopify est l’application FlowHunt du Shopify App Store (voir boutiques en ligne). Si vous ne voulez pas d’application publique sur votre boutique, ou si la politique de votre boutique bloque les installations depuis l’App Store, vous pouvez vous connecter avec une application personnalisée que vous créez vous-même dans le Shopify Dev Dashboard.

Une fois connectée, une application personnalisée fonctionne comme une installation depuis l’App Store : devis d’import, import historique des commandes et des produits, rapports Eshop, link building et CMS.

Les intégrations e-commerce sont disponibles à partir de l’offre Pro, et seuls les administrateurs de l’espace de travail peuvent les connecter.

Avant de commencer#

  • Utilisez l’organisation Shopify de la boutique elle-même. L’application doit appartenir à la même organisation Shopify que la boutique. Une agence ne peut pas utiliser sa propre application sur la boutique d’un client : c’est le client qui doit créer l’application.
  • Facturation par carte. Les espaces de travail facturés via Shopify ne peuvent pas utiliser d’application personnalisée. Passez d’abord l’offre en facturation par carte.
  • Autorisations Shopify. Vous devez pouvoir créer des applications dans le Dev Dashboard de la boutique (le propriétaire de la boutique, ou un compte employé autorisé à développer des applications).

Créer l’application dans Shopify#

  1. Ouvrir le développement d’applications dans l’administration Shopify

    Dans l’administration Shopify, cliquez sur Settings, puis sur Apps, puis sur Develop apps, et cliquez sur Build apps in Dev Dashboard. Vous pouvez aussi aller directement sur le Shopify Dev Dashboard et vous connecter avec le compte propriétaire de la boutique.

    Accueil de l'administration Shopify avec Settings dans le menu en bas à gauche
    Settings de l'administration Shopify avec Apps dans le menu
    Paramètres Apps de l'administration Shopify avec le bouton Develop apps
    Page de développement d'applications avec le bouton Build apps in Dev Dashboard

  2. Créer l’application

    Dans le Dev Dashboard, ouvrez Apps et cliquez sur Create app. Si votre organisation a déjà des applications, cliquez sur Create app en haut à droite et choisissez Create app manually.

    Page Apps du Shopify Dev Dashboard
    Lien Create app sous Get API credentials dans le Dev Dashboard

  3. Renseigner l’application et ses autorisations

    • App name (1) : un nom que vous reconnaîtrez, par exemple « AmICited ».
    • App URL (2) : https://app.flowhunt.io/. Décochez Embed app in Shopify admin ; l’application n’a pas d’écran propre dans Shopify.
    • Allowed redirection URL(s) : laissez vide. AmICited se connecte avec le Client ID et le Client secret de l’application, Shopify ne redirige donc jamais vers AmICited. Laissez Use legacy install flow décoché.
    • Scopes (3, sous API access) : collez cette liste. Ce sont les autorisations demandées par l’application de l’App Store : l’application personnalisée obtient ainsi toutes les fonctionnalités d’AmICited, sauf l’historique des commandes de plus de 60 jours (voir ci-dessous) :
    text
    read_orders,write_orders,read_products,write_products,read_customers,write_customers,read_inventory,write_inventory,read_locations,write_price_rules,read_content,write_content,read_themes,write_themes,read_locales

    Laissez Webhooks API version tel quel.

    Formulaire Create an app du Dev Dashboard avec App name, les URL, Scopes et Webhooks API version

    Vous préférez cocher des cases plutôt que coller ? Cliquez sur Select from list au-dessus du champ Scopes, recherchez chaque autorisation de la liste ci-dessus (1), cochez-la et cliquez sur Done (2).

    Lien Select from list au-dessus du champ Scopes
    Boîte de dialogue Select scopes avec le champ de recherche et le bouton Done

  4. Créer l’application

    Une fois le nom, l’URL et les autorisations renseignés, cliquez sur Create app en haut à droite du formulaire (4 sur la capture du formulaire ci-dessus). Shopify crée l’application et publie sa première version.

    Le bouton Create app en haut à droite du formulaire Create an app

  5. Vérifier que la version est active

    Ouvrez Versions dans le menu de l’application : la première version est marquée Active. Si vous modifiez les autorisations plus tard, cliquez sur Create version pour que la modification prenne effet.

    Page Versions du Dev Dashboard avec la première version marquée Active

  6. Définir la distribution sur personnalisée

    Une application personnalisée doit être limitée à votre propre boutique avant de pouvoir y être installée.

    1. Dans la page Overview de l’application, cliquez sur la carte Distribution (Manage custom install link). Shopify ouvre le Partners Dashboard ; si on vous le demande, choisissez le compte que vous utilisez pour la boutique.
    2. Sélectionnez Custom distribution (1) et cliquez sur Select (2). Shopify ne permet plus de modifier la méthode de distribution par la suite.
    3. Sous Store domain, saisissez l’adresse your-store.myshopify.com de votre boutique (1 ; voir Trouver l’adresse de votre boutique plus bas) et cliquez sur Generate link (2). L’option Allow multi-store install for one Plus organization ne compte que si votre boutique appartient à une organisation Shopify Plus comptant plusieurs boutiques.
    Overview de l'application dans le Dev Dashboard avec la carte Distribution
    Sélecteur de compte Shopify pour le Partners Dashboard (flouté)
    Page Distribution avec Custom distribution et le bouton Select
    Formulaire Custom distribution avec le champ Store domain et le bouton Generate link

  7. Installer l’application sur votre boutique

    L’application ne peut rien lire tant qu’elle n’est pas installée sur la boutique.

    1. Ouvrez la page Overview de l’application dans le Dev Dashboard et cliquez sur Install app en haut de la carte Installs. Dans certains tableaux de bord, ce bouton s’intitule Test app, comme sur la capture ci-dessous. Vous pouvez aussi ouvrir le menu ⋯ sur la ligne de l’application dans la liste Apps et choisir Install app.
    2. Choisissez la boutique à connecter.
    3. Examinez les accès demandés par l’application et cliquez sur Install.
    Overview de l'application dans le Dev Dashboard avec le bouton Test app sous Installs
    Sélecteur de boutiques Shopify avec la boutique sur laquelle installer l'application
    Écran Update data access dans l'administration Shopify avec le bouton Install

    L’écran avertit que « This app hasn’t been reviewed ». C’est normal : il s’agit de votre propre application, pas d’une application de l’App Store.

  8. Copier le Client ID et le Client secret

    Ouvrez Settings de l’application dans le Dev Dashboard. Sous Credentials, copiez le Client ID et le Client secret (utilisez les boutons de copie à côté de chaque champ). Traitez le secret comme un mot de passe.

    L'élément Settings de l'application dans le menu du Dev Dashboard
    Section Credentials avec le Client ID (flouté)
    Section Credentials avec le Client secret

Les applications personnalisées importent les 60 derniers jours de commandes

Shopify ne renvoie les commandes de plus de 60 jours qu’aux applications disposant de l’autorisation read_all_orders, et le Dev Dashboard la refuse sur une application personnalisée (« Contains invalid scopes: read_all_orders »). Une connexion par application personnalisée importe donc les commandes des 60 derniers jours, et les rapports Eshop commencent à cette date. Le devis d’import peut tout de même proposer un historique plus long ; l’import lui-même s’arrête à 60 jours. Si vous avez besoin de l’historique complet des commandes, connectez-vous plutôt avec l’application de l’App Store.

La connecter dans AmICited#

  1. Trouver l’adresse de votre boutique

    Dans l’administration Shopify, ouvrez Settings. L’adresse de la boutique (your-store.myshopify.com) s’affiche sous le nom de la boutique, en haut du menu.

    Settings de l'administration Shopify avec l'adresse myshopify.com sous le nom de la boutique (floutée)

  2. Ouvrir la boîte de dialogue Shopify

    Allez dans Sources de données, sous Eshops cliquez sur Connect Shopify Store, puis sur Use a custom app instead (1 sur la capture ci-dessous).

  3. Saisir la boutique et les identifiants

    Saisissez la Store address, le Client ID et le Client secret (2), puis cliquez sur Connect store (3).

    Boîte de dialogue Shopify avec Use a custom app instead et les champs Store address, Client ID et Client secret

  4. Choisir le domaine et confirmer l’import

    Associez la boutique à un domaine et choisissez la profondeur d’historique des commandes à importer, comme pour une installation depuis l’App Store. Chaque option affiche son nombre de lignes estimé et son coût unique avant que vous ne confirmiez.

Ensuite, configurez les données clients et les paramètres de la boutique comme pour n’importe quelle boutique.

Ce qui change avec une application personnalisée#

Pourquoi les liens ne sont-ils pas réappliqués dès que je modifie un produit ?

Les applications personnalisées ne reçoivent pas les webhooks Shopify : modifier un produit ou une page dans Shopify ne déclenche donc pas immédiatement la réapplication des liens par le link building. Ils sont réappliqués à la prochaine exécution de la règle.

Que se passe-t-il si l’application est supprimée ou désinstallée ?

La connexion s’arrête dans un délai d’environ un jour et l’espace de travail reçoit une notification. Pour vous reconnecter, ouvrez la même boîte de dialogue, choisissez Update credentials et saisissez le Client ID et le Client secret actuels de l’application.

Pourquoi l’import ne remonte-t-il qu’à 60 jours ?

Les commandes plus anciennes nécessitent l’autorisation Shopify read_all_orders, que le Dev Dashboard n’accepte pas sur une application personnalisée. Une connexion par application personnalisée importe donc les 60 derniers jours de commandes, puis les nouvelles commandes continuent d’arriver. Pour l’historique complet, utilisez l’application de l’App Store.

Une agence peut-elle utiliser une seule application pour tous ses clients ?

Non. L’application doit appartenir à la même organisation Shopify que la boutique : chaque client crée donc sa propre application.

À lire aussi#

Boutiques en ligne La voie de l’App Store, les données clients, les paramètres de la boutique et ce que la boutique débloque. Offres et limites Les offres qui incluent les intégrations e-commerce.