WordPress-E-Mails mit Emailit senden

WordPress sendet Passwort-Zurücksetzungen, WooCommerce-Bestellungen und Nachrichten aus Kontaktformularen mit wp_mail(). Das nutzt standardmäßig die Mail-Einrichtung des Servers und landet oft im Spam. Diese Anleitung leitet diese E-Mails über das SMTP-Relay von Emailit, entweder mit dem Plugin WP Mail SMTP oder mit ein paar Zeilen Code.

Voraussetzungen

• Administratorzugriff auf Ihre WordPress-Website.
• Eine verifizierte Versanddomain, zum Beispiel acme.com. Die Absenderadresse Ihrer Website muss sie verwenden.
• Ein API-Schlüssel. Erstellen Sie einen Schlüssel mit Sending Only, beschränkt auf Ihre Domain und etwa wordpress-acme genannt, damit eine geleakte Plugin-Einstellung für nichts anderes missbraucht werden kann.
• Solange Ihr Workspace keinen Produktionszugang hat, können Sie nur an die Konto-E-Mail-Adressen von Workspace-Mitgliedern senden. Testen Sie mit Ihrer eigenen Adresse.

SMTP-Einstellungen

Diese Werte tragen Sie in jedem SMTP-Plugin ein:

Wenn Ihr Hoster Port 587 blockiert, verwenden Sie 2525 oder 2587 mit TLS oder 465 mit SSL. Siehe SMTP-Einstellungen.

WP Mail SMTP konfigurieren

WP Mail SMTP ist ein kostenloses Plugin, das den Mail-Transport von WordPress ersetzt. Andere SMTP-Plugins wie FluentSMTP oder Post SMTP verwenden dieselben Einstellungen mit leicht abweichenden Bezeichnungen.

1. Plugin installieren. Öffnen Sie in WordPress Plugins > Add New, suchen Sie nach WP Mail SMTP und installieren und aktivieren Sie es. Überspringen Sie den Einrichtungsassistenten, falls er sich öffnet; Sie können alles auf der Einstellungsseite konfigurieren.

2. Absender festlegen. Öffnen Sie die Einstellungen des Plugins. Setzen Sie From Email auf eine Adresse auf Ihrer verifizierten Domain und aktivieren Sie Force From Email, damit jedes Plugin von dieser Adresse sendet. Setzen Sie From Name auf den Namen Ihrer Website oder Ihres Unternehmens.

3. Other SMTP wählen. Wählen Sie unter Mailer die Option Other SMTP.

4. Server eintragen. Setzen Sie SMTP Host auf smtp.emailit.com, Encryption auf TLS und SMTP Port auf 587. Lassen Sie Auto TLS aktiviert.

5. Zugangsdaten eintragen. Aktivieren Sie Authentication. Setzen Sie SMTP Username auf emailit und SMTP Password auf Ihren API-Schlüssel. Speichern Sie die Einstellungen.

6. Test senden. Senden Sie mit dem Tool Email Test des Plugins eine Nachricht an Ihre eigene Adresse. Sie erscheint innerhalb von Sekunden unter Email API›Emails.

Schlüssel aus der Datenbank heraushalten

WP Mail SMTP kann seine Einstellungen aus Konstanten lesen, sodass der API-Schlüssel in wp-config.php statt in der Datenbank liegt. Fügen Sie diese Zeilen oberhalb von /* That's all, stop editing! */ ein:

define( 'WPMS_ON', true );
define( 'WPMS_MAILER', 'smtp' );
define( 'WPMS_SMTP_HOST', 'smtp.emailit.com' );
define( 'WPMS_SMTP_PORT', 587 );
define( 'WPMS_SSL', 'tls' );
define( 'WPMS_SMTP_AUTH', true );
define( 'WPMS_SMTP_AUTOTLS', true );
define( 'WPMS_SMTP_USER', 'emailit' );
define( 'WPMS_SMTP_PASS', 'secret_••••••••••••••••••••••••••••••••' );
define( 'WPMS_MAIL_FROM', 'hello@acme.com' );
define( 'WPMS_MAIL_FROM_FORCE', true );
define( 'WPMS_MAIL_FROM_NAME', 'Acme' );

Die Einstellungsseite zeigt diese Werte dann als gesperrt an. Prüfen Sie die Dokumentation des Plugins, falls ein Feld seine Konstante nicht übernimmt.

Ohne Plugin konfigurieren

Wenn Sie lieber kein Plugin installieren möchten, fügen Sie ein Must-use-Plugin hinzu, das den integrierten PHPMailer von WordPress konfiguriert. Definieren Sie den Schlüssel in wp-config.php:

define( 'EMAILIT_API_KEY', 'secret_••••••••••••••••••••••••••••••••' );

Erstellen Sie dann diese Datei:

<?php
/**
 * Plugin Name: Emailit SMTP
 * Description: Sends all WordPress email through the Emailit SMTP relay.
 */

add_action( 'phpmailer_init', function ( $phpmailer ) {
    $phpmailer->isSMTP();
    $phpmailer->Host       = 'smtp.emailit.com';
    $phpmailer->Port       = 587;
    $phpmailer->SMTPSecure = 'tls';
    $phpmailer->SMTPAuth   = true;
    $phpmailer->Username   = 'emailit';
    $phpmailer->Password   = EMAILIT_API_KEY;
} );

add_filter( 'wp_mail_from', fn () => 'hello@acme.com' );
add_filter( 'wp_mail_from_name', fn () => 'Acme' );

Dateien in mu-plugins werden automatisch geladen und lassen sich im Admin-Bereich nicht deaktivieren.

Webhooks empfangen

Die meisten Websites brauchen keine Webhooks. Wenn Sie auf Bounces oder Beschwerden reagieren möchten, etwa um die Adresse eines WooCommerce-Kunden zu markieren, registrieren Sie eine REST-Route und verifizieren Sie die Signatur. Speichern Sie das Signatur-Secret des Webhooks in wp-config.php als EMAILIT_WEBHOOK_SECRET:

<?php
add_action( 'rest_api_init', function () {
    register_rest_route( 'emailit/v1', '/webhook', [
        'methods'             => 'POST',
        'permission_callback' => '__return_true',
        'callback'            => function ( WP_REST_Request $request ) {
            $payload   = $request->get_body();
            $timestamp = (string) $request->get_header( 'x-emailit-timestamp' );
            $signature = (string) $request->get_header( 'x-emailit-signature' );
            $expected  = hash_hmac( 'sha256', $timestamp . '.' . $payload, EMAILIT_WEBHOOK_SECRET );

            if ( abs( time() - (int) $timestamp ) > 300 || ! hash_equals( $expected, $signature ) ) {
                return new WP_Error( 'invalid_signature', 'Invalid signature', [ 'status' => 401 ] );
            }

            foreach ( json_decode( $payload, true ) as $event ) {
                if ( 'email.bounced' === $event['type'] ) {
                    // Flag $event['data']['object']['to'].
                }
            }

            return new WP_REST_Response( null, 200 );
        },
    ] );
} );

Richten Sie den Webhook auf https://acme.com/wp-json/emailit/v1/webhook aus. Die Signaturprüfung schützt die Route; entfernen Sie sie daher nicht.

Tipps für den Produktivbetrieb

• Absenderadresse erzwingen. WooCommerce-, Kontaktformular- und Mitgliedschafts-Plugins setzen oft ihren eigenen Absender. Wenn Sie eine Absenderadresse auf Ihrer verifizierten Domain erzwingen, treten keine Fehler wie 530 From/Sender domain is not verified mehr auf.
• Bei Fehlern die Logs prüfen. Email API›Logs zeigt jede SMTP-Anmeldung und jede Nachricht mit ihrem Statuscode, gefiltert nach API-Schlüssel.
• Limits im Blick behalten. Neue Workspaces können standardmäßig 2 E-Mails pro Sekunde und 5.000 pro Tag senden. Ein großer WooCommerce-Sale oder ein Newsletter-Plugin kann diese Grenze erreichen; unter Limits erfahren Sie, wie Sie mehr beantragen.
• Keine Newsletter über wp_mail senden. Für Marketing-E-Mails an eine Liste verwenden Sie Kampagnen, die Abmeldelinks und Kontaktlisten für Sie verwalten.

Fehlerbehebung

Weitere Hilfe finden Sie unter SMTP-Fehlerbehebung.

Nächste Schritte