Un handler di webhook ha bisogno di test per la consegna fallita oltre che per il successo. Un test che si ferma alla risposta di invio non può confermare come la tua applicazione gestisce l'evento successivo.
Le destinazioni magic ti permettono di esercitare quegli esiti senza raggiungere una casella di posta o un dispositivo reale. La validazione della richiesta resta attiva, quindi espongono anche invii malformati.
Come invio una richiesta di test?
Invia a una destinazione magic riconosciuta usando le tue normali credenziali e il tuo normale endpoint API.
Non c'è una modalità di test da attivare. Per le email, usa un indirizzo documentato su messagebird.dev. Per SMS, usa uno dei numeri qui sotto.
I destinatari simulati seguono i normali percorsi di evento e webhook firmato. Non esercitano la consegna verso infrastruttura esterna. Non possono quindi verificare il posizionamento reale nella casella di posta o il rendering sul dispositivo.
Usa solo destinazioni magic riconosciute quando un test non deve contattare nessuno. Una richiesta può mescolare destinatari simulati e reali. I destinatari reali vengono consegnati normalmente.
Quali indirizzi email devo usare?
Usa delivered@messagebird.dev per testare l'accettazione da parte del server ricevente. Gli altri indirizzi qui sotto esercitano la gestione di bounce, complaint e rifiuto.
| Indirizzo | Esito |
|---|---|
delivered@messagebird.dev | Il server ricevente accetta il messaggio. |
bounce@messagebird.dev o hardbounce@messagebird.dev | Un hard bounce con SMTP 550; testa la gestione degli errori permanenti. |
softbounce@messagebird.dev | Un soft bounce con SMTP 451; testa la classificazione degli errori temporanei. |
deferred@messagebird.dev o delay@messagebird.dev | Un rinvio senza successivo tentativo simulato. |
complaint@messagebird.dev o spam@messagebird.dev | Una segnalazione di spam. |
suppressed@messagebird.dev | Rifiuto come destinatario già soppresso, senza eventi di elaborazione o consegna. |
reject@messagebird.dev | Rifiuto prima di un tentativo di consegna. |
Il matching ignora le maiuscole. Rimuove +label prima di selezionare l'esito. Ad esempio, bounce+signup-flow@messagebird.dev produce comunque un bounce. L'indirizzo completo resta negli eventi, così puoi associarli a quel test.
Solo i nomi documentati su quel dominio sono magic. bounce@yourdomain.com è un destinatario normale, così come un nome non riconosciuto su messagebird.dev.
I bounce e le complaint simulati non aggiungono indirizzi alla lista di soppressione di Bird e non influiscono sulla reputazione di invio. La tua applicazione riceve comunque i loro eventi, quindi verifica come la tua logica di soppressione li gestisce.
Testa la consegna email elenca le sequenze di eventi complete e le regole di matching.
Quali numeri di telefono devo usare?
Usa +15005550006 per testare la consegna SMS con successo. Gli altri numeri qui sotto esercitano i percorsi di rifiuto e di errore.
| Destinazione | Esito |
|---|---|
+15005550001 | Rifiuto dell'invio con invalid_destination. |
+15005550002 | sms.sent, poi sms.undelivered con unreachable. |
+15005550003 | sms.sent, poi sms.failed con provider_unavailable. |
+15005550004 | sms.sent, poi sms.failed con blocked_by_carrier. |
+15005550006 | sms.sent, poi sms.delivered. |
+15005550009 | sms.sent, poi sms.failed con recipient_opted_out. |
Abilita gli Stati Uniti sotto Destinations. Usa un mittente from valido per gli US. Un mittente alfanumerico viene rifiutato lì, quindi non può testare questi numeri con successo.
Un invio a +15005550006 può testare il tuo handler di successo. Usa +15005550002 per verificare il percorso separato di mancata consegna. La guida alla migrazione SMS include una sequenza di smoke test.
Quanto costa o cosa cambia un test?
Gli invii simulati consumano le quote reali e possono influire sulle tue statistiche.
Un SMS verso un magic number viene fatturato alla tariffa normale della destinazione. Limita i test ripetuti perché ogni invio simulato può comportare un addebito.
Un destinatario email simulato conta come consumo della tua quota di invio. Il traffico sandbox email entra anche nelle statistiche aggregate, incluse le percentuali di bounce e complaint. Separalo nella tua analisi, così gli errori di test non sembreranno problemi di consegna verso i clienti.
Come identifico un risultato di test?
Associa l'evento al destinatario di test o all'identificativo del messaggio che hai registrato al momento dell'invio.
Un'email simulata accettata restituisce 202 e le normali strutture di evento. Non c'è un flag di test nel payload. La sola accettazione quindi non identifica un test.
Usa una label del destinatario come bounce+signup-flow@messagebird.dev per associare gli eventi email a un'esecuzione. Puoi anche leggere la timeline o gli eventi API del messaggio email senza gestire un receiver di webhook.
Mantieni separato un controllo di consegna reale quando devi verificare il rendering o la ricezione. Le destinazioni magic non testano quelle parti del percorso di consegna.
In breve
La destinazione seleziona l'esito del test.
Usa la tua normale chiave e i normali endpoint API. Indirizzi e numeri riconosciuti attivano risultati di consegna simulata.
Limita i test alle destinazioni magic conosciute.
Una richiesta può mescolare destinatari simulati e reali. Gli indirizzi non riconosciuti vengono trattati come destinatari normali.
I test consumano le quote reali.
I destinatari email simulati consumano la quota di invio. I magic number SMS vengono fatturati alla tariffa normale della destinazione.
Registra quali messaggi appartengono a un test.
Gli eventi non hanno un flag di test. Le label email restano negli indirizzi dei destinatari, permettendoti di identificare un'esecuzione di test nei suoi eventi.