Importer vos clients depuis Shopify
Connectez votre boutique Shopify : ses clients arrivent comme contacts, avec leur pays, leur nombre de commandes et leur valeur client pour regrouper les résultats — et une commande peut lancer une enquête quelques jours plus tard.
Sur cette page
Connectez votre boutique Shopify et Polzy lit ses clients selon un calendrier. Ils arrivent comme contacts : ils répondent aux enquêtes, ne se connectent jamais et n’occupent aucune place. Leur pays, leur nombre de commandes, leur valeur client et leur date d’inscription les accompagnent, pour comparer les résultats selon ces critères. Ajoutez aussi des webhooks Shopify, et une commande expédiée, payée, annulée ou remboursée peut lancer une enquête — quelques jours après la livraison, par exemple.
La synchronisation des personnes est disponible à partir de Team, et seuls les administrateurs de l’espace de travail peuvent connecter une source. Lancer des enquêtes à partir des commandes demande aussi la page Intégrations, incluse dans Business. Polzy ne fait que lire Shopify : il ne modifie jamais un client ni une commande.
Avant de commencer
Il vous faut :
- Être administrateur de l’espace de travail Polzy, sur Team ou plus, avec Synchronisation des personnes activé sous Paramètres → Général → Ce que fait cet espace de travail.
- L’adresse propre de votre boutique, qui se termine par
.myshopify.com— pas un domaine personnalisé commeshop.acme.com. - Un Admin API access token qui n’expire pas, avec les portées
read_customersetread_orders. Il commence parshpat_. - Les champs selon lesquels vous voulez regrouper les résultats dans votre espace de travail, comme Pays, Nombre de commandes et Valeur client. Un espace de travail conçu pour des clients les a généralement déjà.
Un espace de travail se synchronise depuis une seule source à la fois. Si une autre source est connectée, déconnectez-la d’abord.
Obtenir un jeton d’accès
Shopify délivre le jeton par l’intermédiaire d’une application installée sur votre boutique. Le choix de l’application compte, car Polzy conserve le jeton que vous lui donnez et ne peut pas le renouveler :
- Une application personnalisée créée dans l’administration Shopify. Son jeton n’expire jamais, et c’est ce dont Polzy a besoin. Shopify ne permet plus aux boutiques d’en créer depuis le 1er janvier 2026, mais une application existante continue de fonctionner. Dans l’administration Shopify, ouvrez Apps → Develop apps, choisissez l’application et vérifiez sous API credentials qu’elle a les portées
read_customersetread_orders. Shopify affiche le jeton une seule fois, à l’installation de l’application ; si vous ne l’avez plus, désinstaller puis réinstaller l’application en génère un nouveau. - Une application créée dans le Dev Dashboard de Shopify. C’est désormais ainsi que l’on crée les applications personnalisées. La façon rapide d’obtenir un jeton pour l’une d’elles — le client credentials grant — donne un jeton qui expire au bout de 24 heures : la synchronisation de Polzy cesserait de fonctionner le lendemain. Ne l’utilisez que si votre développeur peut obtenir un jeton hors ligne qui n’expire pas.
Voir Shopify : Custom apps et Shopify : Admin-created custom apps.
Connecter Shopify dans Polzy
- Ouvrez Contacts → Synchro et champs.
- Sous Sources disponibles, trouvez Shopify et choisissez Connecter. Un panneau s’ouvre avec trois étapes : Connexion, Paramètres de synchro et Correspondance des champs.
- Saisissez le Domaine de la boutique, comme
acme.myshopify.com, et collez l’Admin API access token. Laissez Secret de signature du webhook vide sauf si vous configurez les webhooks de commande (plus bas). - Choisissez Tester la connexion. Connected to suivi du nom de votre boutique signifie que le jeton fonctionne.
- Choisissez Suivant, vérifiez les paramètres de synchronisation (voir plus bas), puis choisissez de nouveau Suivant.
- À l’étape Correspondance des champs, gardez la correspondance par défaut ou activez Correspondance personnalisée des champs (voir plus bas), puis choisissez Connecter.
Le jeton est stocké chiffré et ne sert qu’à lire votre boutique. Polzy le vérifie de nouveau quand vous choisissez Connecter : si Shopify le refuse, rien n’est enregistré.
Paramètres de synchronisation
| Paramètre | Ce qu’il fait | Par défaut |
|---|---|---|
| Uniquement les clients ayant accepté le marketing | N’importe que les clients qui ont accepté le marketing par e-mail ou par SMS. Recommandé : interroger des clients qui ont refusé le marketing peut aller à l’encontre de leur consentement. | Désactivé |
| Nombre minimum de commandes | Ignore les clients qui ont passé moins de commandes que ce nombre. À 1, les clients qui n’ont jamais commandé sont écartés. | 1 |
Shopify se synchronise toutes les heures. Les clients sans adresse e-mail ni numéro de téléphone sont toujours ignorés.
Associer les champs
La correspondance par défaut remplit :
| Champ Polzy | Depuis Shopify |
|---|---|
| E-mail, numéro de téléphone | email, phone |
| Prénom, nom | first_name, last_name |
| Pays | default_address.country |
| Valeur client | total_spent |
| Nombre de commandes | orders_count |
| Date d’inscription | created_at |
Le pays, la valeur client, le nombre de commandes et la date d’inscription ne sont conservés que si votre espace de travail a ces champs. Pour modifier la correspondance, activez Correspondance personnalisée des champs. Chaque ligne a alors une source à renseigner — choisissez l’un des champs de Shopify, comme tags ou default_address.city, ou tapez le chemin de n’importe quel autre — et une valeur Si vide, utiliser, écrite quand Shopify n’a rien pour ce client. Une valeur que Shopify envoie n’est jamais écrasée.
Pour comparer les résultats selon un champ, faites-en un champ Liste et activez Groupes à côté de lui dans le tableau Correspondance des champs, sur Synchro et champs. Les valeurs de Shopify sont rapprochées des options du champ.
Prévisualiser et lancer la première synchronisation
- Sur Synchro et champs, choisissez Prévisualiser une synchro sous Historique de synchro. Polzy calcule ce qu’une synchronisation ajouterait et mettrait à jour, sans rien changer, et ouvre le journal où le résultat apparaît comme Aperçu.
- Vérifiez l’aperçu, puis choisissez Synchroniser maintenant. Le résultat apparaît dans Historique de synchro.
Les clients sont rapprochés par leur identifiant Shopify, puis par adresse e-mail : un contact que vous aviez déjà ajouté à la main ou par CSV est mis à jour au lieu d’être ajouté une seconde fois.
Lancer des enquêtes à partir des commandes
Shopify peut prévenir Polzy quand une commande est expédiée (orders/fulfilled), payée (orders/paid) ou annulée (orders/cancelled), et quand un remboursement est effectué (refunds/create). Une campagne réglée sur Quand un événement se produit peut alors envoyer une enquête à ce client, après le délai que vous choisissez, et un workflow peut réagir au même événement. Les produits de la commande l’accompagnent, pour comparer les réponses par produit.
- Dans Polzy, ouvrez Intégrations, puis Shopify, et copiez l’adresse sous Réception. Elle est propre à votre connexion et se termine par
/shopify. - Dans l’administration Shopify, ouvrez Settings → Notifications → Webhooks et choisissez Create webhook.
- Choisissez l’Event — par exemple l’expédition d’une commande —, choisissez JSON comme Format, collez l’adresse dans URL et enregistrez. Recommencez pour chaque événement voulu.
- Copiez la clé avec laquelle Shopify signe vos webhooks, affichée sur la page Webhooks.
- Dans Polzy, ouvrez Contacts → Synchro et champs, choisissez Paramètres, collez la clé dans Secret de signature du webhook et choisissez Enregistrer à la dernière étape.
Polzy refuse un webhook qu’il ne peut pas vérifier avec cette clé : les commandes restent sans effet tant qu’elle n’est pas enregistrée. Si c’est une application de votre boutique qui crée les webhooks, ils sont signés avec la clé secrète d’API de cette application : collez celle-là. Quand une commande arrive pour une campagne qui l’attend, son client est d’abord rapproché ou ajouté comme contact. Voir Shopify : Creating webhooks, et Campagnes pour le côté campagne.
Dépannage
| Ce que vous voyez | Pourquoi | Que faire |
|---|---|---|
| Store domain should look like your-store.myshopify.com | Vous avez saisi un domaine personnalisé ou une adresse web complète. | Saisissez uniquement le domaine .myshopify.com de votre boutique. |
| Shopify rejected the token. Check it has read_customers scope. | Le jeton est faux, a expiré ou n’a pas la portée. | Vérifiez les portées de l’application et collez un jeton qui n’expire pas. |
| Store not found. Check the .myshopify.com domain. | Aucune boutique ne répond à ce domaine. | Copiez le domaine depuis votre administration Shopify. |
| La synchronisation fonctionne un jour, puis échoue | Le jeton venait du client credentials grant et a expiré au bout de 24 heures. | Utilisez un jeton qui n’expire pas — voir Obtenir un jeton d’accès. |
| Les commandes ne lancent jamais d’enquête | Aucun Secret de signature du webhook n’est enregistré, ce n’est pas la clé avec laquelle Shopify signe, ou aucune campagne active n’attend cet événement. | Collez la clé de la page Webhooks, et vérifiez le déclencheur de la campagne. |
| N contacts n’ont pas été importés : la limite de contacts de l’offre est atteinte. | Les contacts de votre offre sont épuisés. | Augmentez Nombre minimum de commandes ou activez Uniquement les clients ayant accepté le marketing, ou changez d’offre. |
Bon à savoir
- Des contacts, pas des membres. Les clients ne se connectent jamais, ne reçoivent pas d’invitation et n’occupent aucune place. Ils comptent dans les contacts de votre offre — 10 000 sur Team, 50 000 sur Business. Une synchronisation qui dépasserait cette limite importe les clients qui tiennent, s’arrête là et prévient les administrateurs — voir Utilisation et limites.
- Jusqu’à 50 000 clients par synchronisation. Une boutique plus grande est lue jusqu’à ce nombre.
- Les clients supprimés restent. Un client supprimé dans Shopify n’est ni supprimé ni désactivé dans Polzy ; supprimez le contact sous Contacts si nécessaire.
- Déconnecter ou supprimer. Sous Paramètres, Déconnecter arrête la synchronisation et garde les paramètres et l’historique, pour reconnecter plus tard ; Supprimer efface la connexion. Dans les deux cas, les contacts déjà importés restent dans Polzy.
- Besoin d’aide ? Le lien Demander à Polzy du panneau de connexion explique où trouver chaque valeur dans Shopify.
Liens utiles
- Shopify : Custom apps — les applications personnalisées aujourd’hui, et celles créées avant 2026.
- Shopify : Admin-created custom apps — où trouver le jeton et les portées d’une application existante.
- Shopify : Creating webhooks — les webhooks de commande dans votre administration Shopify.
- Personnes et contacts — champs, groupes et contacts.
Articles liés
Les membres connectés peuvent demander à Polzy ou écrire à l’équipe depuis Support. Notre délai de réponse dépend de votre forfait.