Modèles hébergés

Cycle de vie

Un modèle possède un identifiant et une clé stables, un brouillon modifiable, zéro ou plusieurs versions publiées immuables, et un cycle de vie actif ou archivé. L’archivage empêche les nouveaux envois par clé sans supprimer les versions historiques ni l’historique d’utilisation.

Variables

Déclarez les variables avec une clé, un type, un caractère obligatoire ou non, et une valeur par défaut facultative. Le rendu échoue avec une 422 lorsque les données fournies ne respectent pas le contrat publié. Les valeurs insérées sont échappées selon leur contexte.

Enregistrement automatique optimiste

Chaque brouillon porte une révision. Envoyez la révision actuelle à PUT /templates/:id/draft. Si un autre éditeur a enregistré avant vous, SendHQ renvoie 409 ; rechargez avant d’écraser.

Prévisualiser, tester, publier

1. Effectuez le rendu avec des données d’exemple représentatives.
2. Corrigez chaque erreur signalée.
3. Envoyez un instantané de test à une adresse que vous contrôlez.
4. Publiez le brouillon tel quel comme version immuable.

Envoyer par clé

{
  "from": "hello@example.com",
  "to": [
    "customer@example.net"
  ],
  "template": {
    "key": "account-welcome",
    "data": {
      "first_name": "Asha"
    }
  }
}

Un envoi de modèle personnalisé exige exactement un destinataire To, sans Cc ni Bcc. Utilisez l’endpoint d’envoi par lot pour des destinataires individualisés.

Traçabilité

Chaque envoi par modèle enregistre le modèle, la version publiée, la version du compilateur et l’empreinte du contenu rendu, afin qu’un message historique puisse être rattaché au contenu qui l’a produit.