Menu de la documentation

Shopify

Connectez une boutique Shopify pour synchroniser ses clients dans une liste de contacts MailInApp, déclencher des parcours à partir d'événements réels de la boutique, et voir le revenu se rattacher à une campagne ou une variante.

Vidéo en anglais

Connectez votre boutique

Vous connectez une boutique en créant une petite application pour elle dans votre propre administration Shopify, puis en collant les deux clés de cette application dans MailInApp. Comptez environ cinq minutes. Vous n'avez besoin ni d'un compte Shopify Partner ni de code, et l'application reste privée à votre boutique.

Vous devez être le propriétaire de la boutique dans Shopify (ou un membre du personnel autorisé à développer des applications), et le propriétaire de votre compte MailInApp.

Étape 1 : ouvrez le Dev Dashboard

Dans votre administration Shopify, allez dans Paramètres → Applications et cliquez sur Develop apps en haut à droite.

La page Paramètres → Applications de l'administration Shopify, avec le bouton Develop apps mis en évidence

Sur la page de développement d'applications, cliquez sur Build apps in Dev Dashboard. La première fois, Shopify vous demande de confirmer votre adresse e-mail et de vous reconnecter, puis crée une organisation de développement au nom de votre boutique. Si la page Stores du Dev Dashboard indique « No stores yet », ce n'est pas un problème : votre boutique n'a pas besoin d'y figurer.

La page de développement d'applications, avec le bouton Build apps in Dev Dashboard mis en évidence

Étape 2 : créez l'application

Dans le Dev Dashboard, ouvrez Apps et cliquez sur Create app, puis sur Create app manually. Tout se trouve dans un seul formulaire :

  • App name : un nom que vous reconnaîtrez, par exemple MailInApp.
  • App URL : https://mailinapp.com/dashboard/settings/integrations. Shopify ouvre cette page après l'installation de l'application, vous arrivez donc sur le formulaire de connexion de MailInApp avec l'adresse de votre boutique déjà remplie.
  • Embed app in Shopify admin : décochez la case. Votre application n'a pas de page dans Shopify.
  • Scopes : read_customers,read_orders,read_products,write_discounts. Ils permettent à MailInApp de lire vos clients, commandes et produits, et de créer les codes de réduction à usage unique décrits plus bas. MailInApp ne modifie jamais vos produits, commandes ou clients. Pour atteindre les commandes de plus de 60 jours environ, ajoutez aussi read_all_orders : Shopify l'accorde automatiquement à votre propre application.
  • Webhooks API version : laissez la valeur par défaut.

Le formulaire Create an app, avec l'App URL, la case Embed app in Shopify admin décochée, les scopes et le bouton Create app mis en évidence

Cliquez sur Create app. Shopify vous demande de publier la première version : cliquez sur Release.

La boîte de dialogue Release version, avec le bouton Release mis en évidence

Étape 3 : installez l'application sur votre boutique

Sur la page Overview de l'application, cliquez sur Test app dans la carte Installs et choisissez votre boutique.

La page Overview de l'application, avec le bouton Test app mis en évidence

Shopify affiche son écran d'installation avec les accès dont l'application a besoin. Il indique aussi que l'application n'a pas été vérifiée. C'est normal, car l'application vous appartient et ne passe jamais par l'App Store. Cliquez sur Install.

L'écran Install app de Shopify, avec le bouton Install mis en évidence

Votre boutique affiche désormais l'application dans Paramètres → Applications.

Étape 4 : collez les clés dans MailInApp

De retour sur la page Overview de l'application dans le Dev Dashboard, la carte Credentials contient le Client ID et le Client secret. Le secret est masqué ; son bouton de copie le copie.

La carte Credentials de la page Overview de l'application, avec les champs Client ID et Client secret

Dans MailInApp, ouvrez Paramètres → Intégrations. Dans la carte Shopify, saisissez l'adresse de votre boutique (votre-boutique.myshopify.com), collez le Client ID et le Client secret, puis cliquez sur Connecter Shopify. MailInApp peut d'abord vous demander de vous reconnecter, car les clés donnent un accès complet aux données de votre boutique.

La carte Shopify dans Paramètres → Intégrations, avec l'adresse de la boutique remplie et le bouton Connecter Shopify mis en évidence

MailInApp vérifie les clés auprès de Shopify, chiffre le Client secret et ne l'affiche plus jamais. Il crée ensuite une liste de contacts pour la boutique et synchronise en arrière-plan vos clients (jusqu'à 5 000 lors de ce premier passage ; les suivants arrivent au fur et à mesure de leur création) et votre catalogue de produits.

Laissez l'IP allowlist désactivée dans les paramètres de votre application. Si elle est active, Shopify refuse les requêtes de MailInApp.

Connecter Shopify est gratuit sur tous les forfaits, y compris Free. Votre forfait MailInApp est facturé par MailInApp comme d'habitude, depuis Paramètres → Forfait. Tout votre catalogue produits se synchronise sur chaque forfait, et chaque forfait inclut un quota mensuel de codes de réduction boutique.

Si la connexion échoue

La carte Shopify indique ce qui n'a pas fonctionné :

  • Shopify n'a pas accepté ce Client ID et ce Client secret : copiez-les à nouveau depuis la carte Credentials. Si vous avez généré un nouveau secret, utilisez le nouveau.
  • L'application n'est pas installée sur cette boutique : refaites l'étape 3 (Test app, puis Install).
  • Il manque ces scopes d'accès à votre application : dans le Dev Dashboard, ouvrez les Versions de l'application, créez une nouvelle version avec les scopes de l'étape 2, publiez-la, puis connectez-vous de nouveau.
  • Cette application appartient à une autre organisation Shopify : créez l'application depuis l'administration de votre propre boutique, comme à l'étape 1, plutôt que depuis un autre compte Partner ou développeur.
  • Ce n'est pas une adresse de boutique Shopify : utilisez l'adresse myshopify.com affichée sous le nom de votre boutique dans Paramètres, pas votre propre domaine.

Ce que ça fait

  • Synchronisation des clients : les clients Shopify arrivent dans une liste de contacts propre à cette intégration, tenue à jour ensuite par les propres webhooks de Shopify (customers/create, plus checkouts/create et orders/paid pour les déclencheurs ci-dessous) plutôt que par une nouvelle interrogation périodique.
  • Déclencheurs de parcours : une boutique connectée peut activer le déclencheur panier abandonné d'un parcours (un paiement commencé mais non terminé) et son déclencheur achat (une commande payée), afin qu'une automatisation de série de bienvenue ou de panier abandonné puisse fonctionner à partir de l'activité réelle de Shopify plutôt qu'uniquement du paiement du bloc produit propre à MailInApp. Voir Parcours.
  • Attribution du revenu : la campagne/variante propre à une commande, lorsqu'elle est identifiable, s'intègre aux mêmes chiffres de revenu de réponse et de test A/B que produit déjà une commande passée via le paiement natif.
  • Segments d'historique d'achat et offres de réduction : les lignes de commande se synchronisent en même temps que les clients, de sorte qu'un filtre d'audience peut correspondre à « a acheté le produit X entre la date A et B » (voir Historique d'achat), et un projet peut générer un code de réduction Shopify à usage unique par destinataire correspondant, à utiliser sur le paiement de votre propre boutique (voir Offre de réduction). Les nouvelles commandes se synchronisent automatiquement via le webhook orders/paid. Pour les commandes passées avant la connexion, lancez une fois Récupérer l'historique des commandes depuis Paramètres → Intégrations ; Shopify le limite à environ les 60 derniers jours. Un bloc Produit importé depuis votre catalogue peut générer indépendamment sa propre réduction par produit, limitée à ce seul article, sans besoin de filtre d'audience : voir Réductions natives à la boutique et Codes de réduction produit Shopify.
  • Catalogue de produits pour le studio : les propres fiches actives de votre boutique se synchronisent aussi dans MailInApp, actualisées automatiquement selon la même cadence que les clients (pas de bouton séparé). Le sélecteur Importer depuis la boutique du bloc Produit recherche dans ce catalogue synchronisé et remplit le nom, la description, l'image et le prix d'un bloc à partir d'un produit réel. C'est une copie ponctuelle, pas un lien en direct, de sorte que rien dans un email envoyé ne puisse dériver de ce que vous avez vérifié. Il synchronise aussi la propre page de chaque produit (à partir de son handle Shopify) et, lorsque c'est disponible, règle le bloc sur Lien vers le paiement externe de la boutique pointant directement vers elle, de sorte qu'un produit importé est prêt à être vendu sur votre boutique Shopify sans rien de plus à configurer. Repassez-le manuellement sur Paiement MailInApp si vous préférez encaisser le paiement via votre compte Stripe connecté.

Avis de la boutique

Shopify ne conserve aucun avis lui-même : MailInApp les lit donc dans Judge.me, l'application d'avis de votre boutique.

  1. Dans Judge.me, ouvrez Settings → Integrations et cliquez sur View API token. Copiez le jeton privé.
  2. Dans MailInApp, ouvrez Paramètres → Intégrations. Sur la carte de votre boutique, sous Judge.me, collez le jeton et cliquez sur Connecter Judge.me.

MailInApp vérifie le jeton auprès de Judge.me, puis synchronise vos avis, et de nouveau à chaque synchronisation de la boutique. Il ne garde que les avis publiés sur votre boutique (ni masqués ni en attente d'approbation dans Judge.me), au plus les 5 000 plus récents. Un avis que vous masquez ou supprimez dans Judge.me disparaît à la synchronisation suivante. MailInApp ne conserve jamais l'adresse e-mail d'un auteur et affiche son nom sous la forme prénom et initiale du nom. La carte indique combien d'avis sont synchronisés, et Synchroniser les avis les synchronise tout de suite.

Le jeton sert uniquement à lire les avis. Déconnecter Judge.me supprime le jeton et les avis synchronisés, tout comme la déconnexion de la boutique. Les notes en étoiles des produits importés n'ont pas besoin du jeton : elles viennent de la note que Judge.me enregistre déjà sur chaque produit dans Shopify. Voir Avis de la boutique pour les étoiles, les avis dans les e-mails et la publication.

État de la connexion et mise à jour des clés

MailInApp échange les clés de votre application contre un jeton d'accès Shopify de courte durée (valable environ un jour) et en obtient un nouveau de lui-même avant son expiration. En usage normal, vous n'avez rien à faire.

Si les clés ne fonctionnent plus, MailInApp arrête la synchronisation, et la carte Shopify dans Paramètres → Intégrations affiche Action requise et indique pourquoi :

  • Les clés de votre application Shopify ne fonctionnent plus : le secret a été révoqué, ou l'application a été supprimée. Cliquez sur Mettre à jour les clés et collez le Client ID et le Client secret actuels de l'application.
  • Votre application Shopify n'est plus installée sur la boutique : l'application a été désinstallée de votre boutique. Réinstallez-la depuis sa page Overview (Test app). Les clés restent les mêmes, donc MailInApp se reconnecte de lui-même sous 6 heures et configure de nouveau ses webhooks. Pour la reconnecter tout de suite, cliquez sur Mettre à jour les clés et collez-les.

Pour changer le Client secret (par exemple par habitude de sécurité), procédez par étapes afin que la boutique ne soit jamais déconnectée :

  1. Dans le Dev Dashboard, ouvrez les Settings de l'application et cliquez sur Generate new secret. Les deux secrets fonctionnent jusqu'à ce que vous révoquiez l'ancien.
  2. Dans MailInApp, cliquez sur Mettre à jour les clés dans la carte Shopify et collez le nouveau secret.
  3. De retour dans le Dev Dashboard, révoquez l'ancien secret.

Shopify continue de signer ses webhooks avec l'ancien secret jusqu'à ce que vous le révoquiez, et MailInApp accepte l'un ou l'autre entre-temps, aussi longtemps qu'il le faut. Mettre à jour les clés permet aussi de passer une boutique sur une autre de vos applications : collez le Client ID et le secret de cette application.

Déconnexion

Déconnecter dans Paramètres → Intégrations arrête immédiatement la synchronisation et tout traitement ultérieur des webhooks. MailInApp retire ses webhooks de votre application et supprime les clés enregistrées. Vous pouvez ensuite désinstaller l'application de votre boutique, ou la supprimer dans le Dev Dashboard.

Désinstaller l'application sans la déconnecter d'abord ne fait que mettre la boutique en pause : la carte indique que l'application n'est pas installée, et une réinstallation reprend là où elle s'était arrêtée. Si l'application reste désinstallée pendant 30 jours, MailInApp supprime les clés enregistrées et déconnecte la boutique. Pour reconnecter une boutique déconnectée, remplissez le formulaire de la carte Shopify. Il commence par l'adresse de la boutique, et la boutique conserve sa liste de contacts.

Les codes de réduction que MailInApp a déjà créés sur votre boutique (ils commencent par MIA-) restent dans Shopify quand vous désinstallez l'application ou la déconnectez, et fonctionnent jusqu'à leur expiration : les codes des e-mails déjà envoyés restent valables. L'écran de désinstallation de Shopify indique que les réductions de l'application seront supprimées ; il s'agit des réductions qu'une application exécute elle-même, et MailInApp n'en crée pas. Pour arrêter les codes plus tôt, supprimez-les dans l'administration Shopify, sous Discounts.

Les clients déjà synchronisés restent dans leur liste de contacts : déconnecter une intégration ne supprime jamais les contacts, car ils peuvent déjà servir d'audience d'envoi pour d'autres projets. Supprimez la liste vous-même si vous n'en avez plus besoin.

MailInApp conserve les clients de votre boutique pour votre compte. Votre propre application ne transmet pas à MailInApp les demandes de suppression de données clients de Shopify. Quand un client vous demande de supprimer ses données, effacez-le donc aussi dans MailInApp, depuis son profil de contact (voir Exporter ou effacer les données d’un Destinataire). Il en va de même pour une désinstallation : l'écran de désinstallation de Shopify indique que le développeur de l'application sera invité à supprimer les données clients sous 48 heures. Pour votre propre application, ce développeur, c'est vous, et Shopify ne transmet pas cette demande à MailInApp. Supprimez donc vous-même la liste de contacts de la boutique si vous voulez qu'elle disparaisse.