Een webhook-handler heeft tests nodig voor mislukte aflevering én voor succes. Een test die stopt bij het verzendantwoord kan niet bevestigen hoe je applicatie het latere event afhandelt.
Magic destinations laten je die resultaten doorlopen zonder een echte inbox of telefoon te bereiken. Requestvalidatie blijft van toepassing, dus ze leggen ook onjuist opgebouwde verzendingen bloot.
Hoe verstuur ik een testrequest?
Verstuur naar een herkende magic destination met je normale API-credentials en -endpoint.
Er is geen testmodus om in te schakelen. Gebruik voor e-mail een gedocumenteerd adres op messagebird.dev. Gebruik voor SMS een van de onderstaande nummers.
Gesimuleerde ontvangers volgen de normale event- en signed-webhook-paden. Ze testen geen aflevering aan externe infrastructuur. Ze kunnen daarom geen echte inbox-plaatsing of weergave op het toestel verifiëren.
Gebruik alleen herkende magic destinations als een test niemand mag bereiken. Een request kan gesimuleerde en echte ontvangers combineren. Echte ontvangers worden normaal afgeleverd.
Welke e-mailadressen moet ik gebruiken?
Gebruik delivered@messagebird.dev om acceptatie door de ontvangende server te testen. De overige adressen hieronder oefenen bounce-, klacht- en afwijzingsafhandeling.
| Adres | Resultaat |
|---|---|
delivered@messagebird.dev | De ontvangende server accepteert het bericht. |
bounce@messagebird.dev of hardbounce@messagebird.dev | Een hard bounce met SMTP 550; test afhandeling van permanente fouten. |
softbounce@messagebird.dev | Een soft bounce met SMTP 451; test classificatie van tijdelijke fouten. |
deferred@messagebird.dev of delay@messagebird.dev | Een uitstel zonder daaropvolgende gesimuleerde retry. |
complaint@messagebird.dev of spam@messagebird.dev | Een spamklacht. |
suppressed@messagebird.dev | Afwijzing als al onderdrukte ontvanger, zonder verwerkings- of afleverevents. |
reject@messagebird.dev | Afwijzing vóór een afleverpoging. |
Matching negeert hoofdletters. Het verwijdert +label voordat het resultaat wordt geselecteerd. Bijvoorbeeld: bounce+signup-flow@messagebird.dev bounced nog steeds. Het volledige adres blijft in events staan, zodat je ze met die test kunt associëren.
Alleen de gedocumenteerde namen op dat domein zijn magic. bounce@yourdomain.com is een normale ontvanger, net als een niet-herkende naam op messagebird.dev.
Gesimuleerde bounces en klachten voegen geen adressen toe aan de suppressielijst van Bird en beïnvloeden de verzendreputatie niet. Je applicatie ontvangt hun events nog steeds, dus controleer hoe je eigen suppressielogica ze afhandelt.
Test e-mailaflevering beschrijft de volledige eventreeksen en matchingregels.
Welke telefoonnummers moet ik gebruiken?
Gebruik +15005550006 om succesvolle SMS-aflevering te testen. De overige nummers hieronder oefenen afwijzings- en foutpaden.
| Bestemming | Resultaat |
|---|---|
+15005550001 | Afwijzing bij indienen met invalid_destination. |
+15005550002 | sms.sent, daarna sms.undelivered met unreachable. |
+15005550003 | sms.sent, daarna sms.failed met provider_unavailable. |
+15005550004 | sms.sent, daarna sms.failed met blocked_by_carrier. |
+15005550006 | sms.sent, daarna sms.delivered. |
+15005550009 | sms.sent, daarna sms.failed met recipient_opted_out. |
Schakel de Verenigde Staten in onder Bestemmingen. Gebruik een from-afzender die geldig is voor de VS. Een alfanumerieke afzender wordt daar afgewezen en kan deze nummers dus niet succesvol testen.
Een verzending naar +15005550006 kan je success-handler testen. Gebruik +15005550002 om het afzonderlijke onbezorgd-pad te controleren. De SMS-migratiehandleiding bevat een smoke-testreeks.
Wat kost testen of wat verandert het?
Gesimuleerde verzendingen gebruiken echte tegoeden en kunnen je statistieken beïnvloeden.
Een SMS naar een magic number wordt gefactureerd tegen het normale tarief van de bestemming. Beperk herhaalde tests, want elke gesimuleerde verzending kan kosten met zich meebrengen.
Een gesimuleerde e-mailontvanger telt mee voor je verzendtegoed. Sandbox-e-mailverkeer komt ook in geaggregeerde statistieken terecht, waaronder bounce- en klachtpercentages. Scheid het in je analyse, zodat testfouten niet op klantafleverproblemen lijken.
Hoe herken ik een testresultaat?
Koppel het event aan de testontvanger of bericht-ID die je bij het verzenden hebt vastgelegd.
Een geaccepteerde gesimuleerde e-mail retourneert 202 en normale eventvormen. Er is geen testvlag in de payload. Acceptatie alleen identificeert een test daarom niet.
Gebruik een ontvangerlabel zoals bounce+signup-flow@messagebird.dev om e-mailevents aan een run te koppelen. Je kunt ook de tijdlijn of events API van het e-mailbericht bekijken zonder een webhook-ontvanger te beheren.
Houd een echte-aflevercontrole apart als je weergave of ontvangst wilt verifiëren. Magic destinations testen die delen van het afleverpad niet.
Kort gezegd
De bestemming bepaalt het testresultaat.
Gebruik je normale API-sleutel en -endpoints. Herkende adressen en nummers activeren gesimuleerde afleverresultaten.
Beperk tests tot bekende magic destinations.
Een request kan gesimuleerde en echte ontvangers combineren. Niet-herkende adressen worden als normale ontvangers behandeld.
Testen gebruikt echte tegoeden.
Gesimuleerde e-mailontvangers gebruiken verzendtegoed. SMS magic numbers worden gefactureerd tegen het normale tarief van de bestemming.
Leg vast welke berichten bij een test horen.
Events hebben geen testvlag. E-maillabels blijven in ontvangstadressen staan, zodat je een testrun in de events kunt herkennen.