Ein Webhook-Handler braucht Tests für fehlgeschlagene Zustellung ebenso wie für Erfolg. Ein Test, der bei der Sendeantwort endet, kann nicht bestätigen, wie Ihre Anwendung das spätere Event verarbeitet.
Magic Destinations ermöglichen es, diese Ergebnisse zu testen, ohne eine echte Inbox oder ein Endgerät zu erreichen. Die Anfrage-Validierung greift weiterhin, sodass auch fehlerhafte Sends aufgedeckt werden.
Wie sende ich eine Testanfrage?
Senden Sie an eine erkannte Magic Destination mit Ihren normalen API-Anmeldedaten und dem regulären Endpunkt.
Es gibt keinen Testmodus, den Sie aktivieren müssten. Für E-Mail verwenden Sie eine dokumentierte Adresse auf messagebird.dev. Für SMS verwenden Sie eine der unten aufgeführten Nummern.
Simulierte Empfänger durchlaufen die normalen Event- und Signed-Webhook-Pfade. Sie testen keine Zustellung an externe Infrastruktur. Sie können daher weder echte Inbox-Platzierung noch Darstellung auf Endgeräten verifizieren.
Verwenden Sie ausschließlich erkannte Magic Destinations, wenn ein Test niemanden kontaktieren darf. Eine Anfrage kann simulierte und echte Empfänger mischen. Echte Empfänger werden normal zugestellt.
Welche E-Mail-Adressen sollte ich verwenden?
Verwenden Sie delivered@messagebird.dev, um die Annahme durch den Empfangsserver zu testen. Die weiteren Adressen unten testen Bounce-, Beschwerde- und Ablehnungsbehandlung.
| Adresse | Ergebnis |
|---|---|
delivered@messagebird.dev | Der Empfangsserver nimmt die Nachricht an. |
bounce@messagebird.dev oder hardbounce@messagebird.dev | Ein Hard Bounce mit SMTP 550; testet die Behandlung permanenter Fehler. |
softbounce@messagebird.dev | Ein Soft Bounce mit SMTP 451; testet die Klassifizierung temporärer Fehler. |
deferred@messagebird.dev oder delay@messagebird.dev | Eine Verzögerung ohne anschließenden simulierten Retry. |
complaint@messagebird.dev oder spam@messagebird.dev | Eine Spam-Beschwerde. |
suppressed@messagebird.dev | Ablehnung als bereits unterdrückter Empfänger, ohne Verarbeitungs- oder Zustell-Events. |
reject@messagebird.dev | Ablehnung vor einem Zustellversuch. |
Beim Abgleich wird Groß-/Kleinschreibung ignoriert. +label wird vor der Ergebnisauswahl entfernt. Zum Beispiel erzeugt bounce+signup-flow@messagebird.dev weiterhin einen Bounce. Die vollständige Adresse bleibt in den Events erhalten, sodass Sie sie dem jeweiligen Test zuordnen können.
Nur die dokumentierten Namen auf dieser Domain sind Magic Destinations. bounce@yourdomain.com ist ein normaler Empfänger, ebenso ein nicht erkannter Name auf messagebird.dev.
Simulierte Bounces und Beschwerden fügen der Unterdrückungsliste von Bird keine Adressen hinzu und beeinflussen die Sende-Reputation nicht. Ihre Anwendung empfängt deren Events trotzdem – prüfen Sie daher, wie Ihre eigene Unterdrückungslogik damit umgeht.
E-Mail-Zustellung testen listet die vollständigen Event-Sequenzen und Abgleichregeln auf.
Welche Telefonnummern sollte ich verwenden?
Verwenden Sie +15005550006, um eine erfolgreiche SMS-Zustellung zu testen. Die weiteren Nummern unten testen Ablehnungs- und Fehlerpfade.
| Ziel | Ergebnis |
|---|---|
+15005550001 | Ablehnung bei Übermittlung mit invalid_destination. |
+15005550002 | sms.sent, dann sms.undelivered mit unreachable. |
+15005550003 | sms.sent, dann sms.failed mit provider_unavailable. |
+15005550004 | sms.sent, dann sms.failed mit blocked_by_carrier. |
+15005550006 | sms.sent, dann sms.delivered. |
+15005550009 | sms.sent, dann sms.failed mit recipient_opted_out. |
Aktivieren Sie die Vereinigten Staaten unter Destinations. Verwenden Sie einen für die USA gültigen from-Absender. Ein alphanumerischer Absender wird dort abgelehnt und kann diese Nummern daher nicht erfolgreich testen.
Ein Send an +15005550006 kann Ihren Erfolgs-Handler testen. Verwenden Sie +15005550002, um den separaten Pfad für nicht zugestellte Nachrichten zu prüfen. Der SMS-Migrationsleitfaden enthält eine Smoke-Test-Sequenz.
Was kostet das Testen und was ändert es?
Simulierte Sends verbrauchen echte Kontingente und können Ihre Statistiken beeinflussen.
Ein SMS an eine Magic Number wird zum normalen Tarif des Ziellands abgerechnet. Beschränken Sie wiederholte Tests, da jeder simulierte Send Kosten verursachen kann.
Ein simulierter E-Mail-Empfänger wird auf Ihr Sendekontingent angerechnet. Sandbox-E-Mail-Traffic fließt außerdem in die aggregierten Statistiken ein, einschließlich Bounce- und Beschwerderaten. Trennen Sie ihn in Ihrer Analyse, damit Testfehler nicht wie Zustellprobleme bei Kunden aussehen.
Wie identifiziere ich ein Testergebnis?
Ordnen Sie das Event dem Testempfänger oder der Nachrichten-ID zu, die Sie beim Senden erfasst haben.
Eine angenommene simulierte E-Mail gibt 202 und normale Event-Strukturen zurück. Im Payload gibt es kein Test-Flag. Allein die Annahme identifiziert daher keinen Test.
Verwenden Sie ein Empfänger-Label wie bounce+signup-flow@messagebird.dev, um E-Mail-Events einem Testlauf zuzuordnen. Sie können auch die Timeline oder die Events API der E-Mail-Nachricht lesen, ohne einen Webhook-Empfänger zu betreiben.
Führen Sie einen echten Zustellungscheck separat durch, wenn Sie Darstellung oder Empfang verifizieren müssen. Magic Destinations testen diese Teile des Zustellpfads nicht.
Kurz gesagt
Die Zieladresse bestimmt das Testergebnis.
Verwenden Sie Ihren normalen API-Schlüssel und die regulären Endpunkte. Erkannte Adressen und Nummern lösen simulierte Zustellergebnisse aus.
Beschränken Sie Tests auf bekannte Magic Destinations.
Eine Anfrage kann simulierte und echte Empfänger mischen. Nicht erkannte Adressen werden als normale Empfänger behandelt.
Tests verbrauchen echte Kontingente.
Simulierte E-Mail-Empfänger verbrauchen Sendekontingent. SMS-Magic-Numbers werden zum normalen Tarif des Ziellands abgerechnet.
Halten Sie fest, welche Nachrichten zu einem Test gehören.
Events enthalten kein Test-Flag. E-Mail-Labels bleiben in den Empfängeradressen erhalten, sodass Sie einen Testlauf in seinen Events identifizieren können.