Notifications d'utilisation¶

Un client qui paie avec une carte-cadeau repart sans savoir ce qu'il lui reste dessus. Les notifications d'utilisation comblent cette lacune : à chaque utilisation d'une carte, le titulaire reçoit un e-mail, un SMS, ou les deux, avec la date, le montant débité, le solde restant et — pour les achats en magasin — le magasin où l'achat a eu lieu.

C'est ce que fait une banque après un paiement par carte, et les clients attendent la même chose d'une carte-cadeau. Cela réduit aussi les demandes du type « combien reste-t-il sur ma carte ? », et le message d'épuisement est un moment idéal pour faire revenir un client.

La personne qui a acheté la carte en cadeau peut également être informée : voir Qui est notifié.

Depuis la page d'accueil, ouvrez la carte Customer notifications, cliquez sur Configure notifications, puis ouvrez l'onglet Redemption notifications. (Les autres onglets de la page sont Unused balance reminders et e-mails de fidélité.)

L'onglet contient la politique : si les notifications sont activées, quand elles partent, qui les reçoit, sur quels canaux et par quel moyen. Chaque message se modifie sur sa propre page, avec un aperçu et un envoi de test ; le journal d'envoi a également sa propre page.

Paramètres des notifications d'utilisation

Activer les notifications¶

Les notifications sont désactivées tant que vous ne cliquez pas sur Enable en haut de l'onglet, et le réglage s'applique boutique par boutique. Cliquez sur Save dans la barre d'enregistrement pour l'appliquer.

Les activer abonne Gift Card Hero aux événements de paiement de votre boutique, afin qu'il soit informé d'une utilisation dès qu'elle a lieu — en caisse comme en ligne. Les désactiver les désabonne ; rien n'est envoyé et rien n'est enregistré.

Quand envoyer¶

Sous When to notify, deux déclencheurs — tous deux cochés par défaut, vous pouvez utiliser l'un ou l'autre, ou les deux :

On every redemption — un message après chaque utilisation, quel que soit le solde. Un message par carte-cadeau utilisée sur une commande : si le client paie avec deux cartes, deux messages partent.
When the balance reaches zero — un message « votre carte est maintenant entièrement utilisée », envoyé même lorsque la première option est désactivée.

Avec les deux options activées, une utilisation qui vide la carte envoie un message par canal, et non deux : le texte d'épuisement remplace le texte habituel.

Avec seulement la seconde option activée, les clients n'entendent parler de vous qu'une fois, à la fin. C'est adapté aux boutiques où les cartes sont généralement dépensées en plusieurs petits achats, pour lesquels un message à chaque café serait du bruit.

Vous ne pouvez pas enregistrer les réglages avec la fonctionnalité activée et aucun déclencheur coché : cela reviendrait à vous abonner aux événements puis à rejeter chacun d'eux.

Indiquer le magasin¶

Include the store location (coché par défaut) ajoute le magasin au message.

L'emplacement est le point de vente Shopify POS où la vente a été réalisée, ou le magasin que signale votre application de caisse lorsqu'elle utilise une carte via l'API REST. Il est absent des commandes en ligne. Sans emplacement, la ligne est retirée du message plutôt qu'affichée vide — rien à configurer pour les boutiques uniquement en ligne.

Pour les enseignes à plusieurs magasins, c'est souvent la ligne la plus utile de l'e-mail : elle indique au titulaire où l'argent a été dépensé, ce qui permet de reconnaître un débit inattendu.

Qui est notifié¶

Par défaut, seul le titulaire de la carte est informé. La section Who gets notified de l'onglet vous permet de modifier cela :

Card holder (par défaut) — la personne à qui appartient la carte. Une boutique qui ne touche pas à ce réglage fonctionne exactement comme avant.
Purchaser — le client qui a acheté la carte, au lieu du titulaire.
Both — le titulaire et l'acheteur reçoivent chacun un message qui leur est propre.

Ce réglage s'adresse au client qui offre une carte-cadeau et souhaite savoir qu'elle a été utilisée. Avec Purchaser ou Both, il est informé de chaque dépense — même partielle — avec le montant utilisé et le solde restant.

L'acheteur suit les mêmes règles que le titulaire : les déclencheurs de Quand envoyer et les canaux de Canaux. Pour être informé de chaque dépense, gardez On every redemption coché ; avec seulement When the balance reaches zero activé, l'acheteur n'est informé qu'une fois, à la fin.

Le choix prend effet à partir de la prochaine utilisation après que vous avez cliqué sur Save. Une utilisation déjà en cours d'envoi conserve le choix avec lequel elle a commencé.

Le e-mail et le SMS intégrés sont adressés au titulaire

L'e-mail intégré s'adresse au titulaire : « Votre carte-cadeau se terminant par 4242 vient d'être utilisée », et « Vous pouvez utiliser le solde restant lors de votre prochaine commande ». Le SMS intégré est plus court, mais ne dit rien de la personne qui a dépensé la carte : un acheteur ne peut donc pas savoir qu'il s'agit du cadeau qu'il a offert.

Gift Card Hero ne modifie pas le texte intégré lorsque vous choisissez Purchaser ou Both. Modifiez d'abord l'e-mail et le SMS, comme indiqué dans Rédiger le message pour l'acheteur, puis enregistrez le réglage. Si l'e-mail passe par Klaviyo, le Flow doit plutôt comporter une branche pour l'acheteur — voir Klaviyo.

Qui est le titulaire de la carte¶

La personne à qui la carte a été envoyée — ou, à défaut, le client à qui elle est attribuée, puis les données de Gift Card Hero sur la carte, et en dernier recours le client de la commande payée avec la carte. Comment le titulaire est trouvé détaille l'ordre complet.

Qui est l'acheteur¶

Le client de la commande dans laquelle la carte a été achetée. Cela fonctionne pour les deux types de cartes :

Un produit carte-cadeau Shopify — la commande est lue à partir de la carte.
Une carte émise par Gift Card Hero lui-même, par exemple lorsque vous vendez des cartes-cadeaux via des produits classiques — la commande provient du calendrier d'envoi de Gift Card Hero.

L'adresse e-mail et le numéro de téléphone de l'acheteur sont ceux du client, ou ceux de la commande lorsque le client n'en a pas. L'adresse à laquelle un cadeau a été envoyé appartient au titulaire, jamais à l'acheteur.

Gift Card Hero ne lit les coordonnées de l'acheteur dans Shopify que lorsque Purchaser ou Both est sélectionné. Une utilisation enregistrée alors que Card holder était sélectionné n'en contient aucune ; si vous changez ensuite de réglage, l'acheteur est recherché au moment de l'envoi — via la commande dans laquelle la carte a été achetée, lorsque Gift Card Hero la connaît. Sinon, il n'y a pas d'acheteur, comme décrit dans Lorsqu'il n'y a pas d'acheteur.

Lorsqu'il n'y a pas d'acheteur¶

Certaines cartes n'en ont pas : une carte émise à la main dans l'administration Shopify, une carte vendue en caisse sans client rattaché, ou une carte importée.

Avec Purchaser, le message est envoyé au titulaire à la place.
Avec Both, seul le message du titulaire est envoyé.

Dans les deux cas, le journal d'envoi l'indique sur la ligne de l'acheteur.

La même solution de repli s'applique par canal. Un acheteur qui a une adresse e-mail mais pas de numéro de téléphone reçoit l'e-mail, et avec Purchaser, le SMS va au titulaire.

Avec Both¶

Chaque utilisation envoie deux messages distincts par canal : un au titulaire et un à l'acheteur, chacun rédigé à partir de votre modèle avec l'audience correspondante (voir plus bas). Avec les SMS activés, cela représente deux textos, et votre opérateur de passerelle facture chacun d'eux.

Lorsque le titulaire et l'acheteur ont la même adresse e-mail — ou, pour les SMS, le même numéro de téléphone — un seul message est envoyé, et le journal l'indique.

Messages texte¶

Les SMS suivent la même règle que les e-mails. Avec Purchaser, le SMS va au numéro de téléphone de l'acheteur, et à celui du titulaire lorsque l'acheteur n'en a pas. Avec Both, chacun reçoit le sien.

L'e-mail et le SMS sont décidés séparément : l'e-mail peut atteindre l'acheteur tandis que le SMS revient au titulaire.

Rédiger le message pour l'acheteur¶

Trois variables distinguent un message d'un autre :

{{ audience }} — le destinataire du message : purchaser ou holder. Un message revenu au titulaire, parce que la carte n'a pas d'acheteur, vaut holder.
{{ holder.first_name }}, {{ holder.last_name }} et {{ holder.email }} — le titulaire, tel que Gift Card Hero le connaît. Elles sont renseignées sur chaque message, y compris celui du titulaire, et restent vides lorsqu'elles sont inconnues — prévoyez donc une valeur de repli avec default.
{{ customer.first_name }} et les autres variables customer — la personne à qui le message est adressé. Sur un message destiné à l'acheteur, il s'agit de l'acheteur.

Utilisez audience dans l'objet, le corps de l'e-mail et le SMS. Ce que vous placez dans la partie {% else %} est lu par le titulaire — y compris avec Purchaser, lorsqu'une carte sans acheteur revient au titulaire — gardez donc là votre formulation destinée au titulaire.

L'objet :

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

Le corps de l'e-mail — un fragment suffit :

{% 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>

Le 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 %}

Rendu, le SMS destiné à l'acheteur se lit ainsi :

Artcaffe: Wanjiru a utilisé KSh 1,500.00 de la carte-cadeau que vous avez offerte (*4242) à Westlands. Solde restant : KSh 3,500.00.

Cela représente environ 110 à 120 caractères avec des valeurs typiques, donc un seul segment de 160 caractères suffit. Un prénom ou un magasin contenant un caractère hors de l'alphabet latin de base — « Zoë », par exemple — fait basculer tout le message à la limite de 70 caractères ; voir Le modèle de SMS. L'aperçu de l'éditeur indique le coût de votre formulation au fil de la saisie.

Klaviyo¶

Lorsque l'e-mail passe par Klaviyo, votre modèle n'est pas utilisé : il n'y a donc rien à rédiger dans Gift Card Hero. L'événement Gift Card Redeemed contient audience (holder ou purchaser) ainsi que holder_first_name, holder_last_name et holder_email du titulaire, lorsqu'ils sont connus. Il est rattaché au profil de la personne à qui le message est adressé — pour le message de l'acheteur, l'acheteur.

Un Flow peut filtrer sur audience : utilisez un filtre de déclencheur, ou un partage conditionnel dans le Flow, pour envoyer à l'acheteur son propre texte. Un Flow sans condition sur audience s'exécute pour chaque événement : une fois l'acheteur notifié, il recevrait donc l'e-mail destiné au titulaire.

Avec Both, Gift Card Hero envoie deux événements par utilisation, un pour chaque personne. La liste complète des propriétés se trouve dans Intégrations.

Canaux¶

Sous Channels, cochez les canaux par lesquels la notification part — Email, SMS, ou les deux. L'e-mail est coché par défaut. Chaque canal est livré séparément : une carte qui a une adresse e-mail mais pas de numéro de téléphone reçoit tout de même l'e-mail, et un SMS refusé par la passerelle ne bloque pas l'e-mail.

SMS peut être coché une fois qu'un fournisseur de SMS est connecté dans Settings → Integrations — voir Intégrations. La ligne indique le fournisseur et l'identifiant d'expéditeur depuis lequel les SMS arrivent. Les SMS partent via votre propre compte de passerelle et sont facturés par la passerelle à chaque message ; l'éditeur de SMS indique le coût de chacun.

Vous ne pouvez pas enregistrer les réglages avec la fonctionnalité activée et aucun canal coché.

Moyen d'envoi¶

Sous Email, choisissez le circuit qui transporte l'e-mail :

Gift Card Hero email — la valeur par défaut. Nous générons le modèle d'e-mail et l'envoyons depuis notre serveur de messagerie. Rien à configurer, mais l'e-mail ne vient pas de votre propre domaine.
Your mail server (SMTP) — le même e-mail, envoyé via votre propre serveur de messagerie, afin qu'il arrive depuis votre domaine. Sélectionnable une fois qu'un serveur est ajouté dans Settings → Integrations.
Klaviyo — au lieu d'envoyer quoi que ce soit lui-même, Gift Card Hero envoie un événement Gift Card Redeemed à Klaviyo, et un Flow que vous créez là-bas envoie l'e-mail. Le modèle d'e-mail n'est pas utilisé dans ce mode, et tant que ce Flow n'existe pas, vos clients ne reçoivent rien. Une fois Klaviyo sélectionné, un lien Send a test event apparaît dessous : il ouvre un petit formulaire qui envoie un événement d'exemple avec toutes les propriétés renseignées, afin que vous puissiez créer le Flow à partir de celui-ci — voir Intégrations.

Chaque notification choisit son propre circuit. Les rappels et les e-mails d'utilisation peuvent partir par des circuits différents — Settings → Integrations ne contient que les identifiants. Voir Intégrations pour la configuration.

Si le moyen d'envoi choisi n'est pas utilisable au moment de l'envoi — Klaviyo déconnecté, ou paramètres du serveur de messagerie incomplets — l'e-mail est envoyé via Gift Card Hero email à la place.

Le SMS n'a pas de moyen d'envoi à choisir : il passe toujours par le fournisseur connecté dans Integrations.

Messages¶

La section Messages affiche chaque message sur une ligne — l'objet de l'e-mail, le SMS tel que le client le lit, si chacun est la version intégrée ou la vôtre, et la manière dont il part (ou pourquoi il ne part pas : le canal est désactivé, Klaviyo l'envoie, aucune passerelle n'est connectée). Edit template sur chaque ligne ouvre son éditeur.

Chaque éditeur affiche, sous son titre, par quel canal le message part, avec un lien Change vers l'endroit où ce choix se fait. À droite, il liste les variables et indique si vous utilisez le message intégré ou le vôtre ; Reset to built-in rétablit le nôtre.

Le modèle d'e-mail¶

Si vous laissez le modèle intégré, vos clients reçoivent le nôtre, qui couvre déjà à la fois le texte habituel et le texte d'épuisement. Il est rédigé pour le titulaire : si vous informez également l'acheteur, voir Qui est notifié. Si vous le modifiez, le vôtre est utilisé à la place — y compris, à partir de là, à la place de toute amélioration que nous apporterions au modèle intégré. Un champ vidé est considéré comme « utiliser le modèle intégré ».

Variables disponibles :

Variable	Contenu
`{{ amount }}`	Montant débité de la carte, au format monétaire de votre boutique
`{{ balance }}`	Solde restant après cette utilisation
`{{ date }}`	Date de l'utilisation
`{{ branch }}`	Emplacement du magasin, vide pour les commandes en ligne
`{{ card_last4 }}`	Les quatre derniers caractères du code de la carte-cadeau
`{{ order_name }}`	La commande payée avec la carte, par exemple `#1001`
`{{ depleted }}`	Vrai lorsque cette utilisation a vidé la carte
`{{ customer.first_name }}`	Prénom de la personne à qui le message est adressé, lorsqu'il est connu — le titulaire, ou l'acheteur sur un message qui lui est destiné
`{{ audience }}`	Destinataire du message : `holder` ou `purchaser`
`{{ holder.first_name }}`	Prénom du titulaire, lorsqu'il est connu — renseigné sur chaque message, y compris ceux destinés à l'acheteur
`{{ holder.last_name }}`	Nom de famille du titulaire, lorsqu'il est connu
`{{ holder.email }}`	Adresse e-mail du titulaire, lorsqu'elle est connue
`{{ shop.name }}`	Le nom de votre boutique

{{ customer.last_name }}, {{ customer.email }} et {{ customer.phone }} sont également renseignées lorsqu'elles sont connues, et décrivent la même personne que customer.first_name. Rédiger le message pour l'acheteur montre comment utiliser audience et les variables holder. Le corps peut être un document HTML complet ou un simple fragment. Les modèles ne peuvent utiliser que ces variables et les informations de base de la boutique (shop.name, shop.email, shop.domain, shop.currency) ; les balises {% include %} et {% render %} ne sont pas disponibles.

Entourez toute valeur susceptible d'être absente pour que l'e-mail se lise correctement dans tous les cas :

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

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

Éditeur de l'e-mail d'utilisation

Preview affiche le modèle avec des montants d'exemple, exactement tel que le client le verra. Send test email ouvre un petit formulaire avec l'adresse de destination, pré-remplie avec l'e-mail de contact de votre boutique ; le test part par le même circuit que la vraie notification, ce qui prouve aussi que vos paramètres SMTP fonctionnent. L'objet porte la mention [Test]. Vous pouvez envoyer jusqu'à 20 messages de test par heure et par boutique, tous éditeurs confondus.

Le modèle de SMS¶

L'éditeur (« Redemption SMS ») liste {{ amount }}, {{ balance }}, {{ date }}, {{ branch }}, {{ card_last4 }}, {{ depleted }} et {{ shop.name }} ; les autres variables de l'e-mail, comme {{ order_name }}, {{ customer.first_name }}, {{ audience }} et {{ holder.first_name }}, fonctionnent également. La même règle que pour l'e-mail s'applique : laissez le texte intégré et vous recevez le nôtre, modifiez-le et le vôtre est utilisé. Un texte peut comporter jusqu'à 2 000 caractères avant rendu.

Le texte intégré tient en un seul message et se lit, pour une utilisation habituelle :

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

et, lorsque la carte est vidée :

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

Sous l'éditeur, l'aperçu affiche le message tel que le client le lira — à la fois le texte habituel et le texte d'épuisement — ainsi que le nombre de messages que chacun coûte, mis à jour au fil de la saisie. Un SMS est facturé par segment : 160 caractères pour un texte simple, 70 dès qu'il contient un caractère hors de l'alphabet latin de base (un emoji, une apostrophe courbe, certaines lettres accentuées), si bien qu'une petite modification peut doubler le coût de chaque message. Un texte plus long est découpé en segments de 153 caractères (67 avec de tels caractères). Le compteur est calculé sur le texte rendu, et non sur le modèle : les balises elles-mêmes ne comptent pas.

Send test SMS (désactivé tant qu'aucun fournisseur de SMS n'est connecté) ouvre un petit formulaire pour le numéro de destination. Le test est rendu avec des montants d'exemple et envoyé via votre passerelle — il prouve donc aussi que la passerelle délivre, et vous montre le message sur un vrai téléphone. Un numéro local est lu comme un numéro du pays de la passerelle. Un vrai message est envoyé et facturé.

Journal d'envoi¶

La section Delivery log de l'onglet résume les sept derniers jours — le nombre d'utilisations envoyées, en échec et non envoyées — et indique la plus récente. View delivery log ouvre le journal complet sur sa propre page.

Le journal liste chaque utilisation prise en compte et le sort de chaque message. Les colonnes sont Date, Gift card, Redeemed, Balance left, Branch et une colonne pour Email et pour SMS — à qui le message a été envoyé et comment cela s'est terminé. Une utilisation faite via l'API REST affiche « REST API » et sa référence sous le magasin. Recherchez par les derniers caractères de la carte, une adresse e-mail, un numéro de téléphone ou un nom de commande ; filtrez par statut, par canal et par période (les 7, 30 ou 90 derniers jours, ou depuis toujours). Cliquez sur une carte pour l'ouvrir dans Shopify.

Journal d'envoi

Statuts, par canal :

Sending — le message est en cours d'envoi.
Sent — le message est parti.
Failed — l'envoi a été rejeté. Survolez le badge pour voir la raison ; un mauvais mot de passe SMTP, une adresse refusée et un identifiant d'expéditeur SMS non enregistré apparaissent ici. Un canal en échec est réessayé quelques fois automatiquement — l'autre canal n'est pas renvoyé.
Not sent — l'utilisation a bien été enregistrée, mais ce canal n'a volontairement pas été utilisé, avec la raison à côté. Le plus souvent « no email address (or phone number) is known for this gift card », ou une carte qui a encore un solde dans une boutique qui n'envoie que les notifications d'épuisement.

Un canal non coché affiche un tiret.

Sous l'adresse ou le numéro, le journal indique d'où il provient — « 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 » ou, lorsque le message est allé à l'acheteur, « purchaser ». C'est ce qui distingue « rien n'a été envoyé » de « c'est allé à la mauvaise personne » : une carte dont le destinataire n'a jamais été enregistré se rabat sur le client de la commande payée, et cette ligne vous le montre.

Lignes de l'acheteur¶

Lorsque l'acheteur a un message qui lui est propre, ou a été ignoré, une seconde ligne intitulée Purchaser apparaît sous le canal. Elle affiche l'adresse ou le numéro de l'acheteur (un tiret lorsqu'il n'est pas connu), un statut et, lorsqu'un élément a empêché l'envoi, la raison.

La ligne au-dessus est le message principal : celui du titulaire, sauf avec Purchaser, où il s'agit de celui de l'acheteur. Avec Purchaser, la seconde ligne n'apparaît que lorsque le message a dû être envoyé au titulaire à la place.

Raisons possibles sur la ligne de l'acheteur, affichées sous le statut :

« No purchaser is known for this gift card — it was issued without an order, or the order has no customer » — la carte n'a pas d'acheteur. Avec Both, seul le titulaire a été prévenu.
« No email address is known for the purchaser », ou la même chose pour un numéro de téléphone — avec Both, l'acheteur est connu mais n'a pas d'adresse sur ce canal, seul le titulaire a donc été prévenu.
« No email address is known for the purchaser — sent to the card holder instead », ou la même chose pour un numéro de téléphone — avec Purchaser, la carte n'a pas d'acheteur, ou l'acheteur n'a pas d'adresse sur ce canal, et le message est allé au titulaire. La ligne principale indique où il est allé.
« The purchaser is the card holder — one message sent » — avec Both, les deux partagent une même adresse, un seul message est donc parti.
« Could not look up who bought the card » — le message destiné à l'acheteur est en Failed, car Gift Card Hero n'a pas pu joindre Shopify pour trouver la commande. Avec Both, cela figure sur la ligne de l'acheteur ; avec Purchaser, cela figure sur la ligne principale, puisqu'il s'agit du message de l'acheteur. Ce n'est pas considéré comme « pas d'acheteur » : le message est réessayé de son côté et n'est pas redirigé vers le titulaire entre-temps.

Avec Purchaser, si le titulaire n'a pas non plus pu être joint, les deux premières formulations ci-dessus apparaissent sans « sent to the card holder instead » — rien n'est parti sur ce canal.

Une ligne d'acheteur Not sent ne change jamais le résultat de l'utilisation : si le message du titulaire est parti, l'utilisation compte comme envoyée. Une ligne Failed la fait compter comme en échec et la réessaie, et seul le message en échec est renvoyé. Un message déjà parti n'est pas répété.

La recherche retrouve aussi une utilisation par l'adresse e-mail ou le numéro de téléphone de l'acheteur. Le filtre de statut, combiné à un canal, regarde aussi le message de l'acheteur : choisir SMS et Failed retrouve donc un SMS d'acheteur en échec.

Un message sans solde¶

Gift Card Hero lit la carte au moment où elle est dépensée. De temps à autre, Shopify ne répond pas à temps — généralement parce que la boutique envoie beaucoup de requêtes simultanément. La carte est alors relue juste avant l'envoi du message, et le journal indique « The card could not be read when it was spent » sous le solde ; si Shopify ne répond toujours pas, l'utilisation s'affiche en Failed avec « Could not read the gift card » et est réessayée. La relecture fournit le solde, si bien qu'une carte dépensée à nouveau entre-temps peut afficher un peu moins que ce que cet achat a laissé. Avec Force gift cards to be onetime activé, la carte a déjà été vidée à ce moment-là — comme elle peut l'être lorsque Shopify répond à une seconde tentative un instant plus tard — donc le solde est Unknown et le message part sans lui : l'e-mail et le SMS intégrés omettent le solde, et l'événement Klaviyo n'a pas de balance. Pour faire de même dans votre propre modèle, entourez le solde de {% if balance != blank %}…{% endif %}.

Comment le titulaire est trouvé¶

Le titulaire est trouvé de la manière suivante, dans cet ordre :

Le destinataire de la carte-cadeau dans Shopify — la personne à qui la carte a été envoyée, définie sur la carte elle-même ; cela fonctionne donc pour les cartes émises depuis l'administration Shopify ou une caisse.
Le client auquel la carte est attribuée dans Shopify — également lu sur la carte.
L'enregistrement de la carte dans Gift Card Hero — l'adresse à laquelle la carte a été livrée (e-mail uniquement ; l'enregistrement ne contient pas de numéro de téléphone).
The delivery schedule — pour les cartes en file d'attente pour un envoi futur.
Le client de la commande payée avec la carte — en dernier recours, et il s'agit de la personne qui a passé cette commande, qui n'est pas forcément le titulaire. (La commande dans laquelle la carte a été achetée appartient à l'acheteur — voir Qui est l'acheteur.) Pour le numéro de téléphone, cette étape regarde aussi le numéro saisi lors du paiement.

L'adresse e-mail et le numéro de téléphone sont recherchés séparément, chacun selon cette liste, si bien qu'ils peuvent venir de sources différentes — l'e-mail depuis la carte-cadeau, le numéro depuis la commande — et le journal indique laquelle.

Si rien ne fournit d'adresse ou de numéro, ce canal est enregistré comme non envoyé. Attribuer à la carte, dans Shopify, un destinataire disposant d'un numéro de téléphone corrige la situation pour toutes les utilisations futures de cette carte.

C'est la personne que décrivent les variables de modèle holder. L'acheteur est trouvé différemment — voir Qui est l'acheteur.

Remarques¶

Les remboursements, annulations et paiements échoués sont ignorés — seul un paiement réussi par carte-cadeau déclenche un envoi.
Les commandes en mode test ne produisent jamais de message client.
Un événement répété provenant de Shopify n'envoie pas un second message ; chaque utilisation donne lieu à au plus une notification par canal et par personne — avec Both, le titulaire et l'acheteur reçoivent chacun la leur.
Il s'agit de messages transactionnels concernant la carte d'un client, et non de marketing : le filtre de consentement marketing qui s'applique aux rappels ne s'applique donc pas ici.
Gift Card Hero n'a pas de fournisseur SMS propre : si le canal SMS est activé et que le fournisseur a depuis été retiré dans Integrations, le texte est enregistré comme non envoyé, et l'e-mail part tout de même.