Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

Vorlagen

Wiederverwendbarer E-Mail-Inhalt für Newsletter-Versände, verwaltet im Dashboard oder per API.

Eine Vorlage ist wiederverwendbarer E-Mail-Inhalt: ein Betreff, HTML und ein optionaler Nur-Text-Teil. Halten Sie eine für Ihren nächsten Newsletter-Versand bereit. Im Dashboard können Sie unter Vorlagen eine im Block-Editor bauen oder das HTML selbst schreiben.

Wenn Sie im Editor des Newsletter-Versands eine Vorlage wählen, wird ihr Inhalt als Ausgangspunkt hineinkopiert. Spätere Änderungen an der Vorlage oder ihr Löschen ändern keine Newsletter-Versände, die Sie bereits erstellt haben.

Platzhalter

Vorlagen können Werte pro Kontakt enthalten:

<p>Hi {{{FIRST_NAME|there}}},</p>
  • {{{FIRST_NAME}}}, {{{LAST_NAME}}} und {{{EMAIL}}} sind eingebaut. Jeder andere Name liest eine Kontakteigenschaft dieses Namens.
  • {{{NAME|fallback}}} verwendet den Ersatztext, wenn der Kontakt keinen Wert hat.
  • {{{UNSUBSCRIBE_URL}}} wird zum eigenen Abmeldelink jedes Empfängers. Siehe Abmeldungen.

Block-Editor und HTML

  • Eine im Block-Editor erstellte Vorlage lässt sich mit Als HTML bearbeiten auf HTML umstellen. Sie erhalten eine Kopie oder ändern sie an Ort und Stelle. Bis Sie speichern, stellt Zurück zu Blöcken die Blöcke wieder her.
  • Eine Vorlage, die per API mit html angelegt wurde, öffnet sich im HTML-Modus, und Ihr HTML bleibt genau so erhalten, wie Sie es geschrieben haben. Ob Sie sie in Blöcke umwandeln, als Kopie oder an Ort und Stelle, entscheiden Sie, wobei tabellenbasierte Layouts eingeebnet werden.
  • Im HTML-Modus folgt ein aus dem HTML erzeugter Nur-Text-Teil weiterhin Ihren Änderungen. Ein Nur-Text-Teil, den Sie über die API setzen, wird so gesendet, wie er gespeichert ist.

Veröffentlichen und Versionen

Über die API ist jedes Speichern live: Jedes POST /templates und PATCH /templates/{id} veröffentlicht eine neue Version, daher lautet status immer published, und POST /templates/{id}/publish tut nichts und ist erfolgreich. Im Dashboard führt der Editor eine Arbeitskopie: Ihre Änderungen bleiben ein Entwurf, bis Sie Veröffentlichen wählen, wodurch eine neue Version veröffentlicht wird. Der Versionsverlauf listet jede veröffentlichte Version auf, und Als Entwurf wiederherstellen holt eine davon als Arbeitskopie zurück.

API

Die SDKs rufen die Vorlagen-Endpunkte als templates.* auf.

curl -X POST https://api.billionsend.com/templates \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome",
    "subject": "Welcome to Acme",
    "html": "<p>Hi {{{FIRST_NAME|there}}}</p>",
    "alias": "welcome"
  }'
  • POST /templates akzeptiert name, html und optional subject, text und alias.
  • GET /templates listet Vorlagen auf, die neuesten zuerst. GET /templates/{id} liefert den vollständigen Inhalt.
  • PATCH /templates/{id} ändert beliebige Felder. Ein leerer String oder null leert subject oder text. Das Schreiben von html oder text macht aus einer Block-Editor-Vorlage eine HTML-Vorlage.
  • DELETE /templates/{id} löscht sie.
  • POST /templates/{id}/duplicate erstellt eine Kopie mit dem Namen <name> (copy), ohne den Alias.

Ein alias besteht aus Buchstaben, Ziffern, ., _ und -, höchstens 100 Zeichen, und ist in Ihrem Team eindeutig. Jede der obigen Routen akzeptiert den Alias anstelle der ID. Ein bereits vergebener Alias antwortet mit 409. Ein Alias, der wie eine UUID aussieht, ist nicht erlaubt.

Nicht unterstützt

  • from, reply_to und variables bei einer Vorlage antworten mit 422. Legen Sie Absender und Reply-To im Newsletter-Versand fest und verwenden Sie Platzhalter direkt: Kontakteigenschaften müssen nicht deklariert werden.
  • Eine Vorlagen-ID lässt sich nicht mit POST /emails oder POST /broadcasts senden. Senden Sie html oder text selbst. Die Vorlagenauswahl im Editor des Newsletter-Versands kopiert den Inhalt hinein.

War diese Seite hilfreich?