Gehoste templates

Levenscyclus

Een template heeft een stabiel ID en een stabiele key, één bewerkbaar concept, nul of meer onveranderlijke gepubliceerde releases en een levenscyclus die actief of gearchiveerd is. Archiveren voorkomt nieuwe verzendingen op basis van de key, zonder historische releases of gebruiksgegevens te verwijderen.

Variabelen

Declareer variabelen met keys, types, of ze verplicht zijn en optionele standaardwaarden. Renderen mislukt met 422 als de aangeleverde data niet aan het gepubliceerde contract voldoet. Ingevoegde waarden worden afhankelijk van de context ge-escaped.

Optimistisch automatisch opslaan

Elk concept heeft een revisie. Stuur de huidige revisie mee naar PUT /templates/:id/draft. Heeft een andere bewerker eerder opgeslagen, dan geeft SendHQ 409 terug; laad opnieuw voordat je iets overschrijft.

Voorbeeld, test, publiceren

1. Render met representatieve voorbeelddata.
2. Los elke gevonden fout op.
3. Stuur een testsnapshot naar een adres dat je zelf beheert.
4. Publiceer het exacte concept als onveranderlijke release.

Verzenden op key

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

Een verzending met een gepersonaliseerde template vereist precies één To-ontvanger en geen Cc of Bcc. Gebruik het batch-endpoint voor individuele ontvangers.

Herkomst

Elke templateverzending legt de template, de release, de compilerversie en de hash van de gerenderde inhoud vast, zodat je een historisch bericht kunt herleiden tot de inhoud waaruit het is ontstaan.