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.
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).
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.
retryUnavailable · retryUnavailableSecondsEmpfangsserver 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.
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).
retryRateLimitedWiederholungsoptionen
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.
retryRateLimitedintegeroptionalWie 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.
Bereich0 – 24Standard 25 ZyklenSMTPX-Sendcorex-Retry-Rate-LimitedretryUnavailableintegeroptionalWie oft nach einem temporären Fehler erneut versucht wird. 0 schlägt beim ersten fehl.
Bereich0 – 30Standard Abhängig vom Fehler (bis zu 10)SMTPX-Sendcorex-Retry-UnavailableretryUnavailableSecondsintegeroptionalWie viele Sekunden zwischen diesen Versuchen gewartet wird.
Bereich10 – 3600Standard Abhängig vom FehlerSMTPX-Sendcorex-Retry-Unavailable-SecondsignoreHardBouncebooleanoptionalAuch 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.
Bereichtrue · falseStandard falseSMTPX-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.
sendingIpstringoptionalEine 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ähltSMTPX-Sendcorex-Sending-IPMCPsending_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_IPDer Wert ist keine IP-Adresse oder keine Ihrer aktiven dedizierten IPs. Die E-Mail wird nicht in die Warteschlange gestellt.SMTP
550 5.7.1Dieselbe Prüfung für den Header X-Sendcorex-Sending-IP. Die Nachricht wird am Ende von DATA abgelehnt.MCP
INVALID_SENDING_IPDieselbe 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.
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.