Wenn sich eine Anwendung zwar erfolgreich mit Loops SMTP verbindet, die erwartete E-Mail aber ausbleibt, sollten Sie vor jeder Designanpassung zunächst die Nutzlast (Payload) prüfen. Loops setzt bei SMTP auf einen templatebasierten Ansatz: Der Message Body übergibt die Kennung einer Transaktions-E-Mail zusammen mit den zugehörigen Daten. Es handelt sich nicht um einen klassischen SMTP-Relay, an den beliebiger HTML-Code unverändert übergeben werden kann.
Nutzen Sie Migma, um das sichtbare Mailing zu gestalten und freizugeben. Das für den Versand zuständige Team muss anschließend sicherstellen, dass die Implementierung die von Loops geforderte Payload korrekt abbildet. Wenn freigegebene Vorlage und Transportnachweise zentral dokumentiert sind, lassen sich Verbindungsprobleme isolieren, ohne voreilig das Design zu überarbeiten.
Dieser Leitfaden stammt von Migma und beschreibt einen strukturierten Review-Prozess, keinen nativen SMTP-Connector zwischen Migma und Loops. Die offiziellen SMTP-Vorgaben von Loops wurden am 20. Oktober 2026 überprüft.
Botschaft und Übertragungsformat trennen
Die Designreferenz definiert, was Empfänger sehen und lesen sollen. Das Übertragungsformat bestimmt, wie der Versanddienstleister instruiert wird, diese Nachricht zu generieren. Beides hängt zusammen, betrifft aber technisch getrennte Ebenen.
Laut Loops-SMTP-Dokumentation wird zunächst eine Transaktions-E-Mail direkt in Loops angelegt. Anschließend übergibt die Anwendung einen serialisierten, API-ähnlichen Body als String, der die Transaktions-ID (transactionalId), den Empfänger und die Variablen (dataVariables) enthält. Loops führt Vorlage und Daten zusammen und verschickt die fertige E-Mail.
Daraus folgt: Sendekomponenten, die ausschließlich reines HTML ausgeben, sind mit diesem Endpunkt nicht ohne Weiteres kompatibel. Ein funktionierender SMTP-Handshake über Host und Zugangsdaten belegt noch nicht, dass die Komponente den erforderlichen strukturierten Body erzeugen kann. Ein erfolgreicher Verbindungsaufbau ist daher nicht mit einer funktionierenden Design-Übergabe gleichzusetzen.
Freigegebene Referenz in Migma sichern
Sichern Sie vor der Fehlersuche Textfassung, visuelle Hierarchie, Verlinkungen, Branding und die Definition aller Variablen in Migma. Prüfen Sie die Markeneinstellungen und Referenzen, damit die abgenommene Version klar definiert und konsistent bleibt.
Bei einer typischen Bestätigungs-E-Mail enthält die Referenz beispielsweise eine kurze Erklärung, einen primären Bestätigungs-CTA und einen Support-Link. Die tatsächliche Bestätigungs-URL wird erst zum Sendezeitpunkt dynamisch eingefügt. Das Template sollte zu keinem Zeitpunkt echte, personenbezogene Links als Testdaten enthalten.
Dokumentieren Sie exakt, welche Inhalte statisch sind und welche Werte dynamisch aus der Anwendung stammen. Definieren Sie für den primären Call-to-Action nicht nur die Optik, sondern auch das erwartete funktionale Ziel. Wird das Layout als Provider-Template in Loops nachgebaut, gleichen Sie diese Vorlage direkt mit der freigegebenen Migma-Referenz ab.
Die Export-Dokumentation von Migma beschreibt die unterstützen Übergabeformate. Die exportierte HTML-Datei lässt sich nicht direkt in einen Loops-SMTP-Request einfügen, und Migma konvertiert Exporte nicht automatisch in Loops-Templates.
Vier Kompatibilitätsfragen an das Entwicklerteam
Anhand der aktuellen Integrationsdokumentation und eines kontrollierten Testfalls sollten vorab folgende Punkte geklärt werden:
- Welche Transaktionsvorlage in Loops ist für diese E-Mail vorgesehen?
- Kann die sendende Anwendung den von Loops geforderten strukturierten Body generieren?
- Welche Variablen erwartet das gewählte Template, und woher stammen die validierten Werte?
- Welche Rückmeldungen belegen die Annahme durch den Provider sowie den finalen Zustellstatus?
Diese Fragen klären Ursachen schneller als wiederholte Port-Wechsel. Kann das Quellsystem das geforderte Format nicht ausgeben, muss der Integrationspfad angepasst werden. Weichen Sie Validierungen nicht auf und weichen Sie nicht auf Notlösungen aus, nur weil der reine Verbindungsaufbau funktioniert.
Die Protokoll-Übersicht von Loops behandelt Host, Port und Verschlüsselung als separate Systemparameter. Übernehmen Sie die Angaben des Anbieters stets als zusammenhängendes Setup und kombinieren Sie nicht Port-Angaben und TLS-Modi aus unterschiedlichen Anleitungen.
Fehler an der richtigen Schnittstelle eingrenzen
Ein Verbindungs-Timeout unterscheidet sich grundlegend von einer abgewiesenen Nutzlast – und eine vom Provider angenommene Nachricht, die später bounct, erfordert wiederum andere Schritte. Ermitteln Sie die letzte nachweisbare Station im Prozess, bevor Sie das Mailing-Design infrage stellen.
| Letzter bestätigter Schritt | Nächster Prüfpunkt | Relevante Frage zum Design |
|---|---|---|
| Anwendung hat Request generiert | Verbindung zum Provider und Rückmeldung der Übergabe | Wurden die richtige Vorlage und die passenden Daten ausgewählt? |
| Provider hat Request akzeptiert | Message-ID des Providers und nachgelagerte Event-Logs | Verweist der angenommene Request auf die freigegebene Vorlage? |
| Testnachricht im Postfach eingetroffen | Ausgefüllte Inhalte, Links und Rendering | Entspricht das finale Mailing exakt der Referenz? |
Diese Übersicht dient als strukturierte Orientierung bei der Fehlersuche. Sie ersetzt weder anbieterspezifische Statuscodes noch undokumentierte Fallbacks. Maßgeblich für technische Entscheidungen sind die tatsächlichen Logs von Anwendung und Versanddienstleister.
Gewähltes Template und übergebene Variablen abgleichen
Stimmt das Format des Requests, vergleichen Sie das Loops-Template mit der freigegebenen Migma-Vorlage. Prüfen Sie Textanfang, Button-Beschriftungen, statische Support-Links und dynamische Felder. Auch eine formal valide ID kann auf die falsche Vorlage verweisen.
Testen Sie den Ablauf mit einem freigegebenen Datensatz. Stellen Sie sicher, dass die Ziel-URL zur korrekten Umgebung (Staging oder Produktion) gehört und der umgebende Text die Aktion zutreffend beschreibt. Bestätigungslinks, Passwort-Resets oder Marketing-URLs lassen sich nicht beliebig austauschen, nur weil es sich jeweils um URLs handelt.
Fehlen Werte im Datensatz, prüfen Sie das in der Anwendung und im Template vorgesehene Verhalten. Definieren Sie keine pauschalen Ausweichwerte ohne genaue Abstimmung. Zugangsdaten und temporäre Sicherheits-Links gehören grundsätzlich nicht in geteilte Debugging-Notizen.
Finale Abnahme des Mailings
Führen Sie vorab den Email Preflight von Migma für die dort abgedeckten Qualitätsprüfungen durch. Testen Sie das Mailing anschließend über die reale Versandstrecke anhand Ihres definierten QS-Prozesses. Der Preflight-Check prüft das Design, kann jedoch nicht verifizieren, ob die sendende Anwendung die korrekte Loops-Template-ID ansteuert.
Halten Sie Migma-Version, Loops-Template-ID, Variablen-Mapping, Übergabequittung und das Abnahmeprotokoll der Test-E-Mail zusammen fest. Wenn Payload und Zustellweg stimmen, aber Abweichungen im Layout auftreten, korrigieren Sie gezielt das zuständige Template und wiederholen Sie die Prüfung.
Beginnen Sie mit einem einzelnen E-Mail-Typ. Sobald Design, dynamische Daten und Provider-Übergabe zuverlässig ineinandergreifen, wenden Sie dieselbe Methodik auf die weiteren Transaktions-E-Mails an. Das liefert verlässlichere Ergebnisse als eine funktionierende SMTP-Verbindung ohne inhaltliche End-to-End-Prüfung.
Häufig gestellte Fragen
Kann Loops über SMTP beliebigen HTML-Code direkt versenden?
Nein. Loops erwartet im SMTP-Body ein strukturiertes Format, das eine Transaktionsvorlage referenziert und Empfängerdaten sowie Variablen übergibt. Prüfen Sie, ob Ihre Anwendung dieses Format unterstützt, anstatt von einem standardmäßigen HTML-Relay auszugehen.
Reicht ein erfolgreicher SMTP-Verbindungsaufbau als Funktionsnachweis aus?
Nein. Prüfen Sie zusätzlich die übergebene Payload, die gewählte Vorlagen-ID, die Datenvariablen, die Bestätigung des Providers und die tatsächlich zugestellte E-Mail. Verbindung, Annahme und sichtbares Ergebnis sind separate Schritte.
Wandelt Migma einen HTML-Export automatisch in eine Loops-SMTP-Payload um?
Nein, das geschieht nicht automatisch. Migma dient als verbindliche Designreferenz. Das sendende System muss die Payload gemäß der aktuellen Loops-Dokumentation eigenständig aufbauen und anbinden.
Was gehört in ein vollständiges Übergabeprotokoll?
Dokumentieren Sie die freigegebene Migma-Version, die Transaktions-ID des Loops-Templates, das Variablen-Mapping, die Bestätigung der Provider-Übergabe und das Prüfprotokoll der empfangenen Test-E-Mail. Zugangsdaten und temporäre Authentifizierungslinks dürfen nicht in geteilten Dokumenten stehen.