Notifier les clients d'une mise à jour de produit

Ce que fait Notifier les clients

Notifier les clients envoie un e-mail à chaque ancien acheteur d'un produit, avec un bouton qui ouvre le téléchargement des derniers fichiers propre à cet acheteur. Vous le lancez depuis la page du produit dans l'admin Alva : ouvrez le produit, cliquez sur Notifier les clients, choisissez les destinataires, ajoutez une note facultative, vérifiez l'aperçu et envoyez.

L'e-mail est un avis de mise à jour de produit figé, dans la langue de votre boutique, et non un e-mail marketing. Il part sur un flux d'envoi distinct de vos e-mails de livraison, avec le suivi des ouvertures et des clics désactivé afin que le lien de téléchargement ne soit jamais réécrit. Toute personne qui s'est désabonnée ou a signalé un e-mail précédent comme spam est ignorée automatiquement.

Qui reçoit l'e-mail

Chaque client qui a acheté l'une des variantes sélectionnées et qui est toujours abonné aux e-mails reçoit exactement un message. Si les variantes d'un produit livrent des fichiers différents, la fenêtre modale affiche une case à cocher par ensemble de fichiers, libellée avec les variantes qu'il dessert ; toutes sont sélectionnées par défaut. Un acheteur de plusieurs variantes sélectionnées reçoit un seul e-mail.

Cet e-mail unique renvoie vers l'achat le plus récent de l'acheteur parmi les variantes sélectionnées. L'autre variante reste accessible via son lien de téléchargement d'origine et la page de statut de commande. Le nombre de destinataires se met à jour lorsque vous modifiez la sélection, et le nombre d'acheteurs désabonnés s'affiche en dessous — ils ne peuvent pas être joints depuis ici.

Les achats dont l'accès au téléchargement est désactivé, ou qui n'ont pas passé votre vérification anti-fraude, sont exclus. Les produits personnalisés n'ont aucun fichier partagé à renvoyer, ils n'affichent donc pas le bouton du tout, et un produit dont les mappages ne contiennent ni fichiers, ni packs, ni liens ne peut pas faire l'objet d'une notification.

Ce que dit l'e-mail

L'e-mail est un modèle verrouillé : l'objet, la salutation, la ligne d'introduction, le bouton Télécharger les fichiers et le pied de page sont fixes et traduits dans la langue de votre boutique. La seule partie que vous pouvez ajouter est une note en texte brut de 2 000 caractères maximum, affichée sous « Un message de {votre boutique} : » entre la ligne d'introduction et le bouton. Les acheteurs voient, dans l'ordre :

• Objet : Mise à jour de votre achat de {titre du produit}
• Bonjour {prénom},
• {Nom de la boutique} a mis à jour votre achat de {titre du produit}. Cliquez ci-dessous pour télécharger la dernière version.
• Un message de {nom de la boutique} : suivi de votre note — uniquement si vous en avez ajouté une
• Le bouton Télécharger les fichiers, qui ouvre la page de téléchargement propre à l'acheteur
• Un pied de page avec le nom de votre boutique et un lien de désabonnement

Ajouter une note

Saisissez la note dans le champ Ajouter une note (facultatif). Texte brut uniquement : les liens et adresses e-mail ne sont pas autorisés — adresses web, www. et noms de domaine nus compris — et le champ les refuse avant que vous puissiez envoyer, de sorte que le bouton Télécharger les fichiers reste le seul lien de l'e-mail. Ne mettez ni remises ni promotions dans la note : cet e-mail est une mise à jour de produit, pas du marketing.

Variables utilisables dans la note

Trois boutons sous le champ insèrent les trois premières variables ; un menu Métachamp du produit liste les métachamps du produit pour la quatrième :

• {customer.first_name} — le prénom de l'acheteur, avec une formule neutre lorsqu'il est inconnu. Il se lit mieux en début de ligne.
• {shop.name} — le nom de votre boutique.
• {product.title} — le titre du produit, comme dans l'objet.
• {product.metafields.<namespace>.<key>} — la valeur de l'un des métachamps Shopify du produit, par exemple {product.metafields.custom.edition}. Une note peut utiliser jusqu'à cinq métachamps différents. Le menu liste les 50 premiers métachamps du produit avec leurs valeurs actuelles.

Les types de métachamps pris en charge sont le texte sur une ou plusieurs lignes, les nombres entiers et décimaux, les dates (écrites en toutes lettres dans la langue de votre boutique) et les listes de texte. Un métachamp d'un autre type — un lien, une valeur vrai/faux, une référence, du texte enrichi ou un fichier — ne peut pas être affiché dans un e-mail, la note est donc refusée avec une erreur affichée sous le champ jusqu'à ce que vous le retiriez. Il en va de même pour un métachamp sans valeur sur ce produit, pour une variable qu'Alva ne connaît pas, pour une accolade non fermée et pour un lien dans la valeur d'un métachamp.

Prévisualiser avant d'envoyer

L'Aperçu de l'email sous la note affiche l'objet et le corps exactement tels qu'un acheteur les verra, dans la langue de votre boutique, avec la note et ses variables remplies à partir des valeurs réelles du produit. L'aperçu et l'e-mail envoyé sont construits par le même code : ce que vous voyez est ce qui part. Si un métachamp change pendant que la fenêtre est ouverte, l'aperçu s'actualise et vous demande de le vérifier à nouveau.

Produits ZIP : l'e-mail attend l'archive

Si un produit livre une archive ZIP et que vous venez de remplacer ses fichiers, l'envoi attend qu'Alva ait fini de régénérer l'archive, afin qu'aucun acheteur ne télécharge l'ancienne version. Jusque-là, l'historique des notifications affiche « En attente de la fin de la génération de l'archive avant l'envoi. » ; l'envoi est toujours en file d'attente et peut encore être annulé.

Si la régénération échoue, l'envoi échoue avec le motif « L'archive ZIP de ce produit n'a pas pu être générée, rien n'a donc été envoyé. » Corrigez les fichiers — les remplacer lance une nouvelle régénération — et notifiez à nouveau. Si l'archive est toujours en cours de régénération après une heure, l'envoi échoue également, en l'indiquant, et vous pouvez notifier à nouveau une fois la régénération terminée. Dans les deux cas rien n'a été envoyé, la limite de 7 jours n'est donc pas consommée.

Les produits qui livrent des fichiers individuels ou des liens n'ont pas d'archive et ne sont jamais retenus.

L'historique des notifications

Sous la carte Paramètres du produit, Historique des notifications liste les dix derniers envois du produit : la date, le nombre de destinataires, combien d'e-mails ont été envoyés, ont échoué, ont été supprimés ou ont fait l'objet d'une plainte, qui l'a envoyé, et son statut — En file d'attente, Envoi en cours, Terminé, Partiel, Échec ou Annulé. Un badge indique son origine : Admin, API ou Mise à jour du mappage (API).

Une ligne indique aussi combien de variantes elle ciblait et les premières lignes de sa note. Une ligne en Échec en donne la raison, en toutes lettres : les e-mails aux clients étaient désactivés, rien n'a donc été envoyé ; la note enregistrée n'a pas pu être rendue ; la note contenait un lien ; l'archive était toujours en cours de régénération après une heure ; l'archive ZIP n'a pas pu être générée ; ou l'envoi a été interrompu par un redémarrage du serveur. Partiel signifie que certains e-mails ont échoué ou ont été supprimés — les compteurs indiquent combien.

Via l'API

Tout ce que fait le bouton est aussi disponible via l'API externe d'Alva, pour les boutiques dont le propre système met à jour les fichiers. POST /api/v1/products/{id}/notifications met en file d'attente une campagne pour un produit ; envoyez "dry_run": true pour exécuter les mêmes vérifications et obtenir le nombre de destinataires, l'objet et la note rendue sans rien envoyer. GET /api/v1/notifications/{id} lit le résultat.

POST /api/v1/notifications/{id}/cancel arrête une campagne encore en file d'attente ; comme l'annulation dans l'admin, elle conserve la limite de 7 jours du produit. Si votre système crée ou remplace déjà des mappages via l'API, ajoutez notify_customers à POST /api/v1/mappings ou PUT /api/v1/mappings/{id} et les acheteurs de ce mappage sont notifiés une fois les nouveaux fichiers en place — l'attente de l'archive s'applique là aussi. La limite est partagée avec le bouton : pendant la semaine, l'API répond 429 notification_cooldown avec l'heure à laquelle le produit sera de nouveau libre ; planifiez alors le prochain appel à ce moment plutôt que de réessayer. Les corps de requête, les codes d'erreur et les règles d'idempotence sont dans la référence de l'API.