Shopify events: {$event.customer} / {$event.webhook.customer}

In opvolgacties die gekoppeld zijn aan bestelling-gerelateerde events, is er klantinformatie beschikbaar via de variabele {$event.customer} of {$event.webhook.customer}. Deze variabelen verwijzen naar de klant die de bestelling heeft geplaatst.

Voorbeelden van events waarbij klantgegevens beschikbaar zijn:

Variabelen

Bij Shopify-events zijn variabelen op twee manieren beschikbaar:

  • Webhook-data via {$event.webhook}: deze informatie komt rechtstreeks uit de webhook die Shopify naar Copernica stuurt.
  • API-data via {$event}: deze informatie wordt opgehaald via de Shopify GraphQL Admin API.

Wij adviseren om zoveel mogelijk gebruik te maken van de webhook-data. Hiermee voorkom je extra API-calls, bouw je e-mails sneller op en loop je minder snel tegen de rate limits van Shopify aan.

Klantinformatie via webhook-data

Webhook-events bevatten een customer-object met veelgebruikte velden zoals:

  • {$event.webhook.customer.first_name}: de voornaam van de klant
  • {$event.webhook.customer.last_name}: de achternaam van de klant
  • {$event.webhook.customer.email}: het e-mailadres
  • {$event.webhook.customer.id}: het Shopify ID van de klant

Voor een compleet en actueel overzicht van de beschikbare variabelen kun je het beste de Shopify-webhook documentatie raadplegen.

Voorbeeld:

Beste {$event.webhook.customer.first_name},
Bedankt voor je bestelling! We houden je op de hoogte via {$event.webhook.customer.email}.

Klantinformatie via API-data

Bij gebruik van {$event.customer} krijg je toegang tot klantgegevens vanuit de Shopify Admin API. Enkele handige velden:

  • {$event.customer.firstName}: de voornaam van de klant
  • {$event.customer.lastName}: de achternaam van de klant
  • {$event.customer.defaultEmailAddress.emailAddress}: het e-mailadres
  • {$event.customer.id}: het Shopify ID van de klant

Voorbeeld:

Beste {$event.customer.firstName},
Bedankt voor je bestelling! We houden je op de hoogte via {$event.customer.defaultEmailAddress.emailAddress}.