SMTP Server Konfiguration pro E-Mail Adresse

Installation und Einrichtung

1. Installieren und aktivieren Sie die Erweiterung unter "Erweiterungen -> Meine Erweiterungen".
2. Öffnen Sie "Einstellungen -> Erweiterungen -> Zusätzliche SMTP-Server".
3. Klicken Sie auf "Neuen SMTP-Server hinzufügen".
4. Tragen Sie die Absenderadresse und Verbindungsdaten ein und wählen Sie die Authentifizierungsmethode wie unten beschrieben.
5. Speichern Sie die Konfiguration und lösen Sie eine E-Mail mit dieser Absenderadresse aus.

Absenderadresse festlegen

Tragen Sie unter "Absender-Adresse" die E-Mail-Adresse ein, für die diese SMTP-Konfiguration verwendet werden soll. Maßgeblich ist die Adresse im Absenderfeld der ausgehenden E-Mail. Geben Sie die E-Mail-Adresse ohne Anzeigenamen ein.

Die Shopbetreiber-E-Mail-Adresse können Sie unter "Einstellungen -> Shop -> Stammdaten" je Verkaufskanal festlegen. Wird für eine E-Mail keine Absenderadresse ausdrücklich vorgegeben, verwendet Shopware diese Adresse. Ist sie leer, wird die Absender-Adresse unter "Einstellungen -> System -> Mailer" verwendet.

Für einzelne Flow-Aktionen können Sie eine abweichende Absenderadresse festlegen. Öffnen Sie den gewünschten Flow im Flow Builder und bearbeiten Sie die Aktion "E-Mail verschicken". Wählen Sie unter "Absender" die Option "Benutzerdefiniert" und tragen Sie die gewünschte Adresse unter "Benutzerdefinierte Absender-Adresse" ein. Speichern Sie die Aktion und den Flow.

Diese Adresse hat für die betreffende E-Mail Vorrang vor der Shopbetreiber-E-Mail-Adresse. Legen Sie in der Erweiterung eine SMTP-Konfiguration mit derselben Absenderadresse an, damit auch diese E-Mails über den passenden Zugang versendet werden. So können Sie innerhalb eines Verkaufskanals unterschiedliche SMTP-Konfigurationen für verschiedene Flow-Aktionen verwenden.

Die Erweiterung ordnet SMTP-Server nicht direkt Verkaufskanälen zu. Sollen Verkaufskanäle unterschiedliche Server verwenden, hinterlegen Sie unterschiedliche Absenderadressen und legen Sie für jede Adresse eine SMTP-Konfiguration an. Verkaufskanäle mit derselben Absenderadresse verwenden dieselbe Konfiguration.

Je Absenderadresse ist nur eine Konfiguration möglich. Das Speichern einer zweiten Konfiguration mit derselben Adresse schlägt fehl. Gibt es keine passende Konfiguration, verwendet Shopware seinen Standard-Mailtransport. Ein Verbindungs- oder Anmeldefehler beim zugeordneten Server führt nicht dazu, dass auf den Standard-Mailtransport ausgewichen wird.

Verbindung konfigurieren

Tragen Sie in den "Grundeinstellungen" die Verbindungsdaten Ihres E-Mail-Anbieters ein:

• Host: Der Hostname des SMTP-Servers.
• Port: Der vom Anbieter vorgegebene Port. Tragen Sie ihn ausdrücklich ein, wenn Ihr Anbieter einen Port nennt.
• SMTPS: Aktivieren Sie diese Option für eine von Beginn an verschlüsselte Verbindung, üblicherweise auf Port 465. Deaktivieren Sie sie für SMTP, etwa für eine STARTTLS-Verbindung des Anbieters auf Port 587. STARTTLS wird automatisch ausgehandelt, wenn der Server es unterstützt.

Bei neuen Konfigurationen ist SMTPS aktiviert. Bleibt der Port leer, wird mit SMTPS Port 465 und ohne SMTPS Port 25 verwendet. Der angezeigte Port ist nur ein Platzhalter und kein gespeicherter Wert. Für STARTTLS auf Port 587 tragen Sie den Port daher ausdrücklich ein.

Authentifizierung konfigurieren

Wählen Sie unter "Authentifizierungsmethode" eine der folgenden Optionen.

Benutzername und Passwort

Tragen Sie die Zugangsdaten Ihres SMTP-Anbieters ein. Der Benutzername kann von der Absenderadresse abweichen. Das Konto muss zum Versand mit dieser Adresse berechtigt sein.

OAuth 2.0

Tragen Sie die folgenden Werte aus der Anwendungskonfiguration Ihres Anbieters ein:

• URL: Der Token-Endpunkt, keine Autorisierungs- oder Anmelde-URL.
• Scope: Der für den SMTP-Zugriff erforderliche Scope.
• Client ID: Die Client-ID der Anwendung.
• Client Secret: Das Client-Secret der Anwendung.

Die Erweiterung fordert Token mit dem Grant-Typ client_credentials an und übermittelt Client-ID und Client-Secret per HTTP-Basic-Authentifizierung. Anschließend meldet sie sich über XOAUTH2 am SMTP-Server an. Als Benutzername dient dabei die konfigurierte Absenderadresse.

Ihr Anbieter muss diese Kombination unterstützen und der Anwendung Zugriff auf das Postfach des Absenders gewähren. Die Antwort des Token-Endpunkts muss access_token und die Gültigkeitsdauer expires_in als ganze Zahl in Sekunden enthalten. Andernfalls schlägt der Versand fehl. Verfahren mit interaktiver Anmeldung, Autorisierungscode oder Refresh-Token werden nicht unterstützt. Zugriffstoken werden zwischengespeichert und bei Bedarf kurz vor ihrem Ablauf erneut angefordert.

Erweiterte Einstellungen konfigurieren

Lassen Sie "TLS-Peer-Verifizierung aktivieren" im regulären Betrieb eingeschaltet. Damit wird das TLS-Zertifikat des SMTP-Servers geprüft. Die Möglichkeit, die Prüfung abzuschalten, ist für Entwicklungsumgebungen vorgesehen.

Unter "BCC-Empfänger" können Sie optional Adressen hinterlegen, die BCC-Kopien der über diese Konfiguration versendeten E-Mails erhalten sollen. Die ursprünglichen Empfänger bleiben erhalten. Lassen Sie das Feld leer, wenn keine Kopien benötigt werden.

Shopware-Einstellungen für den E-Mail-Versand

Die Einstellungen unter "Einstellungen -> System -> Mailer" gelten auch für E-Mails, die über eine Konfiguration der Erweiterung versendet werden:

• E-Mail-Versand deaktivieren: Ist der Versand deaktiviert, etwa auch im Staging-Modus, werden keine E-Mails versendet, auch nicht über die Erweiterung.
• Empfänger-Adresse: Eine dort hinterlegte Adresse erhält zusätzlich eine BCC-Kopie aller E-Mails, auch der über die Erweiterung versendeten.

Anhänge wie Dokumente aus Flow-Aktionen werden wie beim Standard-Mailtransport mitgesendet.

Versand prüfen

Lösen Sie eine Shopware-E-Mail mit der konfigurierten Absenderadresse aus und prüfen Sie den Empfang. Wiederholen Sie dies für jede Absenderadresse und prüfen Sie auch konfigurierte BCC-Empfänger. Das Speichern einer Konfiguration versendet keine Test-E-Mail und prüft die Verbindung nicht.

Wenn Shopware E-Mails asynchron versendet, müssen die Message-Queue-Consumer laufen. Die Erweiterung wählt die SMTP-Konfiguration aus, sobald die E-Mail aus der Warteschlange verarbeitet wird. Prüfen Sie außerdem eine E-Mail ohne passende Konfiguration, um den Standard-Mailtransport zu kontrollieren.

Wird der falsche Server verwendet, prüfen Sie die tatsächliche Absenderadresse der E-Mail. Eine von einem Flow oder einer anderen Erweiterung ausdrücklich gesetzte Adresse kann von der Shopbetreiber-E-Mail-Adresse abweichen.