Tovanix
Tovanix

Die SMTP-Aggregations-API verwenden

Mehrere Ihrer eigenen SMTP-Konten werden zu einem Versandweg gebündelt; die Plattform wechselt beim Versand zwischen ihnen:

  • Bei der ersten Nutzung wird automatisch die kostenlose Version aktiviert; Kontingent, Funktionen und Höchstzahlen hängen vom Tarif ab. Gewechselt wird mit „Tarif wechseln“, nicht genutzte Zeit wird zum ursprünglichen Preis angerechnet
  • Zuerst unter „SMTP-Konten“ ein Konto hinzufügen, dann unter „API-Schlüssel“ einen Schlüssel erstellen; Erstellen und Zurücksetzen erfordern eine Identitätsbestätigung, der Schlüssel wird nur einmal angezeigt
  • Drei Versandwege: online verfassen, Kampagnen und API-Aufrufe; Kampagnen führen Empfänger zusammen, entfernen Duplikate und überspringen die Abmeldeliste
  • Schlägt ein SMTP-Konto wegen eines Problems des Kontos selbst 3-mal hintereinander fehl, wechselt es zu „Fehler“; nach bestandener Prüfung durch die Plattform wird es automatisch wiederhergestellt
  • Häufige Fehler: 400 nach der message behandeln (Kontingent aufgebraucht, Empfänger als Rückläufer gemeldet und Ähnliches), 401 ungültiger Schlüssel, 403 eingeschränktes Konto, 429 zu viele Anfragen

Was dieser Dienst bietet

Die SMTP-Aggregations-API bündelt mehrere Ihrer eigenen SMTP-Versandkonten zu einem gemeinsamen Versandweg: Ihr System bindet die Plattform nur einmal an, und die Plattform wechselt beim Versand zwischen diesen Konten. Sie können direkt aus der Konsole oder per API aus Ihrem eigenen System versenden.

  • Sie eignet sich für Transaktions-E-Mails wie Registrierungscodes und Bestellbenachrichtigungen sowie für Massenversand an Kontaktgruppen.
  • Bei der ersten Nutzung wird automatisch die kostenlose Version aktiviert. Sobald Sie ein SMTP-Konto hinzugefügt und einen API-Schlüssel erstellt haben, können Sie versenden; brauchen Sie mehr Kontingent oder Funktionen, wechseln Sie den Tarif.
  • Sie finden den Dienst in der Konsole unter „SMTP-Aggregations-API“, aufgeteilt in die Seitengruppen „Versand“, „Integration“ und „Konfiguration“.

Zunächst einige Begriffe

Dieser Bereich hat viele Seiten. Wenn Sie diese Begriffe zuerst verstehen, landen Sie wesentlich seltener auf der falschen Seite.

  • Tarif — Legt fest, wie viele E-Mails Sie pro Tag und pro Monat senden können, welche Funktionen nutzbar sind (E-Mail-Vorlagen, Kontakte, Kampagnen, Webhook) und welche Höchstzahlen gelten; die Karten auf der Seite „Tarif kaufen“ führen das einzeln auf. Bei der ersten Nutzung wird automatisch die kostenlose Version aktiviert; nach Ablauf eines kostenpflichtigen Tarifs gilt wieder die kostenlose Version.
  • SMTP-Konto — Ihr eigenes SMTP-Versandkonto (bei einem E-Mail-Anbieter oder auf einem eigenen Server); die Plattform stellt keinen Versandweg bereit. Sie können mehrere Konten hinzufügen und für jedes eine Priorität und ein Tageslimit festlegen; die Plattform wechselt beim Versand zwischen ihnen.
  • API-Schlüssel — Die Zugangsdaten, mit denen Ihr System die Versandschnittstelle aufruft. Der API-Schlüssel bestimmt, wer aufruft; das SMTP-Konto bestimmt, über welches Postfach gesendet wird.
  • Versanddomain — Die Domain nach dem @ Ihrer Absenderadresse. Auf der Seite „Versanddomains“ prüfen Sie ihre SPF-, DKIM- und DMARC-Einträge; sind sie vollständig, landen E-Mails leichter im Posteingang.
  • Abmeldeliste — Adressen, die sich über einen Abmeldelink abgemeldet haben, sowie Adressen, die Ihr System über die Schnittstelle als Rückläufer oder Beschwerde gemeldet hat. Die Plattform überspringt diese Adressen automatisch; Sie müssen die Liste nicht von Hand pflegen.

Die erste E-Mail versenden

  • Tarif prüfen: Beim ersten Aufruf wird automatisch die kostenlose Version aktiviert. Unter „SMTP-Aggregations-API → Tarif kaufen“ sehen Sie Ihren aktuellen Tarif und die Kontingente aller Tarife; brauchen Sie mehr Kontingent oder Funktionen, abonnieren Sie eine höhere Stufe.
  • SMTP-Konto hinzufügen: Klicken Sie auf der Seite „SMTP-Konten“ auf „Konto hinzufügen“ und geben Sie Host, Port, Benutzername, Passwort und Absenderadresse ein. Wie viele Konten Sie hinzufügen können, hängt vom Tarif ab; bei mehreren Konten wechselt die Plattform automatisch zwischen ihnen.
  • API-Schlüssel erstellen: Klicken Sie auf der Seite „API-Schlüssel“ auf „API-Schlüssel erstellen“. Für Erstellen und Zurücksetzen müssen Sie Ihre Identität bestätigen: mit aktivierter Zwei-Faktor-Authentifizierung per Einmalcode, sonst per E-Mail-Code. Nach einer Bestätigung entfällt sie in derselben Anmeldesitzung 10 Minuten lang. Der Schlüssel wird nur einmal angezeigt; kopieren und speichern Sie ihn sofort. Pro Konto sind höchstens 50 Schlüssel möglich.
  • Eine Test-E-Mail versenden: Klicken Sie auf der Seite „SMTP-Konten“ auf „Testen“, um die Verbindung zu testen oder eine Test-E-Mail an Ihre eigene Adresse zu senden. Test-E-Mails verbrauchen kein Versandkontingent; Sie können also beliebig oft testen.

Haben Sie bereits einen kostenpflichtigen Tarif, wählen Sie auf der Seite „Tarif kaufen“ eine andere Stufe und klicken auf „Tarif wechseln“; der Wechsel gilt sofort. Die nicht genutzte Zeit des aktuellen Tarifs wird zum ursprünglichen Preis angerechnet, Sie zahlen nur die Differenz. Übersteigt die Anrechnung den Preis des neuen Tarifs, wird der Überschuss als zusätzliche Laufzeit gutgeschrieben und nicht auf das Guthaben erstattet. Das in diesem Monat bereits verbrauchte Kontingent wird in den neuen Tarif übernommen.

Nach dem Löschen eines API-Schlüssels schlagen alle Anfragen fehl, die ihn noch verwenden; auch beim Zurücksetzen wird der alte Schlüssel sofort ungültig. Verwendet ein Produktivsystem einen Schlüssel, richten Sie zuerst den neuen ein, bevor Sie den alten ändern.

Drei Versandmöglichkeiten

Ein Kontingent, drei Wege — wählen Sie passend zur Situation:

  • Online verfassen — Verfassen und versenden Sie E-Mails aus der Konsole. Geeignet für einmalige Mitteilungen und manuelles erneutes Versenden.
  • Kampagne — Wählen Sie eine Vorlage und Kontaktgruppen für den Massenversand mit Versandbegrenzung, Nachverfolgung und Zeitplanung. Das System führt die Kontakte zusammen, entfernt Duplikate und schließt Adressen auf der Abmeldeliste aus.
  • API-Aufruf — Ihr System ruft den Endpunkt direkt auf. Eine Anfrage kann mehrere Empfänger enthalten, jeweils mit eigenen Vorlagenvariablen.

Vorlagen und Variablen

Speichern Sie Inhalte in einer Vorlage und übergeben Sie beim Versand nur die Variablen. So bleiben Inhalte und Code getrennt.

  • Vorlagen werden auf der Seite Vorlagen verwaltet und beim Versand über ihre Kennung referenziert. Die Plattform ersetzt die Variablen.
  • Die Plattform erzeugt aus dem HTML eine reine Textversion, damit die E-Mail auch ohne HTML-Unterstützung lesbar bleibt.

Kontakte und Abmeldungen

Auf der Seite „Kontakte“ verwalten Sie Adressen und Gruppen, mit Import und Export als CSV; bei Kampagnen wählen Sie die Empfänger nach Gruppen aus.

  • Bei Auswahl mehrerer Gruppen werden diese zusammengeführt und Duplikate entfernt, damit niemand dieselbe E-Mail zweimal erhält.
  • Beim CSV-Import werden bereits abgemeldete Adressen automatisch übersprungen.
  • Der Abmeldelink führt zu einer Bestätigungsseite. Nach der Bestätigung wird die Adresse in die Abmeldeliste aufgenommen und der Kontakt entsprechend markiert.

Die Abmeldeliste gilt automatisch. An Adressen, die als Rückläufer oder Beschwerde gemeldet wurden, wird überhaupt keine E-Mail mehr zugestellt. Adressen, die sich über einen Abmeldelink abgemeldet haben, werden nur bei Kampagnen und Massenversand übersprungen; einzelne E-Mails wie Bestätigungscodes werden weiterhin zugestellt.

Versanddomains

Fügen Sie auf der Seite „Versanddomains“ die Domain hinzu, über die Sie senden (den Teil nach dem @ Ihrer Absenderadresse); optional können Sie den DKIM-Selektor angeben (erhalten Sie von Ihrem E-Mail-Anbieter). Die Plattform prüft die SPF-, DKIM- und DMARC-Einträge und zeigt empfohlene DNS-Einträge sowie den Zustand an. Sind die Einträge vollständig, landen E-Mails leichter im Posteingang. Dieser Schritt ist keine Voraussetzung für den Versand; wie viele Domains Sie hinzufügen können, hängt vom Tarif ab.

Webhooks und Ereignisse

Um den Status jeder Nachricht zu erfahren, richten Sie einen Webhook ein. Die Plattform sendet dann Zustellereignisse an Ihren Dienst.

  • Die Ereignisse umfassen den Zustellvorgang und dessen Ergebnis sowie beispielsweise die Abmeldung eines Empfängers oder den Abschluss einer Kampagne.
  • Callbacks sind signiert. Ihr Server muss die Signatur prüfen, bevor er dem Inhalt vertraut. Diese Prüfung bildet die Sicherheitsgrenze und darf nicht übersprungen werden.

Häufige Fehler und Lösungen

Schlägt ein Aufruf fehl, prüfen Sie zuerst den HTTP-Statuscode und die message in der Antwort und gehen dann nach der folgenden Tabelle vor.

  • Antwort 400 — Die Anfrage wurde abgelehnt: Kontingent aufgebraucht, Empfänger bereits als Rückläufer oder Beschwerde gemeldet, kein nutzbares SMTP-Konto, fehlerhafte Parameter und Ähnliches — Gehen Sie nach der message vor. Ist das Kontingent aufgebraucht, warten Sie auf das Zurücksetzen (das Tageskontingent wird um 0 Uhr in der Zeitzone Ihres Kontos zurückgesetzt, die Zeitzone können Sie in den Kontoeinstellungen ändern; das Monatskontingent zu Monatsbeginn) oder wechseln Sie zu einem höheren Tarif. Meldet die Antwort, dass kein nutzbares SMTP-Konto vorhanden ist, prüfen Sie den Status auf der Seite „SMTP-Konten“.
  • Antwort 401 — Kein API-Schlüssel mitgesendet, oder der Schlüssel ist ungültig, deaktiviert, gelöscht oder zurückgesetzt — Prüfen Sie den Status auf der Seite „API-Schlüssel“ und ersetzen Sie den Schlüssel in Ihrem System durch den aktuell gültigen.
  • Antwort 403 — Das Konto ist gesperrt oder eingeschränkt — Eingeschränkte Konten (Fehlercode 4031) können weiterhin Abfrageschnittstellen aufrufen, der Versand wird jedoch abgelehnt. Wenden Sie sich bitte an den Support.
  • Antwort 429 — Zu viele Anfragen: pro API-Schlüssel höchstens 20 pro Sekunde, pro Konto insgesamt höchstens 60 pro Sekunde — Warten Sie gemäß dem Antwort-Header Retry-After und senden Sie dann erneut. Wenn Sie an viele Empfänger senden, nutzen Sie eine Anfrage mit mehreren Empfängern oder eine Kampagne, statt in schneller Folge einzeln aufzurufen.
  • E-Mail wird versendet, landet aber im Spam — Versanddomain nicht eingerichtet oder Inhalt löst Filter aus — Prüfen Sie auf der Seite „Versanddomains“ SPF, DKIM und DMARC, ergänzen Sie die DNS-Einträge gemäß den Empfehlungen und prüfen Sie dann den Inhalt. Vor einer echten Kampagne können Sie mit der „Zustellprobe“ alles einmal durchprüfen.

Schlägt der Versand über ein SMTP-Konto wegen eines Problems des Kontos selbst, etwa fehlgeschlagener Anmeldung oder fehlender Verbindung zum Server, dreimal hintereinander fehl, wechselt sein Status zu „Fehler“, und es wird beim Versand nicht mehr verwendet. Die Plattform prüft solche Konten regelmäßig automatisch und stellt sie nach bestandener Prüfung wieder her. Sie können auf der Seite „SMTP-Konten“ auch selbst die Verbindung testen oder eine Test-E-Mail senden; bei Erfolg ist das Konto wiederhergestellt. Alternativ korrigieren Sie die Verbindungsdaten oder aktivieren es manuell.

Häufig gestellte Fragen

Alles ist eingerichtet. Warum kann ich trotzdem nicht senden?

Prüfen Sie der Reihe nach: Gibt es unter „SMTP-Konten“ ein aktiviertes Konto (Konten mit dem Status „Fehler“ werden nicht zum Versand verwendet)? Ist der verwendete API-Schlüssel der aktuell gültige? Ist das Tages- oder Monatskontingent aufgebraucht? Die message in der Antwort der Schnittstelle nennt den konkreten Grund.

Verbrauchen Test-E-Mails Kontingent?

Nein. Testversand über die Seite „SMTP-Konten“ zählt nicht zum Versandkontingent; während der Einrichtung können Sie beliebig oft testen.

Was passiert nach Ablauf eines kostenpflichtigen Tarifs?

Nach Ablauf gelten für Ihr Konto wieder Kontingent und Funktionen der kostenlosen Version. Möchten Sie den Tarif weiter nutzen, klicken Sie vor Ablauf auf der Seite „Tarif kaufen“ auf „Verlängern“ oder abonnieren Sie nach Ablauf erneut.

Verwandte Seiten: Hilfezentrum · Anleitungen und häufige Fragen · SMTP-Aggregations-API · API-Dokumentation

Wird geladen…