Templates d’email avec variables

Mis à jour le

Un template évite de construire le HTML dans votre code. Vous l’écrivez une fois dans le tableau de bord, puis vous envoyez seulement les variables.

Créer un template

  1. Ouvrez Templates et créez un template.
  2. Renseignez le sujet, le corps HTML et, si vous voulez, une version texte.
  3. Testez le rendu en saisissant des variables d’exemple dans Variables d’aperçu (JSON).

Syntaxe

  • {{ prenom }} : insère la valeur (échappée dans le HTML).
  • {{ client.prenom }} : accède à un champ d’un objet.
  • {{ prenom | Bonjour }} : valeur par défaut si la variable est vide.
  • {{{ bloc_html }}} : insère du HTML tel quel, sans échappement.
Sujet : Votre commande {{ commande.numero }}
HTML  : <p>Bonjour {{ client.prenom | client }},</p>
        <p>Votre commande {{ commande.numero }} est expédiée.</p>

Envoyer avec un template

curl https://smapiz.com/v1/messages \
  -H "Authorization: Bearer smz_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "mailbox_id": "mbx_...",
    "to": "[email protected]",
    "template_id": "tpl_...",
    "variables": {
      "client": { "prenom": "Ada" },
      "commande": { "numero": "1042" }
    }
  }'

Si vous passez aussi subject, html ou text dans la requête, ils remplacent ceux du template.

Guide suivantClés API, permissions et équipe