Inhaltsverzeichnis

    E-Mail-Versand einrichten

    Hinweis: Diese Seite bezieht sich auf JTL-Shop 5. Falls Sie noch JTL-Shop 4 verwenden, finden Sie die Dokumentation unter JTL-Shop 4.

    Ihre Aufgabe/Ausgangslage

    Sie möchten E-Mails von Ihrem JTL-Shop aus direkt an Ihre Kunden verschicken lassen. Dazu benötigen Sie einen externen E-Mail-Server, den Sie in JTL-Shop einbinden können. In diesem Guide-Beitrag lesen Sie, worauf Sie achten müssen.
    Hinweis: Wenn Sie Gmail oder Outlook nutzen, müssen Sie Ihr E-Mail-Konto nochmal neu mit JTL-Shop verbinden. Das liegt daran, dass Microsoft und Google Basic Auth abgekündigt haben und eine Authentifizierung über OAuth fordern.

    Allgemeine Informationen

    Zunächst müssen Sie eine Sendemethode wählen. Sie können Ihre E-Mails via SMTP, PHP Mail, Sendmail, QMail, Gmail oder Microsoft Outlook via OAuth versenden.

    PHP Mail benötigt lediglich die Eingabe einer Master-E-Mail-Adresse und wird dann meistens automatisch unterstützt. Leider werden per PHP Mail versendete E-Mails sehr häufig als Spam klassifiziert. Außerdem wird die Anzahl der möglichen E-Mails pro Tag in der Regel begrenzt (z. B. auf 100) und Sie bekommen keine Rückmeldung, wenn eine E-Mail nicht zugestellt werden konnte. Von PHP Mail ist daher in der Regel abzuraten.

    Sendmail und QMail sind wenig verbreitet und teilweise komplex in der Konfiguration. Wir empfehlen daher eindeutig, die Anbindung eines E-Mail-Kontos über SMTP, Outlook OAuth oder Gmail OAuth zu realisieren. Alle relevanten Zugangsdaten für SMTP sollten Sie in der Regel vom Betreiber Ihres E-Mail-Kontos erhalten. Falls ein Server-Administrator für Sie einen eigenen E-Mail-Server aufgesetzt hat, erhalten Sie die Daten von diesem.

    Falls Sie ein Outlook-Konto verwenden, müssen Sie das OAuth-Verfahren nutzen. Lesen Sie mehr zum Thema hier: E-Mail-Versand konfigurieren (Outlook).

    Falls Sie ein Gmail-Konto verwenden, müssen Sie Ihr Gmail-Konto per SMTP mit dem JTL-Shop verbinden. Lesen Sie mehr zum Thema hier: E-Mail-Versand konfigurieren (Gmail).

    E-Mail-Versand konfigurieren (SMTP)

    Die Einstellungen, die Sie im folgenden Abschnitt vornehmen, werden für den E-Mail-Versand genutzt, sofern keine anderen Einstellungen für den jeweiligen Bereich, bspw. eine E-Mail-Vorlage, ein Kontaktformularbehelf, Newsletter etc., hinterlegt sind.

    Hinweis: Wenn Sie das JTL-Shop Hosting nutzen, lesen Sie für die korrekten Einstellungen bitte den folgenden Eintrag im FAQ des JTL-Shop Hostings: FAQ zum JTL-Shop Hosting.
    1. Melden Sie sich im Backend von JTL-Shop an und klicken Sie unter Administration auf E-Mail > Server. Die Seite Einstellungen: E-Mail-Einstellungen öffnet sich.
    1. Bestimmen Sie über das Dropdown-Menü E-Mails versenden per, über welchen Dienst Sie die E-Mails versenden möchten. Wir empfehlen den Versand per SMTP.
    2. Wenn Sie SMTP nutzen, geben Sie den SMTP-Hostnamen, -Port, -Benutzernamen und das SMTP-Passwort an. Legen Sie fest, ob Sie SMTP Auth nutzen und welche SMTP-Security (Sicherheitslevel) Ihre E-Mails haben.
    3. Hinterlegen Sie im Eingabefeld Master-E-Mail-Adresse eine E-Mail-Adresse, die eingetragene SMTP-Daten versenden kann.
    4. Tragen Sie im Eingabefeld Absender für Master-E-Mail-Adresse eine E-Mail ein, die beim Versand der E-Mails angezeigt werden soll.
    5. Legen Sie über das Dropdown-Menü E-Mails sofort versenden fest, ob alle E-Mails immer sofort versendet werden sollen oder ob nur priorisierte E-Mails sofort versendet werden sollen.
    Hinweis: Die Funktion E-Mails sofort versenden ist ab JTL-Shop 5.3.0 verfügbar.
    1. Bestätigen Sie Ihre Angaben über die Schaltfläche Speichern bzw. Speichern und Konfiguration testen.

    E-Mail-Versand konfigurieren (Outlook)

    App im Microsoft Azure-Portal registrieren

    Bevor Sie die Einstellungen im Backend von JTL-Shop treffen können, müssen Sie im Microsoft Azure-Portal eine neue App registrieren. Lesen Sie zu dem Thema diese externe Anleitung (Stand: Dezember 2024).

    Die Anleitung ist nur auf Englisch verfügbar. Tipp: Wenn Sie den Google Chrome Browser verwenden, rechtsklicken Sie auf eine beliebige Stelle auf der Seite und wählen Sie im Kontextmenü die Option Übersetzen in Deutsch. Die Seite wird automatisch für Sie auf Deutsch übersetzt.

    Hinweis: Da es sich um eine externe Anleitung handelt, können wir nicht garantieren, dass der Stand der Anleitung immer aktuell ist. Bitte geben Sie uns gerne über das Feedback-Formular Bescheid, falls die externe Anleitung veraltet sein sollte.

    Beachten Sie beim Befolgen der externen Anleitung bitte folgende Hinweise:

    • Geben Sie im Microsoft Azure-Portal im Bereich Anwendung registrieren im Eingabefeld Umleitungs-URI (optional) zwingend Ihre Onlineshop-URL mit dem Suffix /admin/oauthauthorization ein, z. B. https://www.beispiel-shop.de/admin/oauthauthorization.
    • Nachdem Sie die App im Microsoft Azure-Portal erfolgreich registriert haben, werden Sie in die App-Übersicht weitergeleitet. Notieren Sie sich hier die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant). Diese IDs benötigen Sie für die Einstellungen im Backend von JTL-Shop.
    • Nachdem Sie im Microsoft Azure-Portal einen geheimen Clientschlüssel für die App erstellt haben, notieren Sie sich den geheimen Clientschlüssel ebenfalls. Sie benötigen den Schlüssel für die Einstellungen im Backend von JTL-Shop.
    • Befolgen Sie nur den ersten Teil der externen Anleitung. Ab dem Schritt „Obtaining Authorization Code, Access Token and Refresh Token“ können Sie die Anleitung ignorieren. Sie erhalten den Refresh Token nachdem Sie alle erforderlichen Einstellungen im Backend von JTL-Shop getroffen haben.

    Microsoft OAuth-Einstellungen in JTL-Shop treffen

    1. Öffnen Sie im Backend von JTL-Shop über das Menü Administration > E-Mail > Server die Seite Einstellungen: E-Mail-Einstellungen.
    1. Wählen Sie im Dropdown-Menü E-Mails versenden per die Option Microsoft Outlook via OAuth.
    2. Geben Sie im Eingabefeld SMTP-Benutzername Ihre Outlook-E-Mail-Adresse ein.
    3. Hinterlegen Sie im Eingabefeld Master-E-Mail-Adresse eine E-Mail-Adresse, von der die E-Mails gesendet werden, z. B. Ihre Outlook-E-Mail-Adresse.
    4. Tragen Sie im Eingabefeld Absender für Master-E-Mail-Adresse eine Bezeichnung ein, die als Absender beim Versand der E-Mails angezeigt werden soll, z. B. den Namen von Ihrem Onlineshop.
    5. Legen Sie über das Dropdown-Menü E-Mails sofort versenden fest, ob alle E-Mails immer sofort versendet werden sollen oder ob nur priorisierte E-Mails sofort versendet werden sollen.
    6. Geben Sie die OAuth Anwendungs-ID (Client ID) ein, die Sie bei der App-Registrierung im Microsoft Azure-Portal kopiert haben.
    7. Geben Sie den OAuth Clientschlüssel (Client-Secret) ein, den Sie im Microsoft Azure-Portal erstellt haben.
    8. Geben Sie die OAuth Mandanten-ID ein, die Sie bei der App-Registrierung im Microsoft Azure-Portal kopiert haben.
    9. Klicken Sie auf die Schaltfläche Autorisierung vornehmen. Ein eigenes Dialogfenster von Microsoft öffnet sich.
    10. Bestätigen Sie die Autorisierung in dem Microsoft-Dialogfenster.
    11. Prüfen Sie, ob im Eingabefeld OAuth Refresh-Token automatisch ein Code eingefügt wurde.
    12. Klicken Sie auf die Schaltfläche Speichern und Konfiguration testen.
    13. Prüfen Sie in der Anzeige, ob die Authentifizierung erfolgreich war. Suchen Sie z. B. nach den Worten „Authentication successful“.

    Sie haben erfolgreich ein Outlook-Konto über das OAuth-Verfahren mit Ihrem JTL-Shop verbunden.

    E-Mail-Versand konfigurieren (Gmail)

    Bevor Sie die Einstellungen im Backend von JTL-Shop treffen können, müssen Sie in Ihrem Google-Konto ein App-Passwort erstellen.

    App-Passwort erstellen

    Hinweis: Sie können App-Passwörter nur erstellen, wenn Sie die 2-Faktor-Authentifizierung für Ihr Google-Konto aktiviert haben. Lesen Sie mehr zum Thema hier: 2-Faktor-Authentifizierung aktivieren (Google-Konto).
    1. Melden Sie sich in Ihrem Google-Konto an.
    2. Wechseln Sie über das Seitenmenü in den Bereich Sicherheit.
    3. Geben Sie in das Suchfeld den Suchbegriff „App-Passwörter“ ein.
    4. Klicken Sie auf das Suchergebnis App-Passwörter.
    1. Sie sehen den Bereich App-Passwörter.
    2. Geben Sie in das Eingabefeld App-Name den Namen Ihres Onlineshops ein.
    3. Klicken Sie auf die Schaltfläche Erstellen.
    4. Kopieren Sie das generierte App-Passwort.

    Gmail-Einstellungen in JTL-Shop treffen

    1. Öffnen Sie im Backend von JTL-Shop über das Menü Administration > E-Mail > Server die Seite Einstellungen: E-Mail-Einstellungen.
    1. Wählen Sie im Dropdown-Menü E-Mails versenden per die Option SMTP.
    2. Geben Sie im Eingabefeld SMTP-Hostname den Text smtp.gmail.com ein.
    3. Hinterlegen Sie im Eingabefeld SMTP-Port die Zahl 465.
    4. Wählen Sie im Dropdown-Menü SMTP-Auth nutzen die Option Ja.
    5. Geben Sie im Eingabefeld SMTP-Benutzername Ihre Gmail-Adresse ein.
    6. Geben Sie im Eingabefeld SMTP-Passwort das App-Passwort ein, das Sie in Ihrem Google-Konto generiert haben.
    7. Wählen Sie im Dropdown-Menü SMTP-Security die Option SSL aus.
    8. Geben Sie im Eingabefeld Master-E-Mail-Adresse Ihre Gmail-Adresse an.
    9. Tragen Sie im Eingabefeld Absender für Master-E-Mail-Adresse eine Bezeichnung ein, die als Absender beim Versand der E-Mails angezeigt werden soll, z. B. den Namen Ihres Onlineshops.
    10. Legen Sie über das Dropdown-Menü E-Mails sofort versenden fest, ob alle E-Mails immer sofort versendet werden sollen, oder ob nur priorisierte E-Mails sofort versendet werden sollen.
    11. Klicken Sie auf die Schaltfläche Speichern und Konfiguration testen.
    12. Prüfen Sie in der Anzeige, ob die Authentifizierung erfolgreich war. Suchen Sie z. B. nach den Worten „Authentication successful“.

    Sie haben erfolgreich ein Gmail-Konto mit Ihrem JTL-Shop verbunden.