❗️ Wichtig

Bitte beachten Sie: Dieser Artikel verweist auf die veraltete Funktion API v2 sowie veraltete Sprache in den Vorlagen. Diese Informationen können zwar dazu dienen, vorhandene Vorlagen und API-Integrationen zu bearbeiten, sollten jedoch nicht zum Erstellen neuer Vorlagen oder Integrationen verwendet werden. Sollten Sie Hilfe beim Erstellen und Anpassen Ihrer Vorlagen oder deren Versendung über die aktuelle API (v3) benötigen, nutzen Sie bitte diesen Artikel als Informationsquelle.

Diese API bietet die Möglichkeit, auf Sendinblue erstellte Templates (transaktionale E-Mails) über das Sendinblue SMTP zu versenden. Die API unterstützt nur das POST-Verfahren. Folgende Felder müssen bei API-Aufrufen gesendet werden:

Einstellungen	Erforderlich	Anforderungen	Beschreibung
User	Ja	Benutzername	Der Benutzername befindet sich auf der Seite „Einstellungen“.
Key	Ja	API-Schlüssel	Der API-Schlüssel befindet sich auf der Seite „Einstellungen“.
Templateid	Ja	Bitte gültige Kampagnen-ID vom Typ Template angeben.	Muss die ID einer Kampagne vom Typ „Template“ sein.
To	Ja	Mindestens ein Empfänger	Muss einen oder mehrere Empfänger (durch „\|“ getrennt) enthalten. Muss eine gültige E-Mail-ID sein.
Cc	Nein	Empfänger erhält eine Kopie	Falls angegeben, muss es sich um eine gültige E-Mail-ID handeln.
Bcc	Nein	Empfänger erhält eine Kopie	Falls angegeben, muss es sich um eine gültige E-Mail-ID handeln.
Attr_1….n	Nein	Attribute müssen im JSON-Format angegeben werden. Zum Beispiel: `{"attr1":"value","attr2":"value"}`	Im Template muss dieses Attribut in Großbuchstaben zwischen „%%“ und ohne Leerzeichen angegeben werden (Sonderzeichen sind zu vermeiden). Wenn dieser Attributwert in der Anfrage angegeben wird, wird das Attribut in der E-Mail durch diesen Wert ersetzt. Wenn das Attribut nicht gefunden wird, wird nichts ersetzt. Wenn im Template z. B. %PASS% gefunden wird, der Wert von PASS jedoch nicht in der Anfrage angegeben ist, findet keine Ersetzung statt. Solche Variablen können auch im Betreff vorkommen, sie werden ebenfalls beim Versand der E-Mail ersetzt.

Beispiel

Ihnen stehen zwei Optionen zur Verwaltung von Kontaktattributen zur Verfügung:

Option Nr. 1: Durch einen festen Wert (z. B. Name und Vorname), der in der Sendinblue-Datenbank gespeichert ist
Option Nr. 2: Durch eine dynamische Variable (z. B. den Auftragswert einer Bestellung oder eine Rechnungsnummer), die bei einer Transaktion generiert und über die API übermittelt wird

Wenn es sich um ein festes Attribut handelt, das in der Datenbank von Sendinblue vorhanden ist, und Sie Ihre Templates mit diesem Kontaktattribut-Typ anpassen möchten, muss der Name des Attributs in {} gesetzt werden.

Z. B.: Guten Tag, {FIRSTNAME}

Weitere Informationen finden Sie in diesem Tutorial. Sie können sogar noch einen Schritt weiter gehen und Bedingungen verwenden.

Wenn es sich bei dem Attribut um einen dynamischen Wert handelt, der über die API übermittelt wird, muss das Attribut zwischen %% gesetzt werden.

Z. B.: Auftragswert: %ORDER_AMOUNT%

Sie können beide Attributtypen in einem Template verwenden, um es zu personalisieren, wie beispielsweise in diesem Fall:

Wenn im Template steht Guten Tag %LNAME% %FNAME%, diese E-Mail wird Ihnen über das Sendinblue SMTP gesendet, um das von Ihnen erstellte Template zu testen. Mit freundlichen Grüßen Wird die E-Mail, die in Ihrem Posteingang (ihreemail.email.com) ankommt, wie folgt angezeigt: Guten Tag Schmidt Hans,Diese E-Mail wird Ihnen über das Sendinblue SMTP gesendet, um das von Ihnen erstellte Template zu testen.Mit freundlichen Grüßen.

🤔 Sie haben eine Frage?

Wenden Sie sich bei Fragen an unser Support-Team: Erstellen Sie einfach ein Ticket über Ihr Konto. Wenn Sie noch kein Konto haben, können Sie uns hier kontaktieren.