E-Mail

Zustelloptionen

Was passiert, wenn eine E-Mail nicht sofort zugestellt werden kann, und wie Sie das pro E-Mail ändern: wie lange wir es weiter versuchen und ob an eine Adresse gesendet wird, die zuvor einen Hard Bounce hatte.

i

Alle Optionen sind optional. Ohne sie folgt jede E-Mail den unten genannten Standardwerten. Sie gehören in den Body von E-Mail senden, bzw. als Header beim Versand über SMTP.

So funktionieren Wiederholungen

Eine dauerhafte Ablehnung, etwa bei einer nicht existierenden Adresse, ist endgültig und wird nicht wiederholt. Diese Fälle wiederholen wir für Sie:

Greylisting

Der Empfangsserver antwortet einem ihm unbekannten Absender mit „später erneut versuchen“.

Wir versuchen es von derselben IP erneut nach 5, 10, 20, 40, 60 und 60 Minuten (insgesamt etwa 3 Stunden).

Automatisch

Temporäre Fehler

Eine 4xx-Antwort, zu viele Verbindungen oder eine Verbindung, die mitten im Versand abbricht.

Wir versuchen es einige Male mit einer Pause zwischen den Versuchen erneut. Wie oft und wie lange gewartet wird, hängt vom Fehler ab, sofern Sie es nicht festlegen.

Ändern mitretryUnavailable · retryUnavailableSeconds

Empfangsserver nicht erreichbar

Der Mailserver des Empfängers nimmt überhaupt keine Verbindungen an.

Wir warten, bis er wieder erreichbar ist, ohne Ihre Wiederholungen zu verbrauchen. Ist er nach 24 Stunden immer noch nicht erreichbar, wird die E-Mail als bounced markiert.

Automatisch

Rate Limit

Der Mailbox-Provider (Outlook, Yahoo, AOL…) bittet uns, langsamer zu senden.

Die E-Mail wartet und wird alle 30 Minuten erneut versucht, möglicherweise von einer anderen IP. Standardmäßig versuchen wir es 25 Zyklen lang (etwa 12 Stunden).

Ändern mitretryRateLimited

Wiederholungsoptionen

Sie legen das Limit fest, wir die Obergrenze. Ein Wert außerhalb des Bereichs wird auf den nächstgelegenen erlaubten Wert angepasst, und die Antwort weist in warnings darauf hin. Bei Feldnamen wird die Groß-/Kleinschreibung nicht beachtet: retryRateLimited und retry_rate_limited sind identisch.

  • retryRateLimitedintegeroptional

    Wie viele 30-Minuten-Rate-Limit-Zyklen gewartet wird, bevor aufgegeben wird. 0 gibt beim ersten Rate Limit auf. Verwenden Sie einen niedrigen Wert für zeitkritische E-Mails wie Login-Codes.

    Bereich 0 – 24Standard 25 ZyklenSMTP X-Sendcorex-Retry-Rate-Limited
  • retryUnavailableintegeroptional

    Wie oft nach einem temporären Fehler erneut versucht wird. 0 schlägt beim ersten fehl.

    Bereich 0 – 30Standard Abhängig vom Fehler (bis zu 10)SMTP X-Sendcorex-Retry-Unavailable
  • retryUnavailableSecondsintegeroptional

    Wie viele Sekunden zwischen diesen Versuchen gewartet wird.

    Bereich 10 – 3600Standard Abhängig vom FehlerSMTP X-Sendcorex-Retry-Unavailable-Seconds
  • ignoreHardBouncebooleanoptional

    Auch senden, wenn die Adresse in den letzten 90 Tagen einen Hard Bounce hatte. Ein Versuch pro Adresse; nach 3 Fehlschlägen in 24 Stunden wird die Option 7 Tage lang deaktiviert. Siehe Bekannte Hard Bounces weiter unten.

    Bereich true · falseStandard falseSMTP X-Sendcorex-Ignore-Hard-Bounce

Bekannte Hard Bounces

Hat eine Adresse einen Hard Bounce (das Postfach existiert nicht), merken wir sie uns 90 Tage lang. Erneut an sie zu senden würde nur Ihrer Absenderreputation schaden, daher verbinden wir uns nicht noch einmal mit dem Empfangsserver:

Ohne Hard Bounce Shield

Als bounced markiert

Die E-Mail wird nicht gesendet und als Bounce protokolliert. Sie zählt zu Ihrer Bounce-Rate.

Mit Hard Bounce Shield

Unterdrückt

Die E-Mail wird nicht gesendet und als Suppressed protokolliert. Sie verbraucht einen Credit, zählt aber nicht als Bounce. Sie erhalten trotzdem den Webhook bounced mit suppressed: true, sodass jede E-Mail mit einem abschließenden Event endet.

Postfach voll

Ein volles Postfach ist ein temporärer Fehler, daher wird die Adresse beim ersten Mal nicht gemerkt. Kommt dieselbe Adresse bei 3 E-Mails in Folge als voll zurück, ohne Zustellung dazwischen und mit weniger als 30 Tagen Abstand, behandeln wir sie ab dann als Hard Bounce. Eine erfolgreiche Zustellung setzt den Zähler zurück.

Trotzdem senden

Wenn Sie wissen, dass das Postfach jetzt existiert (der Empfänger hat es korrigiert oder es war ein vorübergehendes Problem auf seiner Seite), setzen Sie ignoreHardBounce: true. Die E-Mail wird normal gesendet. Wird sie zugestellt, wird die Adresse von der Liste entfernt und Sie brauchen die Option für sie nicht mehr.

Limits

Die Option bedeutet „dieses Postfach existiert jetzt“. Stellt sich das als falsch heraus, funktioniert sie nicht mehr:

  • Ein Versuch pro Adresse

    Hat die E-Mail erneut einen Hard Bounce, zählt sie als Bounce, die Adresse wird für weitere 90 Tage gemerkt und die Option wird für diese Adresse bis dahin ignoriert.

  • 3 Fehlschläge in 24 Stunden

    Haben 3 mit der Option gesendete E-Mails erneut einen Hard Bounce, jeweils weniger als 24 Stunden nach der vorherigen, wird die Option für Ihr Konto 7 Tage lang deaktiviert. Ihre E-Mails werden weiter versendet; bekannte Hard Bounces werden wie gewohnt übersprungen.

Wurde die Option ignoriert, beginnt der Reason mit ignore_hard_bounce revoked: und nennt den Grund.

!

Pro E-Mail verwenden, nicht standardmäßig. Mailbox-Provider beobachten, wie oft Sie an nicht existierende Adressen senden. Wenn Sie die Option bei jedem Versand aktivieren, geht der Schutz verloren.

Sende-IP wählen

Mit dedizierten IPs wählen wir anhand der Einstellungen auf Ihrer IP-Seite aus, welche Ihrer IPs jede E-Mail sendet. Um selbst zu entscheiden, setzen Sie sendingIp auf eine Ihrer dedizierten IPs. Die E-Mail wird dann nur von dieser IP gesendet, vom ersten Versuch bis zur letzten Wiederholung.

  • sendingIpstringoptional

    Eine IPv4- oder IPv6-Adresse, die zu Ihren dedizierten IPs gehört und aktiv ist. Jeder andere Wert lehnt die E-Mail ab.

    Standard Durch Ihre IP-Einstellungen gewähltSMTP X-Sendcorex-Sending-IPMCP sending_ip
{
  "to": "customer@example.com",
  "from": "billing@yourdomain.com",
  "senderName": "My App",
  "subject": "Your invoice",
  "body": "<p>Your invoice is ready.</p>",
  "sendingIp": "203.0.113.10"
}

Was überschrieben wird

Diese Einstellungen Ihrer IP-Seite gelten nicht für eine E-Mail, die mit sendingIp gesendet wird. E-Mails ohne diese Angabe folgen ihnen weiterhin.

  • Welche IP sendet

    Normalerweise wechseln wir zwischen Ihren dedizierten IPs ab. Die E-Mail wird stattdessen von der gewählten IP gesendet.

  • IPv4- und IPv6-Routing

    Die IPv4/IPv6-Aufteilung aus Ihren Routing-Einstellungen wird übergangen. Eine IPv6-Adresse sendet über IPv6, eine IPv4-Adresse über IPv4.

  • Failover bei Rate Limit

    Normalerweise wiederholen wir von einer anderen Ihrer dedizierten IPs. Die E-Mail wartet auf der gewählten IP.

  • Blacklist Guard

    Landet die IP auf einer Blacklist, wird die E-Mail nicht auf eine geteilte IP verschoben. Sie wartet auf der gewählten IP.

  • Geplante E-Mails

    Die IP wird mit der E-Mail gespeichert und beim Versand verwendet, auch wenn sich Ihre IP-Einstellungen in der Zwischenzeit ändern.

Fehler

  • API

    400 INVALID_SENDING_IP Der Wert ist keine IP-Adresse oder keine Ihrer aktiven dedizierten IPs. Die E-Mail wird nicht in die Warteschlange gestellt.

  • SMTP

    550 5.7.1 Dieselbe Prüfung für den Header X-Sendcorex-Sending-IP. Die Nachricht wird am Ende von DATA abgelehnt.

  • MCP

    INVALID_SENDING_IP Dieselbe Prüfung für das Argument sending_ip von email_send.

!

Eine feste IP wartet, statt zu wechseln.Bremst der Provider diese IP aus oder landet sie auf einer Blacklist, wartet die E-Mail auf derselben IP, bis sie versendet ist oder die Wiederholungen aufgebraucht sind. Für E-Mails, die nicht warten können, lassen Sie sendingIp weg und überlassen uns die Wahl.

Beispiel

Ein Login-Code ist nach wenigen Minuten nutzlos, lassen Sie ihn also nicht stundenlang warten.

import axios from 'axios';

const response = await axios.post(
  'https://mail.sendcorex.com/v3.0/send',
  {
    to: 'user@example.com',
    from: 'noreply@yourdomain.com',
    senderName: 'My App',
    subject: 'Your login code',
    body: '<p>Your code is <b>482913</b></p>',
    retryRateLimited: 4,         // give up after 4 rate-limit cycles (~2 h)
    retryUnavailable: 5,         // up to 5 retries on temporary errors
    retryUnavailableSeconds: 30, // 30 s between them
    ignoreHardBounce: true,      // send even if this address hard bounced before
  },
  {
    headers: { Authorization: process.env.SENDCOREX_API_KEY },
  }
);

console.log(response.data.id, response.data.warnings);

Antwort mit angepasstem Wert

Hier wurde retryRateLimited mit 40 gesendet. Die E-Mail wird trotzdem in die Warteschlange gestellt, mit 24.

200

E-Mail in die Warteschlange gestellt, mit Warnung

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "ids": [
    { "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
  ],
  "recipients": 1,
  "scheduledAt": null,
  "warnings": ["retry_rate_limited 40 → 24"]
}

SMTP-Header

Sie senden über SMTP? Fügen Sie dieselben Optionen als Header hinzu. Wir lesen sie aus und entfernen sie vor der Zustellung, sodass der Empfänger sie nie sieht.

X-Sendcorex-Retry-Rate-Limited: 4
X-Sendcorex-Retry-Unavailable: 5
X-Sendcorex-Retry-Unavailable-Seconds: 30
X-Sendcorex-Ignore-Hard-Bounce: true
X-Sendcorex-Sending-IP: 203.0.113.10

Webhook-Events

Verfolgen Sie Wiederholungen in Echtzeit mit diesen Webhook-Events:

  • retrying

    Ein temporärer Fehler ist aufgetreten und die E-Mail wird erneut versucht. Der Reason gibt an, um welchen Versuch es sich handelt.

  • failed

    Wir haben aufgegeben, nachdem die Wiederholungen oder die Rate-Limit-Zyklen aufgebraucht waren.

  • bounced

    Der Empfangsserver hat die E-Mail endgültig abgelehnt oder war 24 Stunden lang nicht erreichbar. Wird auch gesendet, wenn wir einen bekannten Hard Bounce überspringen, mit suppressed: true, wenn Sie den Hard Bounce Shield haben.