Meldingen bij inwisselen¶

Een klant die betaalt met een cadeaubon weet vaak niet hoeveel er nog op staat. Meldingen bij inwisselen dichten dat gat: elke keer dat een kaart wordt gebruikt, krijgt de kaarthouder een e-mail, een sms of beide, met de datum, het afgeschreven bedrag, het resterende saldo en — bij aankopen in de winkel — de vestiging waar het gebeurde.

Dit is wat een bank doet na een kaartbetaling, en klanten verwachten hetzelfde van een cadeaubon. Het vermindert ook het aantal vragen als "hoeveel staat er nog op mijn kaart?", en het bericht dat het saldo op is, is een natuurlijk moment om iemand terug te laten komen.

De persoon die de cadeaubon als cadeau heeft gekocht, kan ook op de hoogte worden gebracht: zie Wie wordt op de hoogte gebracht.

Vanaf de startpagina open je de kaart Customer notifications en klik je op Configure notifications. Open daarna het tabblad Redemption notifications. (De andere tabbladen van de pagina zijn Unused balance reminders en Loyalty emails.)

Het tabblad bevat het beleid: of meldingen aan staan, wanneer ze worden verstuurd, wie ze krijgt, via welke kanalen en via welke route. Elk bericht bewerk je op een eigen pagina, met daarbij een voorbeeld en een testverzending, en ook het afleverlogboek heeft een eigen pagina.

Instellingen meldingen bij inwisselen

Meldingen aanzetten¶

Meldingen staan uit totdat je bovenaan het tabblad op Enable klikt. De schakelaar geldt per winkel. Klik op Save in de opslagbalk om hem toe te passen.

Met het aanzetten abonneert Gift Card Hero zich op de betalingsgebeurtenissen van je winkel, zodat het een inwisseling meteen hoort, zowel aan de kassa als online. Met het uitzetten word je weer uitgeschreven; er wordt dan niets verstuurd en niets vastgelegd.

Wanneer versturen¶

Onder When to notify staan twee triggers. Beide staan standaard aan, en je kunt er een of beide gebruiken:

On every redemption — een bericht na elke inwisseling, ongeacht het saldo. Eén bericht per cadeaubon die op een bestelling is gebruikt: wie met twee kaarten betaalt, krijgt er twee.
When the balance reaches zero — een bericht "je cadeaubon is nu volledig opgebruikt", ook als de eerste optie uit staat.

Staan beide aan, dan krijgt een inwisseling die de kaart leegmaakt één bericht per kanaal, niet twee: de tekst bij een leeg saldo vervangt de gewone tekst.

Staat alleen de tweede optie aan, dan horen klanten van je één keer, aan het eind. Dat past bij winkels waar kaarten vaak worden besteed in veel kleine aankopen, en waar een bericht bij elke koffie ruis zou zijn.

Je kunt de instellingen niet opslaan met de functie aan en geen van beide triggers geselecteerd: dan zou je je abonneren op de gebeurtenissen en elke gebeurtenis meteen weggooien.

Vestiging opnemen¶

Include the store location (standaard aan) voegt de vestiging toe aan het bericht.

De locatie is de Shopify POS-locatie waar de verkoop plaatsvond, of de vestiging die je kassa-app meldt wanneer die kaarten inwisselt via de REST API. Bij online bestellingen ontbreekt de locatie. Als er geen locatie is, wordt de regel uit het bericht weggelaten in plaats van leeg getoond. Winkels die alleen online verkopen hoeven hier dus niets in te stellen.

Voor retailers met meerdere vestigingen is dit meestal de nuttigste regel in de e-mail: die vertelt de kaarthouder waar het geld naartoe ging, wat een onverwachte afschrijving herkenbaar maakt.

Wie wordt op de hoogte gebracht¶

Standaard wordt alleen de kaarthouder op de hoogte gebracht. Who gets notified heeft een eigen sectie op het tabblad, waarmee je dat kunt wijzigen:

Card holder (de standaard) — de persoon aan wie de kaart hoort. Een winkel die de instelling nooit aanraakt, werkt precies zoals voorheen.
Purchaser — de klant die de kaart heeft gekocht, in plaats van de kaarthouder.
Both — de kaarthouder en de koper krijgen elk een eigen bericht.

Dit is bedoeld voor de klant die een cadeaubon geeft en wil weten of hij is gebruikt. Bij Purchaser of Both horen ze over elke besteding, ook een gedeeltelijke, met het gebruikte bedrag en het resterende saldo.

De koper volgt dezelfde regels als de kaarthouder: de triggers onder Wanneer versturen en de kanalen onder Kanalen. Om over elke besteding te horen, laat je On every redemption aan staan. Staat alleen When the balance reaches zero aan, dan hoort de koper één keer, aan het eind.

De keuze geldt vanaf de volgende inwisseling nadat je op Save hebt geklikt. Een inwisseling die al wordt verstuurd, houdt de keuze waarmee ze begon.

De ingebouwde e-mail en sms zijn aan de kaarthouder gericht

De ingebouwde e-mail spreekt de kaarthouder aan: "Your gift card ending in 4242 was just used", en "You can use the remaining balance on your next order". De ingebouwde sms is korter, maar zegt niets over wie de kaart heeft besteed. Een koper kan dus niet zien dat het bericht over het cadeau gaat dat hij heeft gegeven.

Gift Card Hero past de ingebouwde tekst niet aan wanneer je Purchaser of Both kiest. Bewerk eerst de e-mail en de sms, zoals getoond in De melding voor de koper formuleren, en sla daarna de instelling op. Als de e-mail via Klaviyo loopt, heeft de Flow in plaats daarvan een vertakking voor de koper nodig. Zie Klaviyo.

Wie geldt als kaarthouder¶

De persoon aan wie de kaart is verstuurd. Is die er niet, dan de klant aan wie de kaart is toegewezen, daarna de eigen gegevens van Gift Card Hero over de kaart, en als laatste de klant op de bestelling waarmee de kaart is betaald. Hoe de kaarthouder wordt gevonden geeft de volledige volgorde.

Wie geldt als koper¶

De klant op de bestelling waarop de kaart is gekocht. Dat werkt voor beide soorten kaarten:

Een Shopify-cadeaubonproduct — de bestelling wordt uit de kaart gelezen.
Een kaart die Gift Card Hero zelf uitgeeft, bijvoorbeeld wanneer je cadeaubonnen verkoopt via gewone producten. De bestelling komt dan uit het afleverschema van Gift Card Hero.

Het e-mailadres en telefoonnummer van de koper zijn die van de klant, of die van de bestelling wanneer de klant er geen heeft. Het adres waarnaar een cadeau is gestuurd, hoort bij de kaarthouder en nooit bij de koper.

Gift Card Hero leest de contactgegevens van de koper alleen uit Shopify zolang Purchaser of Both is geselecteerd. Een inwisseling die is vastgelegd terwijl Card holder was geselecteerd, bevat die gegevens niet. Als je daarna wisselt, wordt de koper opgezocht op het moment dat het bericht wordt verstuurd, via de bestelling waarmee de kaart is gekocht, wanneer Gift Card Hero die kent. Lukt dat niet, dan is er geen koper, zoals beschreven onder Wanneer er geen koper is.

Wanneer er geen koper is¶

Sommige kaarten hebben er geen: een kaart die handmatig in de Shopify-admin is uitgegeven, een kaart die aan de kassa zonder klant is verkocht, of een geïmporteerde kaart.

Bij Purchaser gaat het bericht in plaats daarvan naar de kaarthouder.
Bij Both wordt alleen het bericht aan de kaarthouder verstuurd.

In beide gevallen vermeldt het afleverlogboek dat op de regel van de koper.

Dezelfde terugvaloptie geldt per kanaal. Een koper met een e-mailadres maar zonder telefoonnummer krijgt de e-mail, en bij Purchaser gaat de sms naar de kaarthouder.

Met Both¶

Elke inwisseling stuurt per kanaal twee afzonderlijke berichten: één naar de kaarthouder en één naar de koper. Elk wordt opgemaakt uit je sjabloon met de bijbehorende audience (zie hieronder). Met sms aan zijn dat twee sms'jes, en je gateway rekent elk ervan af.

Hebben de kaarthouder en de koper hetzelfde e-mailadres, of bij sms'jes hetzelfde telefoonnummer, dan wordt er maar één bericht verstuurd en het log vermeldt waarom.

Sms'jes¶

Sms'jes volgen dezelfde regel als e-mail. Bij Purchaser gaat de sms naar het telefoonnummer van de koper, en naar dat van de kaarthouder als de koper er geen heeft. Bij Both krijgt elk een eigen sms.

E-mail en sms worden apart bepaald. De e-mail kan dus de koper bereiken, terwijl de sms terugvalt op de kaarthouder.

De melding voor de koper formuleren¶

Drie variabelen onderscheiden het ene bericht van het andere:

{{ audience }} — aan wie dit bericht is gericht: purchaser of holder. Een bericht dat terugviel op de kaarthouder, omdat de kaart geen koper heeft, is holder.
{{ holder.first_name }}, {{ holder.last_name }} en {{ holder.email }} — de kaarthouder, voor zover Gift Card Hero die kent. Ze worden bij elk bericht ingevuld, ook bij dat van de kaarthouder zelf, en zijn leeg als ze niet bekend zijn. Geef ze daarom een terugvalwaarde met default.
{{ customer.first_name }} en de andere customer-variabelen — de persoon aan wie het bericht is gericht. Bij een bericht aan de koper is dat de koper.

Vertak op audience in het onderwerp, de e-mailtekst en de sms. Wat je in het {% else %}-deel zet, leest de kaarthouder, ook bij Purchaser, wanneer een kaart zonder koper terugvalt op de kaarthouder. Bewaar je tekst voor de kaarthouder dus daar.

Het onderwerp:

{% if audience == 'purchaser' %}Your gift was used{% else %}Your gift card was used{% endif %}

De e-mailtekst. Een fragment volstaat:

{% if audience == 'purchaser' %}
  <p>Hi {{ customer.first_name | default: 'there' }},</p>
  <p>
    {{ holder.first_name | default: 'Your recipient' }} used {{ amount }} from the gift card you gave
    (ending {{ card_last4 }}){% if branch %} at {{ branch }}{% endif %}.
    {% if depleted %}The card is now fully used.{% else %}Balance left: {{ balance }}.{% endif %}
  </p>
{% else %}
  <p>Hi {{ customer.first_name | default: 'there' }},</p>
  <p>
    Your gift card ending in {{ card_last4 }} was just used for {{ amount }}{% if branch %} at {{ branch }}{% endif %}.
    {% if depleted %}There is no balance left on it.{% else %}You have {{ balance }} left.{% endif %}
  </p>
{% endif %}
<p>{{ shop.name }}</p>

De sms:

{{ shop.name }}: {% if audience == 'purchaser' %}{{ holder.first_name | default: 'Your recipient' }} used {{ amount }} from the gift card you gave (*{{ card_last4 }}){% if branch %} at {{ branch }}{% endif %}.{% else %}{{ amount }} used from gift card *{{ card_last4 }}{% if branch %} at {{ branch }}{% endif %}.{% endif %} {% if depleted %}The card is now fully used.{% else %}Balance left: {{ balance }}.{% endif %}

Gerenderd ziet de sms er voor de koper zo uit:

Artcaffe: Wanjiru used KSh 1,500.00 from the gift card you gave (*4242) at Westlands. Balance left: KSh 3,500.00.

Dat is ongeveer 110 tot 120 tekens bij gebruikelijke waarden, dus het past in één segment van 160 tekens. Een voornaam of vestiging met een teken buiten de basis-Latijnse letters, zoals "Zoë", zet het hele bericht om naar de limiet van 70 tekens. Zie Het sms-sjabloon. De voorvertoning in de editor toont de kosten van je eigen tekst terwijl je typt.

Klaviyo¶

Wanneer de e-mail via Klaviyo loopt, wordt je sjabloon niet gebruikt en valt er in Gift Card Hero dus niets te formuleren. Het event Gift Card Redeemed bevat audience (holder of purchaser) en de voornaam, achternaam en het e-mailadres van de kaarthouder als holder_first_name, holder_last_name en holder_email, wanneer die bekend zijn. Het event wordt gekoppeld aan het profiel van de persoon aan wie het bericht is gericht. Bij het bericht aan de koper is dat dus de koper.

Een Flow kan filteren op audience: gebruik een triggerfilter of een voorwaardelijke splitsing in de Flow om de koper een eigen tekst te sturen. Een Flow zonder voorwaarde op audience draait bij elk event. Zodra de koper is verwittigd, zou hij dus de e-mail van de kaarthouder krijgen.

Bij Both stuurt Gift Card Hero per inwisseling twee events, één voor elke persoon. De volledige lijst met properties staat in Integraties.

Kanalen¶

Kies onder Channels de kanalen waarop de melding wordt verstuurd: Email, SMS, of beide. E-mail staat standaard aan. Elk kanaal wordt afzonderlijk verstuurd: een kaart met een e-mailadres maar zonder telefoonnummer krijgt nog steeds de e-mail, en een sms die de gateway weigert, houdt de e-mail niet tegen.

SMS kun je aanzetten zodra een sms-provider is verbonden onder Settings → Integrations. Zie Integraties. De rij noemt de provider en de afzender-ID waarmee de sms'jes binnenkomen. Sms'jes gaan via je eigen gatewayaccount en worden per bericht door de gateway aan jou gefactureerd. De sms-editor toont wat elk bericht kost.

Je kunt de instellingen niet opslaan met de functie aan en geen enkel kanaal aangevinkt.

Verzendmethode¶

Kies onder Email de route waarlangs die loopt:

Gift Card Hero email — de standaard. Wij renderen het e-mailsjabloon en versturen het vanaf onze mailserver. Er valt niets in te stellen, maar de e-mail komt niet van je eigen domein.
Your mail server (SMTP) — dezelfde e-mail, verstuurd via je eigen mailserver, zodat hij van je eigen domein komt. Te kiezen zodra je een server toevoegt onder Settings → Integrations.
Klaviyo — in plaats van zelf iets te versturen, stuurt Gift Card Hero een event Gift Card Redeemed naar Klaviyo, en een Flow die jij daar bouwt, verstuurt de e-mail. Het e-mailsjabloon wordt in deze modus niet gebruikt, en tot die Flow bestaat, ontvangen je klanten niets. Zodra Klaviyo is gekozen, verschijnt eronder een link Send a test event. Die opent een klein formulier dat een voorbeeld-event met alle properties invult, zodat je de Flow ertegen kunt bouwen. Zie Integraties.

Elke melding kiest zijn eigen route. Herinneringen en inwisselmails kunnen via verschillende routes gaan. Settings → Integrations bevat alleen de inloggegevens. Zie Integraties voor de instelling.

Als de gekozen verzendmethode op het moment van versturen niet bruikbaar is, omdat Klaviyo is losgekoppeld of de instellingen van de mailserver onvolledig zijn, dan wordt de e-mail verstuurd via Gift Card Hero email.

De sms heeft geen verzendmethode om uit te kiezen: die gaat altijd via de provider die in Integraties is verbonden.

Berichten¶

De sectie Messages toont elk bericht op één regel: het onderwerp van de e-mail, de sms zoals de klant die leest, of elk daarvan de ingebouwde versie is of die van jou, en hoe het wordt verstuurd (of waarom niet: het kanaal staat uit, Klaviyo verstuurt het, of er is geen gateway verbonden). Edit template op elke rij opent de editor.

Elke editor toont onder zijn titel via welk kanaal het bericht vertrekt, met een link Change naar de plek waar dat wordt gekozen. Rechts staan de variabelen en wordt vermeld of je de ingebouwde melding gebruikt of je eigen. Reset to built-in zet die van ons terug.

Het e-mailsjabloon¶

Laat je het sjabloon op de ingebouwde versie staan, dan krijgen klanten die van ons. Die dekt al zowel de gewone tekst als de tekst bij een leeg saldo. Hij is geschreven voor de kaarthouder: verstuur je ook een bericht aan de koper, zie Wie wordt op de hoogte gebracht. Bewerk je hem, dan wordt het jouwe gebruikt, en vanaf dat moment in plaats van eventuele verbeteringen die we aan de ingebouwde versie doen. Een veld dat je leegmaakt, wordt gelezen als "gebruik de ingebouwde versie".

Beschikbare variabelen:

Variabele	Wat het bevat
`{{ amount }}`	Bedrag dat van de kaart is afgeschreven, in de valutanotatie van je winkel
`{{ balance }}`	Saldo dat overblijft na deze inwisseling
`{{ date }}`	Wanneer de inwisseling plaatsvond
`{{ branch }}`	Vestiging van de winkel, leeg bij online bestellingen
`{{ card_last4 }}`	De laatste vier tekens van de cadeaubon-code
`{{ order_name }}`	De bestelling waarmee de kaart is betaald, bijvoorbeeld `#1001`
`{{ depleted }}`	Waar wanneer deze inwisseling de kaart heeft leeggemaakt
`{{ customer.first_name }}`	Voornaam van de persoon aan wie het bericht is gericht, indien bekend: de kaarthouder, of bij een bericht aan de koper de koper
`{{ audience }}`	Aan wie het bericht is gericht: `holder` of `purchaser`
`{{ holder.first_name }}`	De voornaam van de kaarthouder, indien bekend. Wordt bij elk bericht ingevuld, ook bij berichten aan de koper
`{{ holder.last_name }}`	De achternaam van de kaarthouder, indien bekend
`{{ holder.email }}`	Het e-mailadres van de kaarthouder, indien bekend
`{{ shop.name }}`	De naam van je winkel

{{ customer.last_name }}, {{ customer.email }} en {{ customer.phone }} worden ook ingevuld als ze bekend zijn, en beschrijven dezelfde persoon als customer.first_name. De melding voor de koper formuleren laat zien hoe je audience en de holder-variabelen gebruikt. De tekst kan een volledig HTML-document zijn of alleen een fragment. Sjablonen kunnen alleen deze variabelen gebruiken en de basisgegevens van de winkel (shop.name, shop.email, shop.domain, shop.currency). De tags {% include %} en {% render %} zijn niet beschikbaar.

Wikkel alles wat afwezig kan zijn zo in, dat de e-mail hoe dan ook goed leest:

{% if branch %}Used at {{ branch }}.{% endif %}

{% if depleted %}
  Your card is now fully used.
{% else %}
  You have {{ balance }} left.
{% endif %}

Bewerkingsscherm inwisselingsmail

Preview toont het sjabloon met voorbeeldbedragen, precies zoals de klant het ziet. Send test email opent een klein formulier met het adres waarnaar je verstuurt, vooraf ingevuld met het contactadres van je winkel. De test gaat via dezelfde route als de echte melding, dus hij bewijst ook dat je SMTP-instellingen werken. Het onderwerp krijgt [Test]. Je kunt per winkel maximaal 20 testberichten per uur versturen, over alle editors heen.

Het sms-sjabloon¶

De editor ("Redemption SMS") noemt {{ amount }}, {{ balance }}, {{ date }}, {{ branch }}, {{ card_last4 }}, {{ depleted }} en {{ shop.name }}. De andere variabelen van de e-mail, zoals {{ order_name }}, {{ customer.first_name }}, {{ audience }} en {{ holder.first_name }}, werken ook. Dezelfde regel geldt als bij de e-mail: laat je de ingebouwde tekst staan, dan krijg je die van ons; bewerk je hem, dan wordt de jouwe gebruikt. Een sms mag vóór het renderen maximaal 2.000 tekens lang zijn.

De ingebouwde tekst is één bericht lang en luidt bij een gewone inwisseling:

Artcaffe: KSh 1,500.00 used from gift card *4242 at Westlands. Balance left: KSh 3,500.00.

en wanneer de kaart is leeggemaakt:

Artcaffe: KSh 1,500.00 used from gift card *4242 at Westlands. The card is now fully used.

Onder de editor toont de voorvertoning het bericht zoals de klant het leest, zowel de gewone als de tekst bij een leeg saldo, en hoeveel elk bericht kost. Dat wordt bijgewerkt terwijl je typt. Een sms wordt per segment gefactureerd: 160 tekens voor gewone tekst, en 70 zodra er een teken buiten de basis-Latijnse letters in staat (een emoji, een krul-aanhalingsteken, sommige geaccentueerde letters). Een kleine wijziging kan de kosten van elk bericht dus verdubbelen. Een langere tekst wordt opgesplitst in segmenten van 153 tekens (67 bij zulke tekens). De teller wordt berekend op de gerenderde tekst, niet op het sjabloon, dus de tags zelf tellen niet mee.

Send test SMS (uitgeschakeld tot een sms-provider is verbonden) opent een klein formulier voor het nummer waarnaar je verstuurt. De test wordt gerenderd met voorbeeldbedragen en via je gateway verstuurd. Zo bewijs je ook dat de gateway levert, en zie je het bericht op een echte telefoon. Een lokaal nummer wordt gelezen als een nummer in het land van de gateway. Er wordt één echt bericht verstuurd en gefactureerd.

Afleverlog¶

De sectie Delivery log op het tabblad vat de laatste zeven dagen samen: hoeveel inwisselingen zijn verstuurd, mislukt of niet verstuurd, en hij noemt de meest recente. View delivery log opent het volledige log op een eigen pagina.

Het log toont elke inwisseling die is opgepakt en wat er met elk bericht is gebeurd. De kolommen zijn Date, Gift card, Redeemed, Balance left, Branch en één kolom voor elk van Email en SMS: naar wie het ging en hoe het afliep. Een inwisseling via de REST API toont "REST API" en de referentie onder de vestiging. Zoek op de laatste tekens van de kaart, een e-mailadres, een telefoonnummer of een bestelnaam. Filter op status, kanaal en periode (de laatste 7, 30 of 90 dagen, of alles). Klik op een kaart om die in Shopify te openen.

Afleverlog

Statussen, per kanaal:

Sending — het bericht wordt nog verstuurd.
Sent — het bericht is verstuurd.
Failed — het versturen is geweigerd. Beweeg over het label voor de reden. Een verkeerd SMTP-wachtwoord, een geweigerd adres en een niet-geregistreerde sms-afzender-ID verschijnen hier allemaal. Een mislukt kanaal wordt zelf een paar keer opnieuw geprobeerd; het andere kanaal wordt niet opnieuw verstuurd.
Not sent — de inwisseling is vastgelegd, maar dit kanaal is bewust niet verstuurd, met de reden ernaast. Meestal gaat het om "no email address (or phone number) is known for this gift card", of om een kaart met nog saldo in een winkel die alleen meldingen bij een leeg saldo verstuurt.

Een kanaal dat niet is aangevinkt, toont een streepje.

Onder het adres of nummer vermeldt het log waar het vandaan kwam: "sent to, per the gift card", "assigned to, per the gift card", "from the gift card record", "from the delivery schedule", "from the order customer" of, wanneer het bericht naar de koper ging, "purchaser". Zo zie je het verschil tussen "er is niets verstuurd" en "het ging naar de verkeerde persoon". Een kaart waarvan de ontvanger nooit is vastgelegd, valt terug op de klant op de bestelling waarmee hij is betaald, en deze regel laat je dat zien.

Regels voor de koper¶

Heeft de koper een eigen bericht, of is het overgeslagen, dan verschijnt onder het kanaal een tweede regel met het label Purchaser. Die toont het e-mailadres of nummer van de koper (een streepje als dat niet bekend is), een status en, als iets het bericht heeft tegengehouden, de reden.

De regel erboven is het hoofdbericht: dat van de kaarthouder, behalve bij Purchaser, waar het dat van de koper is. Bij Purchaser verschijnt de tweede regel alleen wanneer het bericht in plaats daarvan naar de kaarthouder moest.

Redenen die je op de regel van de koper kunt zien, staan onder de status:

"No purchaser is known for this gift card — it was issued without an order, or the order has no customer" — de kaart heeft geen koper. Bij Both is alleen de kaarthouder op de hoogte gebracht.
"No email address is known for the purchaser", of hetzelfde voor een telefoonnummer — bij Both is de koper bekend, maar heeft die geen adres op dit kanaal, dus is alleen de kaarthouder op de hoogte gebracht.
"No email address is known for the purchaser — sent to the card holder instead", of hetzelfde voor een telefoonnummer — bij Purchaser heeft de kaart geen koper, of heeft de koper geen adres op dit kanaal, en het bericht is naar de kaarthouder gegaan. De hoofdregel toont waarheen het is gegaan.
"The purchaser is the card holder — one message sent" — bij Both delen de twee een adres, dus is er één bericht verstuurd.
"Could not look up who bought the card" — het bericht aan de koper is Failed, omdat Gift Card Hero Shopify niet kon bereiken om de bestelling te vinden. Bij Both staat dit op de regel van de koper; bij Purchaser staat het op de hoofdregel, omdat dat het bericht van de koper is. Dit wordt niet gezien als "geen koper": het bericht wordt apart opnieuw geprobeerd en in de tussentijd niet naar de kaarthouder doorgestuurd.

Bij Purchaser verschijnen, als ook de kaarthouder niet kon worden bereikt, de eerste twee formuleringen hierboven zonder "sent to the card holder instead". Er is dan op dat kanaal niets verstuurd.

Een Not sent-regel van de koper verandert nooit de uitkomst van de inwisseling: is het bericht aan de kaarthouder verstuurd, dan telt de inwisseling als verstuurd. Een Failed-regel wel: de inwisseling telt dan als mislukt en wordt opnieuw geprobeerd, en alleen het mislukte bericht wordt opnieuw verstuurd. Een bericht dat al is verstuurd, wordt niet herhaald.

Zoeken vindt een inwisseling ook op het e-mailadres of telefoonnummer van de koper. Het statusfilter, gecombineerd met een kanaal, kijkt ook naar het bericht aan de koper. Kies je dus SMS en Failed, dan vind je ook een mislukte sms aan de koper.

Een bericht zonder saldo¶

Gift Card Hero leest de kaart op het moment dat hij wordt besteed. Af en toe antwoordt Shopify niet op tijd, meestal omdat de winkel veel verzoeken tegelijk doet. De kaart wordt dan opnieuw gelezen vlak voordat het bericht wordt verstuurd, en het log zegt "The card could not be read when it was spent" onder het saldo. Antwoordt Shopify dan nog steeds niet, dan staat de inwisseling op Failed met "Could not read the gift card" en wordt ze opnieuw geprobeerd. De latere lezing levert het saldo. Een kaart die tussendoor opnieuw is besteed, kan daardoor iets minder tonen dan wat deze aankoop overliet. Met de instelling Force gift cards to be onetime aan, is de kaart dan al leeggemaakt, zoals hij ook al kan zijn wanneer Shopify bij een tweede poging even later wel antwoordt. Het saldo is dan Unknown en het bericht wordt zonder saldo verstuurd: de ingebouwde e-mail en sms laten het saldo weg, en het Klaviyo-event heeft geen balance. Om hetzelfde in je eigen sjabloon te doen, plaats je het saldo in {% if balance != blank %}…{% endif %}.

Hoe de kaarthouder wordt gevonden¶

De kaarthouder wordt op de volgende manier gevonden, in deze volgorde:

De ontvanger van de cadeaubon in Shopify — de persoon aan wie de kaart is verstuurd, ingesteld op de kaart zelf. Dus dit werkt ook voor kaarten die zijn uitgegeven vanuit de Shopify-admin of een kassa.
De klant aan wie de kaart in Shopify is toegewezen — ook dit wordt uit de kaart gelezen.
Het cadeaubonrecord in Gift Card Hero — het adres waarnaar de kaart is afgeleverd (alleen e-mail; het record bevat geen telefoonnummer).
Het afleverschema — voor kaarten die in de wachtrij staan voor een toekomstige verzending.
De klant op de bestelling waarmee de kaart is betaald — de laatste uitweg, en de persoon die die bestelling heeft geplaatst, die niet per se de kaarthouder is. (De bestelling waarmee de kaart is gekocht, hoort bij de koper; zie Wie geldt als koper.) Voor het telefoonnummer kijkt dit ook naar het nummer dat bij het afrekenen is ingetypt.

Het e-mailadres en het telefoonnummer worden apart opgezocht, elk langs deze lijst. Ze kunnen dus uit verschillende bronnen komen: het e-mailadres uit de kaart, het nummer uit de bestelling. Het log vermeldt welke bron is gebruikt.

Levert niets een adres of nummer op, dan wordt dat kanaal in het log als niet verstuurd vermeld. Door in Shopify een ontvanger met telefoonnummer aan de kaart toe te wijzen, is het probleem opgelost voor elke toekomstige inwisseling van die kaart.

Dit is de persoon die de variabelen holder in het sjabloon beschrijven. De koper wordt op een andere manier gevonden; zie Wie geldt als koper.

Notities¶

Terugboekingen, annuleringen en mislukte betalingen worden genegeerd. Alleen een geslaagde betaling met een cadeaubon verstuurt iets.
Bestellingen in testmodus leveren nooit een klantbericht op.
Een herhaald event van Shopify verstuurt geen tweede bericht. Elke inwisseling wordt per kanaal en per persoon maximaal één keer gemeld. Met Both krijgen de kaarthouder en de koper elk één.
Dit zijn transactionele berichten over de eigen kaart van een klant, geen marketing. Het filter op marketingtoestemming dat geldt voor herinneringen is hier dus niet van toepassing.
Gift Card Hero heeft geen eigen sms-provider. Staat het sms-kanaal aan, maar is de provider intussen uit Integraties verwijderd, dan wordt de sms als niet verstuurd gelogd en gaat de e-mail nog steeds uit.