E-mails transactionnels interactifs via la Send API

Les reçus et les confirmations sont les e-mails que les clients ouvrent le plus. Concevez-les une fois dans le studio, envoyez-les depuis votre backend via la Send API, et chaque reçu peut demander comment s’est passée la commande et proposer le produit suivant.

Objet

Your order receipt

Les reçus et les confirmations sont les e-mails que les clients ouvrent le plus. Envoyez-les depuis votre backend via la Send API avec les mêmes blocs interactifs que vos campagnes, et chaque reçu peut demander comment s’est passée la commande et proposer le produit suivant.

Un reçu atteint presque chaque client, juste après son achat. C’est donc le meilleur endroit pour une note rapide, un réassort ou un code pour la prochaine fois, du moment qu’il reste aussi simple à envoyer qu’un reçu ordinaire.

Concevez-le une fois, envoyez-le depuis votre backend

Créez le reçu comme un e-mail normal dans le studio, avec des balises comme {{order_number}} et les blocs de votre choix :

  • Note : « Comment s’est passée votre commande ? » en étoiles ou en visages emoji. Avec Poser une question de suivi si la note vaut au plus, une note basse ouvre une courte question sur ce qui n’a pas plu.
  • Produit : un article associé ou un réassort, acheté depuis le reçu avec Acheter.
  • Coupon : un code pour la prochaine commande, copié d’un geste.
  • Bouton : suivi de commande, facture ou support.

Votre backend appelle ensuite POST /api/v1/send avec le projectId de l’e-mail et un objet mergeData contenant les valeurs de cette commande, jusqu’à 100 champs. Voir Modèle dans la référence de l’API.

Chaque client peut noter, acheter et cliquer depuis le reçu, quelle que soit l’app dans laquelle il le lit.

Lié à vos contacts

Si le client est déjà l’un de vos contacts, le reçu lui est lié : passez un listId, ou laissez MailInApp trouver l’adresse dans vos listes. Sa note arrive alors dans son activité et son score d’engagement, peut remplir un champ du contact et démarrer un parcours, et une prise de rendez-vous se fait en un clic. Voir la référence de l’API.

Conçu pour la production

  • type: "transactional", la valeur par défaut, atteint les clients désinscrits du marketing, puisqu’ils ont quand même besoin de leur reçu. Les adresses en rebond sont ignorées. Voir Transactionnel vs marketing.
  • Idempotency-Key : un appel répété avec la même clé renvoie le premier résultat, donc chaque client reçoit un seul reçu. Voir Idempotence.
  • Limites : chaque clé d’API a une limite par minute, et votre offre inclut un nombre mensuel d’appels à la Send API. Les appels récents sont listés sur la page Développeurs.
  • Sans code : l’action Send Transactional Email de Zapier et le nœud n8n envoient de la même façon.
  • Un code à usage unique : envoyez html ou text au lieu d’un projectId, et le message part exactement tel quel.

Ce qui vous revient

Les notes, les clics et les achats apparaissent dans les Insights de l’e-mail comme pour toute campagne, et votre webhook transmet chacun à vos systèmes dès son arrivée. Une alerte de note basse vous prévient quand un client note mal une commande, pour que quelqu’un le contacte le jour même.

Pour commencer

Créez le reçu dans le studio avec une Note, créez une clé d’API dans Développeurs, et appelez POST /api/v1/send avec votre projectId et mergeData. Le démarrage rapide vous guide pour le premier appel.

Une séquence type de création et d'envoi

  1. 1

    Concevez le reçu dans le studio

    Créez-le comme un e-mail normal avec une Note, un Produit ou un Coupon, et des balises comme {{order_number}}.

  2. 2

    Créez une clé d’API

    Créez une clé d’API nommée dans Développeurs. Chaque appel l’envoie comme jeton Bearer.

  3. 3

    Appelez la Send API

    Votre backend envoie un POST à /api/v1/send avec le projectId de l’e-mail et un objet mergeData contenant les valeurs de cette commande.

  4. 4

    Lisez ce qui revient

    Les notes, les clics et les achats apparaissent dans les Insights de l’e-mail, et votre webhook transmet chacun dès son arrivée.

Questions fréquentes

Un e-mail envoyé par API peut-il porter les mêmes blocs interactifs qu’une campagne ?

Oui. Le mode modèle génère l’e-mail du studio que vous indiquez, avec tous ses blocs, exactement comme un envoi depuis le tableau de bord.

Comment les données de la commande arrivent-elles dans l’e-mail ?

Avec mergeData : un objet plat de 100 champs au maximum qui remplit les balises {{field}} de l’e-mail pour cet appel. Passez aussi un listId et, si le client est déjà un contact, l’e-mail lui est lié, donc sa note arrive dans son activité.

Quelle différence entre transactionnel et marketing ?

Le champ type choisit la liste de suppression vérifiée. Transactionnel, la valeur par défaut, atteint les clients désinscrits du marketing, puisqu’ils ont quand même besoin de leur reçu. Marketing se comporte comme une campagne. Les deux ignorent les adresses en rebond.

Quelles limites s’appliquent à la Send API ?

Chaque clé d’API a une limite par minute, votre offre inclut un nombre mensuel d’appels à la Send API (500 sur Free), et chaque envoi compte dans les e-mails mensuels de votre offre. Un en-tête Idempotency-Key fait renvoyer le premier résultat à un appel répété, donc chaque client reçoit un seul reçu.

Puis-je envoyer mon propre HTML par le même endpoint ?

Oui. Envoyez html ou text au lieu d’un projectId, et le message part tel quel. Cela convient à un code à usage unique ; le mode modèle est celui des blocs interactifs.

Construisez ceci dans le studio

Commencez avec le forfait gratuit : chaque bloc interactif et le moteur de repli complet sont inclus dans tous les forfaits.