Senden

Gehostete Templates

Typisierte Entwürfe anlegen, die exakte Ausgabe als Vorschau ansehen, unveränderliche Releases veröffentlichen und die Herkunft jedes Versands nachvollziehen.

Lebenszyklus

Ein Template hat eine stabile ID und einen stabilen Schlüssel, einen bearbeitbaren Entwurf, null oder mehr unveränderliche veröffentlichte Releases und einen Lebenszyklus mit den Zuständen aktiv oder archiviert. Das Archivieren verhindert neue Sendungen per Schlüssel, ohne historische Releases oder Nutzungsdaten zu löschen.

Variablen

Deklarieren Sie Variablen mit Schlüssel, Typ, Pflichtstatus und optionalem Standardwert. Das Rendern schlägt mit 422 fehl, wenn die übergebenen Daten den veröffentlichten Vertrag nicht erfüllen. Eingefügte Werte werden kontextabhängig escaped.

Optimistisches automatisches Speichern

Jeder Entwurf trägt eine Revision. Senden Sie die aktuelle Revision an PUT /templates/:id/draft. Hat ein anderer Bearbeiter zuerst gespeichert, gibt SendHQ 409 zurück; laden Sie neu, bevor Sie überschreiben.

Vorschau, Test, Veröffentlichung

  1. Mit repräsentativen Beispieldaten rendern.
  2. Jeden gemeldeten Fehler beheben.
  3. Einen Test-Snapshot an eine Adresse senden, die Sie kontrollieren.
  4. Den exakten Entwurf als unveränderliches Release veröffentlichen.

Per Schlüssel senden

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

Ein personalisierter Template-Versand erfordert genau einen Empfänger in To und kein Cc oder Bcc. Nutzen Sie für individualisierte Empfänger den Batch-Endpunkt.

Herkunftsnachweis

Jeder Template-Versand erfasst Template, Release, Compiler-Version und den Hash des gerenderten Inhalts, sodass sich eine historische Nachricht auf den Inhalt zurückführen lässt, aus dem sie entstanden ist.