Klanten binnenhalen uit Shopify
Koppel je Shopify-winkel en de klanten komen binnen als contacten, met hun land, aantal bestellingen en klantwaarde om op te groeperen — en een bestelling kan een paar dagen later een enquête starten.
Op deze pagina
Koppel je Shopify-winkel en Polzy leest de klanten volgens een vast schema uit. Ze komen binnen als contacten: ze beantwoorden enquêtes, melden zich nooit aan en gebruiken geen plek. Hun land, aantal bestellingen, klantwaarde en aanmelddatum komen mee, zodat je resultaten daarop kunt vergelijken. Voeg je ook Shopify-webhooks toe, dan kan een verzonden, betaalde, geannuleerde of terugbetaalde bestelling een enquête starten — bijvoorbeeld een paar dagen na de levering.
Deelnemers synchroniseren zit in Team en hoger, en alleen beheerders van de werkruimte kunnen een bron koppelen. Enquêtes starten vanuit bestellingen vraagt ook de pagina Integraties, die bij Business hoort. Polzy leest alleen uit Shopify: het wijzigt nooit een klant of een bestelling.
Voordat je begint
Je hebt nodig:
- Beheerder zijn van de Polzy-werkruimte, op Team of hoger, met Deelnemers synchroniseren ingeschakeld onder Instellingen → Algemeen → Wat deze werkruimte doet.
- Het eigen adres van je winkel dat eindigt op
.myshopify.com— niet een eigen domein zoalsshop.acme.com. - Een Admin API access token dat niet verloopt, met de scopes
read_customersenread_orders. Het begint metshpat_. - De velden waarop je resultaten wilt groeperen in je werkruimte, zoals Land, Aantal bestellingen en Klantwaarde. Een werkruimte voor klanten heeft die meestal al.
Een werkruimte synchroniseert uit één bron tegelijk. Is er al een andere bron gekoppeld, koppel die dan eerst los.
Een access token regelen
Shopify geeft het token uit via een app in je winkel. Welke app je gebruikt maakt uit, want Polzy bewaart het token dat je opgeeft en kan het niet vernieuwen:
- Een custom app die in je Shopify-beheer is gemaakt. Het token daarvan verloopt nooit, en dat is wat Polzy nodig heeft. Sinds 1 januari 2026 kunnen winkels deze apps niet meer aanmaken, maar een bestaande blijft werken. Open in je Shopify-beheer Apps → Develop apps, kies de app en controleer onder API credentials dat hij de scopes
read_customersenread_ordersheeft. Shopify toont het token één keer, bij het installeren van de app; heb je het niet meer, dan levert verwijderen en opnieuw installeren van de app een nieuw token op. - Een app die in het Dev Dashboard van Shopify is gemaakt. Zo worden nieuwe custom apps tegenwoordig gemaakt. De snelle manier om er een token voor te krijgen — de client credentials grant — levert een token op dat na 24 uur verloopt, zodat de synchronisatie van Polzy de volgende dag stopt. Gebruik dit alleen als je ontwikkelaar een offline token kan regelen dat niet verloopt.
Zie Shopify: Custom apps en Shopify: Admin-created custom apps.
Shopify koppelen in Polzy
- Open Contacten → Synchronisatie en velden.
- Zoek Shopify onder Beschikbare bronnen en kies Verbinden. Er opent een paneel met drie stappen: Verbinding, Synchronisatie-instellingen en Veldkoppeling.
- Vul je Winkeldomein in, zoals
acme.myshopify.com, en plak het Admin API access token. Laat Ondertekeningsgeheim van de webhook leeg, tenzij je webhooks voor bestellingen instelt (hieronder). - Kies Verbinding testen. Connected to gevolgd door de naam van je winkel betekent dat het token werkt.
- Kies Volgende, controleer de synchronisatie-instellingen (zie hieronder) en kies nog eens Volgende.
- Houd bij Veldkoppeling de standaardkoppeling aan of zet Aangepaste veldkoppeling aan (zie hieronder), en kies dan Verbinden.
Het token wordt versleuteld opgeslagen en alleen gebruikt om uit je winkel te lezen. Polzy controleert het opnieuw wanneer je Verbinden kiest: weigert Shopify het, dan wordt er niets opgeslagen.
Synchronisatie-instellingen
| Instelling | Wat het doet | Standaard |
|---|---|---|
| Alleen klanten die marketing hebben geaccepteerd | Importeert alleen klanten die met marketing per e-mail of sms hebben ingestemd. Aanbevolen: klanten die marketing hebben geweigerd een enquête sturen, kan tegen hun toestemming ingaan. | Uit |
| Minimum aantal bestellingen | Slaat klanten over met minder bestellingen dan dit. Bij 1 blijven klanten die nooit iets hebben besteld weg. | 1 |
Shopify synchroniseert elk uur. Klanten zonder e-mailadres én zonder telefoonnummer worden altijd overgeslagen.
De velden koppelen
De standaardkoppeling vult:
| Polzy-veld | Uit Shopify |
|---|---|
| E-mail, telefoonnummer | email, phone |
| Voornaam, achternaam | first_name, last_name |
| Land | default_address.country |
| Klantwaarde | total_spent |
| Aantal bestellingen | orders_count |
| Aanmelddatum | created_at |
Land, klantwaarde, aantal bestellingen en aanmelddatum worden alleen bewaard als je werkruimte die velden heeft. Wil je de koppeling aanpassen, zet dan Aangepaste veldkoppeling aan. Elke rij krijgt dan een bron om in te vullen — kies een van de velden van Shopify, zoals tags of default_address.city, of typ het pad van een ander veld — en een waarde bij Indien leeg, gebruik, die wordt ingevuld als Shopify voor die klant niets heeft. Een waarde die Shopify wél stuurt, wordt nooit overschreven.
Wil je resultaten op een veld vergelijken, maak er dan een Lijst-veld van en zet Groepen ernaast aan in de tabel Veldkoppeling, op Synchronisatie en velden. Waarden uit Shopify worden gekoppeld aan de opties van het veld.
Vooraf bekijken en de eerste synchronisatie uitvoeren
- Kies op Synchronisatie en velden onder Synchronisatiegeschiedenis de optie Synchronisatie vooraf bekijken. Polzy rekent uit wat een synchronisatie zou toevoegen en bijwerken, zonder iets te wijzigen, en opent het logboek waar het resultaat als Voorbeeld verschijnt.
- Bekijk het voorbeeld en kies dan Nu synchroniseren. Het resultaat verschijnt in Synchronisatiegeschiedenis.
Klanten worden herkend aan hun Shopify-ID en daarna aan hun e-mailadres. Een contact dat je al met de hand of via een CSV had toegevoegd, wordt dus bijgewerkt in plaats van dubbel toegevoegd.
Enquêtes starten vanuit bestellingen
Shopify kan Polzy laten weten wanneer een bestelling is verzonden (orders/fulfilled), betaald (orders/paid) of geannuleerd (orders/cancelled), en wanneer er wordt terugbetaald (refunds/create). Een campagne die start bij Wanneer een gebeurtenis plaatsvindt kan die klant dan een enquête sturen, na de vertraging die je kiest, en een workflow kan op dezelfde gebeurtenis reageren. De producten van de bestelling komen mee, zodat je antwoorden per product kunt vergelijken.
- Open in Polzy Integraties, dan Shopify, en kopieer het adres onder Ontvangen. Het is voor jouw koppeling gemaakt en eindigt op
/shopify. - Open in je Shopify-beheer Settings → Notifications → Webhooks en kies Create webhook.
- Kies het Event — bijvoorbeeld de verzending van een bestelling —, kies JSON als Format, plak het adres als URL en sla op. Herhaal dit voor elke gebeurtenis die je wilt.
- Kopieer de sleutel waarmee Shopify je webhooks ondertekent; die staat op de pagina Webhooks.
- Open in Polzy Contacten → Synchronisatie en velden, kies Instellingen, plak de sleutel in Ondertekeningsgeheim van de webhook en kies Opslaan bij de laatste stap.
Polzy weigert een webhook die het niet met die sleutel kan controleren, dus bestellingen doen niets tot de sleutel is opgeslagen. Maakt een app in je winkel de webhooks aan, dan zijn ze ondertekend met de API secret key van die app: plak dan die. Komt er een bestelling binnen voor een campagne die erop wacht, dan wordt de klant eerst gevonden of als contact toegevoegd. Zie Shopify: Creating webhooks, en Campagnes voor de kant van de campagne.
Problemen oplossen
| Wat je ziet | Waarom | Wat je doet |
|---|---|---|
| Store domain should look like your-store.myshopify.com | Je hebt een eigen domein of een volledig webadres ingevuld. | Vul alleen het .myshopify.com-domein van je winkel in. |
| Shopify rejected the token. Check it has read_customers scope. | Het token klopt niet, is verlopen of mist de scope. | Controleer de scopes van de app en plak een token dat niet verloopt. |
| Store not found. Check the .myshopify.com domain. | Op dat domein antwoordt geen winkel. | Kopieer het domein uit je Shopify-beheer. |
| De synchronisatie werkt een dag en mislukt dan | Het token kwam uit de client credentials grant en is na 24 uur verlopen. | Gebruik een token dat niet verloopt — zie Een access token regelen. |
| Bestellingen starten nooit een enquête | Er is geen Ondertekeningsgeheim van de webhook opgeslagen, het is niet de sleutel waarmee Shopify ondertekent, of er wacht geen actieve campagne op die gebeurtenis. | Plak de sleutel van de pagina Webhooks en controleer de trigger van de campagne. |
| N contacten zijn niet geïmporteerd: de contactenlimiet van het abonnement is bereikt. | De contacten van je abonnement zijn op. | Verhoog Minimum aantal bestellingen of zet Alleen klanten die marketing hebben geaccepteerd aan, of kies een ander abonnement. |
Goed om te weten
- Contacten, geen leden. Klanten melden zich nooit aan, krijgen geen uitnodiging en gebruiken geen plek. Ze tellen mee voor de contacten van je abonnement — 10.000 op Team, 50.000 op Business. Een synchronisatie die daarboven uitkomt, importeert de klanten die passen, stopt daar en laat het beheerders weten — zie Gebruik en limieten.
- Tot 50.000 klanten per synchronisatie. Een grotere winkel wordt tot dat aantal gelezen.
- Verwijderde klanten blijven staan. Een klant die in Shopify is verwijderd, wordt in Polzy niet verwijderd of gedeactiveerd; verwijder het contact zelf onder Contacten als dat nodig is.
- Loskoppelen of verwijderen. Onder Instellingen stopt Loskoppelen de synchronisatie en blijven de instellingen en de geschiedenis bewaard, zodat je later opnieuw kunt verbinden; Verwijderen wist de koppeling. In beide gevallen blijven de al geïmporteerde contacten in Polzy staan.
- Hulp nodig? De link Vraag het Polzy in het koppelpaneel legt uit waar je elke waarde in Shopify vindt.
Handige links
- Shopify: Custom apps — custom apps nu, en de apps van vóór 2026.
- Shopify: Admin-created custom apps — waar je het token en de scopes van een bestaande app vindt.
- Shopify: Creating webhooks — webhooks voor bestellingen in je Shopify-beheer.
- Mensen en contacten — velden, groepen en contacten.
Gerelateerde artikelen
Ingelogde leden kunnen het Polzy vragen of het team een bericht sturen via Support. Hoe snel we antwoorden, hangt af van je abonnement.