Postmark Integration

Postmark Integration verbindet native PrestaShop Mails mit Postmark SMTP und speichert Bounce und SpamComplaint für den ausgewählten Shop. Die Anleitung beschreibt Servertoken, manuelle DNS-Einrichtung, Versand und Ereignisbericht.

Schnellstart

1. Laden Sie das ZIP im Modulmanager hoch und installieren Sie das Modul.
2. Öffnen Sie die Konfiguration für einen einzelnen Shop. Gruppen- und Alle-Shops-Kontexte werden abgewiesen.
3. Bereiten Sie einen vorhandenen Postmark-Server mit aktiviertem SMTP und aktivem transaktionalem outbound-Stream vor. Richten Sie den Absender in Postmark für die Versandadresse des Shops ein.
4. Veröffentlichen Sie die von Postmark gelieferten DNS-Einträge bei Ihrem DNS-Anbieter, auch bei Cloudflare. Das Modul veröffentlicht keine DNS-Einträge.
5. Speichern Sie den Servertoken, prüfen Sie die Verbindung und aktivieren Sie SMTP. Richten Sie den Bounce-Webhook separat ein; er ist keine Voraussetzung für die Aktivierung.
6. Starten Sie die Testmail und prüfen Sie Ergebnis und Postfach des Mitarbeiters, der den Test auslöst, getrennt.
7. Testen Sie zusätzlich eine übliche Shopbenachrichtigung mit ihrer Vorlage und dem vorgesehenen Absender.

Funktionen

• Einfacher Einstieg. Ein Postmark-Servertoken verbindet einen vorhandenen Versandserver.
• DNS-Prüfung. DNS-Abfragen prüfen die DMARC-Richtlinie der Absenderdomain und den Return-Path-CNAME.
• Manuelle DNS möglich. Übertragen Sie die Domaineinträge aus Postmark an Ihren DNS-Anbieter.
• Bestehende Shopmails. PrestaShop bereitet Bestellmails und Kontonachrichten weiter vor, Postmark übernimmt den Versand.
• Fehler im Blick. Rückläufer und Spambeschwerden erscheinen im Backoffice.
• Test und Kontrolle. Eine native Testmail und die Wiederherstellung verwalteter Mailwerte begleiten die Umstellung.

Konfigurationsoptionen

Kontotoken und Absender

Die Verbindung benötigt den Server-API-Token von Postmark aus einem vorhandenen Server. Die Absenderdomain für DNS-Prüfungen stammt aus dem wirksamen PS_SHOP_EMAIL des ausgewählten Shops. Für shop.example.com mit Versandadresse bestellung@example.com lautet sie example.com. Eine gültige Versandadresse gehört daher zur Einrichtung.

Tragen Sie den Servertoken selbst ein. Die Authentifizierung der Rückmeldungen wird beim Einrichten des Webhooks erzeugt. Beim Ersetzen oder Löschen des Tokens werden zunächst die noch vom Modul verwalteten Mailwerte wiederhergestellt sowie Prüf- und Webhook-Status zurückgesetzt. Prüfen und aktivieren Sie die Verbindung anschließend erneut. Eine Änderung der Shop-Absenderdomain deaktiviert SMTP nicht automatisch.

DNS und Versandkontrolle

DNS-Einträge veröffentlichen Sie bei jedem Anbieter manuell, auch bei Cloudflare. Holen Sie die Einträge für Ihre Absenderdomain aus Postmark und tragen Sie sie bei Ihrem DNS-Anbieter ein. Das Modul besitzt keine Cloudflare-Verbindung und bearbeitet keine DNS-Einträge.

Die Verbindungsprüfung kontrolliert SMTP und den aktiven transaktionalen outbound-Stream. DNS-Abfragen lesen DMARC und Return-Path, nicht den Domain-Prüfstatus in Postmark. Bei DMARC quarantine oder reject ohne passenden Return-Path müssen Sie vor der Aktivierung die Domainprüfung in Postmark selbst bestätigen. Der Webhook wird separat eingerichtet. Die Deaktivierung stellt verwaltete Werte wieder her. Der Ereignisbericht enthält aktuelle Zeilen und gespeicherte Gesamtzahlen des ausgewählten Shops.

Anpassungsbeispiele

DNS bei einem anderen Anbieter

Dieses Muster zeigt die Form der beiden Einträge. Die echten Angaben erhalten Sie in Ihrer Domaineinrichtung bei Postmark:

TXT   <Selektor>._domainkey.example.com   <DKIM-Wert von Postmark>
CNAME pm-bounces.example.com             pm.mtasv.net

Der Selektor und DKIM-Wert sind Platzhalter. Je nach DNS-Editor ist der volle Name oder nur der Teil vor der Zone einzugeben. Der Return-Path CNAME bleibt DNS only, ohne Proxy. Das Muster ersetzt keine SPF-/DMARC-Richtlinie; diese werden nicht vom Modul erzeugt.

Vorlagen beibehalten

Bestell- und Kontovorlagen bleiben in PrestaShop. Sie müssen den Inhalt nicht als Postmark Vorlage neu anlegen. Module mit eigenem unabhängigem Transport werden durch die Änderung der nativen Einstellungen nicht umgestellt.

Eigene Änderungen behalten

Die Deaktivierung stellt nur Werte wieder her, die noch den geschriebenen Modulwerten entsprechen. Ihre späteren Änderungen bleiben bestehen. Bei der nächsten Aktivierung wird die dann aktuelle Konfiguration als Ausgangspunkt gespeichert.

Installation

Voraussetzungen

• Allgemeiner Bereich: PS 1.6 – 9.x. Exakt deklariertes Minimum: PrestaShop 1.6.1.0.
• PHP ab 7.1, passend zur eingesetzten PrestaShop Version.
• PHP cURL und JSON. API-Aufrufe haben 5 Sekunden Verbindungs- und 20 Sekunden Gesamtzeitlimit.
• Postmark-Konto, vorhandener Server mit SMTP und aktivem transaktionalem outbound-Stream sowie dessen Servertoken. Der Dienst hat eigene kostenpflichtige Tarife; das Modul ist kostenlos.
• Gültige Shop-Versandadresse, DNS-Zugriff und öffentlich erreichbare HTTPS-Rückmeldeadresse.
• Veröffentlichen Sie Absendereinträge bei Ihrem DNS-Anbieter manuell, auch bei Cloudflare.

Lesen erfordert Shopzugriff und Ansichtsrecht, Ändern zusätzlich Bearbeitungsrecht. Zugangsdaten gehören nicht in Screenshots. Bei mehreren Shops ist jeder betroffene Shop gezielt zu konfigurieren und zu prüfen.

Funktionsweise

Servertoken speichern, Server und outbound-Stream prüfen, natives SMTP aktivieren, Webhook einrichten und Testmail senden sind separate Aktionen. Das Modul verwendet den nativen Versand des Shops und seinen authentifizierten Ereignisempfang.

Wie hilft Postmark Integration bei fehlenden Bestellmails?

Postmark Integration verbindet die bereits vom Shop erstellten Nachrichten mit dem Transaktionsmaildienst von Postmark. Richten Sie den Absender selbst in Postmark ein und verbinden Sie den Shop anschließend mit dem vorhandenen Servertoken. Ihre bisherigen PrestaShop Inhalte bleiben bestehen. Meldet Postmark einen Rückläufer oder eine Spambeschwerde, steht Ihrem Team im Backoffice ein konkreter Hinweis zur Verfügung.

Wie richtet das Modul die Absenderdomain bei Cloudflare ein?

Veröffentlichen Sie die Absendereinträge aus Postmark manuell bei Cloudflare. Der Return-Path-CNAME bleibt DNS only. Das Modul bearbeitet keine Cloudflare-DNS-Einträge und fragt den Domain-Prüfstatus nicht bei Postmark ab. Seine DNS-Prüfungen verwenden die Versandadresse des Shops; deren Domain muss nicht mit der Websiteadresse übereinstimmen.

Was gilt, wenn meine Domain bei einem anderen Anbieter liegt?

Übertragen Sie die DNS-Einträge aus Ihrer Domaineinrichtung in Postmark in den DNS-Editor Ihres Anbieters. Die Veröffentlichung erfolgt bei jedem Anbieter manuell. Das Modul liefert keine DKIM-Werte und veröffentlicht keine Einträge.

Bleiben Inhalt und Gestaltung meiner Shopmails erhalten?

PrestaShop erstellt weiterhin Nachricht, Gestaltung und Anhänge. Das Modul stellt den Versand auf Postmark um, statt neue Vorlagen zu entwerfen. Benachrichtigungen anderer Module nutzen denselben Weg, sofern sie über die native PrestaShop Mailfunktion gesendet werden.

Wo sehe ich Rückläufer und Spambeschwerden?

Der Bericht im Backoffice zeigt die von Postmark gemeldeten Rückläufer und Spambeschwerden mit Empfänger, Zeitpunkt und Nachrichtenreferenz. Wenn ein Kunde nach seiner Bestellbestätigung fragt, hat Ihr Team einen Anhaltspunkt für die Prüfung. Eine erfolgreiche Versandantwort allein erklärt noch nicht, ob die Nachricht angekommen ist.

Was bestätigt die Testmail?

Der Test nutzt die native PrestaShop Mailfunktion und die Testvorlage des Moduls. Er ist an den Mitarbeiter adressiert, der den Test startet, und prüft damit den Versandweg des Shops. Die Antwort beim Senden und die tatsächlich empfangene Nachricht sind zwei getrennte Prüfpunkte.

Native Einstellungen und Tracking

Die Aktivierung setzt PS_MAIL_METHOD=2, PS_MAIL_SERVER=smtp.postmarkapp.com und Port 587. Der gespeicherte Servertoken dient als Benutzername und Passwort. PrestaShop 1.6 bis 8 verwendet tls, PrestaShop 9 den nativen Wert off für automatisches STARTTLS. Dies beschreibt keine beabsichtigt unverschlüsselte Verbindung.

Ab PrestaShop 1.7.6 ergänzt das Modul fehlende Header X-PM-KeepID: true, X-PM-TrackOpens: false und X-PM-TrackLinks: None. Bestehende explizite Werte bleiben erhalten. Ältere Versionen sind auf die Servervorgaben angewiesen. Die Prüfung warnt bei aktiviertem Servertracking, ändert diese Vorgaben aber nicht.

Rückmeldungen und Absenderprüfung

Authentifizierte Ereignisse müssen zum gespeicherten Server und outbound Stream passen. Bounce und SpamComplaint werden normalisiert und dedupliziert. Der Bericht zeigt die neuesten 30 Ereignisse und gespeicherte Gesamtzahlen, mit UTC-Zeit, Empfänger, Ereignis-ID und Message-ID.

Ab PrestaShop 1.7.6 prüft der abschließende Mailhook vor dem Ergänzen der Header, ob die Verbindung als aktiv gespeichert ist und native Versandmethode und Server Postmark verwenden. Er prüft weder die From-Domain noch erneut die Serverbereitschaft oder SMTP-Zugangsdaten jeder Nachricht. Prüfen Sie die Absenderberechtigung selbst in Postmark.

Ehrliche Grenzen

Versandannahme und Zustellung

Eine positive native Antwort beweist die Annahme zum Versand. Empfang und Posteingangsplatzierung folgen daraus nicht. Domainauthentifizierung setzt Empfängerfilter nicht außer Kraft. Es gibt keine Zustellquote oder Gmail-/Outlook-Zertifizierung.

Der Test ruft die native Funktion Mail::Send synchron auf und geht an den Mitarbeiter, der ihn startet. Es gibt keinen separaten CLI-Prozess, kein vom Modul gesetztes Versandzeitlimit und keine automatische Wiederholung. Prüfen Sie bei Fehlern die nativen Maileinstellungen und die Diagnose. Der normale Versand nutzt weiterhin den nativen Mailstack.

Umfang und Daten

Unterstützt wird nur der native transaktionale outbound Standardweg. Das Modul liefert keine Newsletterkampagnen, keinen Broadcast-Versand, keine eigenen Streams oder Vorlagen und keine automatische Wiederholung von Rückläufern. Unabhängige Transporte anderer Erweiterungen bleiben außerhalb.

Rückläufer und Beschwerden enthalten personenbezogene Daten wie Empfängeradressen und Nachrichtenreferenzen. Der Callback schließt Mailinhalt aus; gespeichert werden normalisierte Ereignisfelder statt roher MIME-Inhalte. Der eingerichtete Webhook hat keine Open- oder Click-Auslöser. Das Mailtracking kann weiterhin Servervorgaben oder vorhandenen Nachrichtenheadern folgen. Das bedeutet nicht, dass keine Daten an Postmark gehen: Der Dienst erhält die zu versendenden Mails.

Zugangsdaten liegen serverseitig und fehlen in der sicheren Ansicht. Eine Anwendungsverschlüsselung wird nicht zugesichert. Das Modul ändert keine Newslettereinwilligung und reaktiviert keine blockierten Postmark Empfänger automatisch.

Domain und Wiederherstellung

Richten Sie DKIM und Return-Path in Postmark ein und veröffentlichen Sie die DNS-Einträge selbst. Das Modul erstellt oder repariert keine vollständige SPF-/DMARC-Richtlinie, veröffentlicht keine DNS-Einträge und fragt den Domain-Prüfstatus nicht bei Postmark ab.

Die Wiederherstellung erhält Händleränderungen und löscht keine entfernten Postmark Ressourcen. Native Inhalte und Anhänge werden vom Modul nicht verändert. Daraus folgt keine bytegenaue Erhaltung durch die spätere Verarbeitung beim Versanddienst.

Fehlerbehebung

• DNS-Warnung: prüfen Sie die Absenderauthentifizierung in Postmark und veröffentlichen Sie dessen genaue Einträge bei Ihrem DNS-Anbieter. Der Return-Path-CNAME bleibt ohne Proxy.
• Absender abgewiesen: prüfen Sie, ob der tatsächliche Absender des Shops oder Moduls in Postmark zugelassen ist. Der Websitehostname allein bestimmt den Absender nicht.
• Test angenommen, Mail fehlt: prüfen Sie Mitarbeiterpostfach, Spamordner und vorhandene Rückmeldungen. Ein leerer Bericht beweist keine Zustellung.
• Keine Ereignisse: prüfen Sie die öffentliche HTTPS-Adresse und Weitergabe des Authentifizierungsheaders. Ein Browseraufruf ist kein gültiges Ereignis.
• Manuell geänderte Mailwerte: prüfen Sie native Einstellungen und Verbindungsstatus. Eigene Änderungen bleiben bei der Wiederherstellung erhalten.
• Zugriffsfehler: beheben Sie das gemeldete Problem mit Servertoken, SMTP oder outbound-Stream. Lokale Deaktivierung benötigt keine funktionierende Postmark API.