SMTP

SMTP-Integration

Senden Sie E-Mails über das Standard-SMTP-Protokoll. Ihre Zugangsdaten finden Sie auf der Seite SMTP Settings in Ihrem Dashboard.

Bevor Sie beginnen

SMTP-Zugangsdaten lassen sich erst erzeugen, wenn Sie senden können. Wählen Sie den Weg, der zu Ihrer Versandart passt:

Ihre eigene Domain

Verifizierte Domain

Fügen Sie Ihre Versand-Domain hinzu und veröffentlichen Sie die DNS-Einträge. Sobald sie als verifiziert erscheint, können Sie von jeder Adresse darauf senden.

Domains öffnen →

Geteilte Domain

Registrierter Absender

Keine eigene Domain? Registrieren Sie die Absenderadresse, die Sie nutzen möchten. Nur registrierte Absender können über eine geteilte Domain senden.

Absender öffnen →
i

Dann Ihre Zugangsdaten holen: öffnen Sie Dashboard → SMTP Settings und erzeugen Sie Benutzername und Passwort.

Server-Einstellungen

Host

smtp.emailsbit.com

Hostname des SMTP-Servers

Ports

505 · 588

Verfügbare Verbindungsports (588 empfohlen, mit STARTTLS)

Sicherheit

STARTTLS

Empfohlenes Sicherheitsprotokoll

Port 505

Keine

Unverschlüsselte Verbindung (nicht für die Produktion empfohlen)

Port 588

STARTTLSempfohlen

Opportunistische TLS-Verschlüsselung — startet im Klartext und wechselt zu TLS

!

Sicherheits-Best-Practices: Hinterlegen Sie Zugangsdaten niemals fest im Quellcode. Nutzen Sie Umgebungsvariablen oder einen sicheren Secrets-Manager.

Transaktional

Bestellbestätigungen, Passwort-Resets, Belege. Verbinden Sie sich auf Port 588 mit STARTTLS und senden Sie. Keine zusätzlichen Header nötig.

const nodemailer = require('nodemailer');

const transporter = nodemailer.createTransport({
  host: 'smtp.emailsbit.com',
  port: 588,
  secure: false, // STARTTLS: starts as plain text, upgrades to TLS
  requireTLS: true,
  auth: {
    user: process.env.SMTP_USER,
    pass: process.env.SMTP_PASS,
  },
});

async function main() {
  await transporter.sendMail({
    from: '"Support" <support@yourdomain.com>',
    to: 'user@example.com',
    subject: 'Your Order Confirmation',
    html: '<h2>Thank you for your purchase!</h2>',
  });
}

main().catch(console.error);
i

Cc und Bcc funktionieren auch: nutzen Sie die cc- und bcc-Optionen Ihrer Bibliothek, und jede Adresse erhält ihre eigene Kopie. Beispiele in allen Sprachen finden Sie unter CC & BCC.

Marketing

Newsletter und Kampagnen. Fügen Sie die folgenden Listen-Header hinzu, damit Mail-Clients einen Abmelde-Button zeigen und Beschwerden pro Kampagne erfasst werden. Sie werden automatisch ausgewertet und angewendet, ohne zusätzlichen API-Aufruf.

const nodemailer = require('nodemailer');

const transporter = nodemailer.createTransport({
  host: 'smtp.emailsbit.com',
  port: 588,
  secure: false, // STARTTLS: starts as plain text, upgrades to TLS
  requireTLS: true,
  auth: {
    user: process.env.SMTP_USER,
    pass: process.env.SMTP_PASS,
  },
});

async function main() {
  await transporter.sendMail({
    from: '"Support" <support@yourdomain.com>',
    to: 'user@example.com',
    subject: 'Our October newsletter',
    html: '<h2>What is new this month</h2>',
    headers: {
      'List-Id': 'My List <mylist.yourdomain.com>',
      'X-Report-Abuse': 'https://yourdomain.com/report-abuse',
      'Feedback-ID': 'campaign123:subscriber456:list789:youraccount',
      'List-Unsubscribe': '<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>',
      'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
    },
  });
}

main().catch(console.error);

Reservierte Header

Diese fünf werden unverändert akzeptiert, ohne X--Präfix.

List-Id

Kennzeichnet die Mailingliste oder den Versandstrom, zu dem eine Nachricht gehört. Mailbox-Provider und Mail-Clients nutzen ihn, um Nachrichten derselben Liste zu gruppieren und zu filtern.

Anzeigename, gefolgt von einer Listenkennung in spitzen Klammern.

My List <mylist.yourdomain.com>
X-Report-Abuse

Eine URL, unter der Empfänger die Nachricht als Missbrauch oder Spam melden können.

Eine vollständige URL.

https://yourdomain.com/report-abuse
Feedback-ID

Versieht die Nachricht mit Ihren eigenen Kennungen, damit Feedback-Loop-Berichte (etwa Beschwerdequoten in Gmail Postmaster Tools) nach Kampagne, Abonnent oder Liste aufgeschlüsselt werden können.

Durch Doppelpunkte getrennte Felder: Kampagne : Abonnent : Liste : Ihr Konto.

campaign123:subscriber456:list789:youraccount
List-Unsubscribe

Teilt Mail-Clients mit, wie der Empfänger abgemeldet wird, und aktiviert so den nativen "Unsubscribe"-Button neben dem Absendernamen.

Eine oder mehrere URIs in spitzen Klammern, durch Kommas getrennt. Akzeptiert mailto:- und https:-URIs.

<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>
List-Unsubscribe-Post

Aktiviert die Abmeldung mit einem Klick (RFC 8058). Der Mail-Client sendet eine POST-Anfrage an die https-URI in List-Unsubscribe, ohne Bestätigungsseite dazwischen.

Der feste Wert unten. Erfordert eine https-URI in List-Unsubscribe.

List-Unsubscribe=One-Click

Abmeldung mit einem Klick

Setzen Sie List-Unsubscribe und List-Unsubscribe-Post zusammen, dann kann sich der Empfänger direkt im Mail-Client abmelden.

  1. 1

    Beide Header hinzufügen

    Setzen Sie List-Unsubscribe mit einer https-URL und List-Unsubscribe-Post mit dem festen Wert.

  2. 2

    Empfänger klickt auf Unsubscribe

    Der Mail-Client zeigt seinen eigenen Button. Der Empfänger besucht Ihre Website nie.

  3. 3

    Client sendet ein POST

    Die Anfrage geht mit dem Body unten an Ihre https-URL, ohne Cookies und ohne Benutzerinteraktion.

  4. 4

    Ihr Endpoint meldet ab

    Entfernen Sie den Empfänger und antworten Sie mit einem 2xx-Status. Keine Weiterleitung, kein Login verlangen.

Anfrage, die Ihr Endpoint erhält

POST /unsubscribe?u=123 HTTP/1.1
Host: yourdomain.com
Content-Type: application/x-www-form-urlencoded

List-Unsubscribe=One-Click

Marketing-Limit des Free-Plans

Im Free-Plan kannst du bis zu 30 Marketing- oder Kaltakquise-E-Mails pro Tag senden. Würde eine Nachricht dieses Limit überschreiten, lehnt der Server sie am Ende von DATA ab mit:

550 5.7.1 Daily marketing limit reached for the free plan (30/30, 2 recipients in this email). Transactional emails still go out. Upgrade: https://app.sendcorex.com/dashboard/billing
  • Pro Empfänger gezählt: eine E-Mail an 5 Personen zählt als 5.

  • Gleitendes 24-Stunden-Fenster, kein Kalendertag.

  • Transaktionale E-Mails sind nicht betroffen und werden weiter versendet.

  • Nichts wird in die Warteschlange gestellt: sende erneut, wenn das Fenster frei wird, oder führe ein Upgrade durch. Bezahlte Pläne haben kein separates Marketing-Limit.

Jede Nachricht wird automatisch als transaktional oder Marketing eingestuft; es gibt keine Einstellung dafür. Vollständige Regeln: Richtlinie zur akzeptablen Nutzung — Free-Plan

Eigene Header

Hängen Sie eigene Metadaten an jede Nachricht, transaktional oder Marketing, mit einem Header, der beginnt mit X-.

const nodemailer = require('nodemailer');

const transporter = nodemailer.createTransport({
  host: 'smtp.emailsbit.com',
  port: 588,
  secure: false, // STARTTLS: starts as plain text, upgrades to TLS
  requireTLS: true,
  auth: {
    user: process.env.SMTP_USER,
    pass: process.env.SMTP_PASS,
  },
});

async function main() {
  await transporter.sendMail({
    from: '"Support" <support@yourdomain.com>',
    to: 'user@example.com',
    subject: 'Your Order Confirmation',
    html: '<h2>Thank you for your purchase!</h2>',
    headers: {
      'X-MyCustomHeader': 'testcustom0',
      'X-CUSTOM-X': 'testcustom1',
    },
  });
}

main().catch(console.error);
!

Namensregel: jeder Header außerhalb der reservierten Liste muss mit dem Präfix X- beginnen, sonst wird die Nachricht abgelehnt mit HEADER_NOT_ALLOWED.

Gültig

"X-MyCustomHeader": "testcustom0"
"X-CUSTOM-X": "testcustom1"

Ungültig

"MyCustomHeader": "testcustom0"

→ HEADER_NOT_ALLOWED

i

Wiederholungen und Hard Bounces: steuern Sie sie pro E-Mail mit X-Sendcorex-*-Headern — siehe Zustelloptionen.