Er dient een eigen app met custom distribution te worden aangemaakt. Onderstaande volgorde is niet vrij: zonder distributiemethode kun je geen klantgegevens aanvragen, en zonder die aanvraag weigert Shopify elke call op contacten.
In het Shopify-dashboard
-
Maak een app aan en zet de distributie op custom distribution, gekoppeld aan het
myshopify.com-domein van de klant.Niet public: die wordt beoordeeld, en nieuwe public apps moeten uitsluitend GraphQL gebruiken. De addon draait op REST. -
Zet de scopes die de addon nodig heeft (zie hieronder).Een webhook vereist de scope van zijn eigen onderwerp; zonder
read_ordersmislukt alleen de orders-webhook. - Vraag protected customer data aan en vink de velden aan die de addon leest: e-mailadres, naam, telefoon en adres.Voor een custom app is dit een formaliteit zonder beoordeling, maar het móét ingevuld zijn — ook op een development store. Sla je dit over, dan faalt élke call op klantgegevens.
- Voeg de redirect-URL toe, exact zoals hij wordt weergegeven onder Mailinglijsten >> Shopify Account Instellingen. Wildcards bestaan niet. Eén letter verschil en de merchant krijgt een Shopify-foutpagina.
- Noteer client ID en client secret.
Over te nemen waarden
write_-scope bevat de bijbehorende read_, dus die voldoet ook.Beschermde velden: email, name, phone, address
Alleen level 1 is niet genoeg: dan komen contacten zonder e-mailadres binnen.
In MailCamp
- Vul client ID en secret in op het koppelscherm van de klant en sla op. Navigeer naar Mailinglijsten >> Shopify Account Instellingen.
- Genereer de install link in het Shopify-dashboard en stuur hem naar de klant. Zeven dagen geldig. Stuur hem pas als de klant klaarzit, anders genereer je hem opnieuw.
- Klikt de link en keurt goed, en komt op een pagina die zegt terug te gaan naar MailCamp. Daar wordt bewust nog niets gekoppeld: dat gebeurt in de volgende stap, met een controle die alleen klopt als MailCamp de flow zelf start.
- Klik Koppel met Shopify. Meestal geen tweede goedkeuringsscherm, want de app staat er al.
- Richt de webhooks in via Webhooks, of klik Webhooks overzetten als de klant van de oude methode komt. Abonnementen horen bij de app die ze aanmaakte, dus na een overstap moeten ze opnieuw geregistreerd worden.
Troubleshooting
| Wat je ziet | Wat er ontbreekt |
|---|---|
| not approved to access REST endpoints with protected customer data | Stap 1 of 3: geen distributiemethode gezet, of de velden niet aangevinkt. |
| Shopify-foutpagina bij het koppelen | Stap 4: de redirect-URL staat niet, of niet exact zo, in de app. |
| Contacten komen binnen zonder e-mailadres | Stap 3: alleen level 1 toegekend. |
| “Er zijn geen actieve webhook-koppelingen gevonden” | Je staat op het scherm van de verkeerde gebruiker, of de koppeling staat uit. |
| Klantwijzigingen komen niet binnen | Webhooks nog onder de oude app; overzetten of opnieuw inrichten. |
| Install link doet niets meer | Ouder dan zeven dagen; genereer een nieuwe. |
Vragen? Neem gerust contact op en stuur een mailtje naar support@mailcamp.nl.
Volg de onderstaande stappen;
- Login in het Shopify account.
- Selecteer de betreffende winkel waarmee je wilt koppelen.
- Klik links onderin je scherm op 'Instellingen'.
- Klik in het menu aan de linkerkant op 'Apps en verkoopkanalen'.
- Klik rechtsboven op 'Apps ontwikkelen'.
- Klik op de button 'Een app aanmaken'.
- Kies een App-naam (bijvoorbeeld 'MailCamp') en klik op de button 'App maken'.
- Klik op de button 'Beheerders-API-scopes configureren' en vink de volgende scopes aan; write_customers, read_customers en read_orders onder Klanten en Bestellingen en klik op de button 'Opslaan'.
- Klik vervolgens onder de tab 'API-inloggegevens' op de button 'App installeren' en klik in de popup op de button 'Installeren'.
- Klik vervolgens op het tekstje 'Token één keer onthullen' en sla de token ergens op in een bestandje.
- Zet de 'API-sleutel' en de 'Geheime API-sleutel' eveneens in dit bestandje.
- Stuur deze API tokens inclusief de URL van de webshop naar onze support-afdeling zodat wij MailCamp kunnen koppelen aan jullie Shopify webshop.
Vragen of opmerkingen? Neem aub contact op!
Opmerkingen
0 opmerkingen
U moet u aanmelden om een opmerking te plaatsen.