Un handler de webhooks necesita pruebas tanto de entregas fallidas como exitosas. Una prueba que se detiene en la respuesta de envío no puede confirmar cómo tu aplicación maneja el evento posterior.
Los destinos mágicos te permiten ejercitar esos resultados sin llegar a una bandeja de entrada o un dispositivo real. La validación de la solicitud sigue aplicándose, así que también exponen envíos mal formados.
¿Cómo envío una solicitud de prueba?
Envía a un destino mágico reconocido usando tus credenciales y endpoint normales de API.
No hay un modo de prueba que activar. Para email, usa una dirección documentada en messagebird.dev. Para SMS, usa uno de los números de abajo.
Los destinatarios simulados siguen las rutas normales de eventos y webhooks firmados. No ejercitan la entrega a infraestructura externa. Por lo tanto, no pueden verificar la colocación real en la bandeja de entrada ni la visualización en el dispositivo.
Usa solo destinos mágicos reconocidos cuando una prueba no deba contactar a nadie. Una solicitud puede mezclar destinatarios simulados y reales. Los destinatarios reales se entregan con normalidad.
¿Qué direcciones de email debo usar?
Usa delivered@messagebird.dev para probar la aceptación por parte del servidor receptor. Las demás direcciones de abajo ejercitan el manejo de rebotes, quejas y rechazos.
| Dirección | Resultado |
|---|---|
delivered@messagebird.dev | El servidor receptor acepta el mensaje. |
bounce@messagebird.dev o hardbounce@messagebird.dev | Un rebote duro con SMTP 550; prueba el manejo de fallos permanentes. |
softbounce@messagebird.dev | Un rebote suave con SMTP 451; prueba la clasificación de fallos temporales. |
deferred@messagebird.dev o delay@messagebird.dev | Un aplazamiento sin reintento simulado posterior. |
complaint@messagebird.dev o spam@messagebird.dev | Una queja de spam. |
suppressed@messagebird.dev | Rechazo como destinatario ya suprimido, sin eventos de procesamiento ni de entrega. |
reject@messagebird.dev | Rechazo antes de un intento de entrega. |
La coincidencia ignora mayúsculas y minúsculas. Elimina +label antes de seleccionar el resultado. Por ejemplo, bounce+signup-flow@messagebird.dev sigue generando un rebote. La dirección completa permanece en los eventos para que puedas asociarlos con esa prueba.
Solo los nombres documentados en ese dominio son mágicos. bounce@yourdomain.com es un destinatario normal, igual que un nombre no reconocido en messagebird.dev.
Los rebotes y quejas simulados no añaden direcciones a la lista de supresión de Bird ni afectan la reputación de envío. Tu aplicación sigue recibiendo sus eventos, así que verifica cómo tu propia lógica de supresión los maneja.
Probar la entrega de email lista las secuencias completas de eventos y las reglas de coincidencia.
¿Qué números de teléfono debo usar?
Usa +15005550006 para probar la entrega exitosa de SMS. Los demás números de abajo ejercitan las rutas de rechazo y fallo.
| Destino | Resultado |
|---|---|
+15005550001 | Rechazo de envío con invalid_destination. |
+15005550002 | sms.sent, luego sms.undelivered con unreachable. |
+15005550003 | sms.sent, luego sms.failed con provider_unavailable. |
+15005550004 | sms.sent, luego sms.failed con blocked_by_carrier. |
+15005550006 | sms.sent, luego sms.delivered. |
+15005550009 | sms.sent, luego sms.failed con recipient_opted_out. |
Habilita Estados Unidos en Destinos. Usa un remitente from válido para EE. UU. Un remitente alfanumérico se rechaza allí, por lo que no puede probar estos números con éxito.
Un envío a +15005550006 puede probar tu handler de éxito. Usa +15005550002 para verificar la ruta separada de no entregado. La guía de migración de SMS incluye una secuencia de prueba de humo.
¿Cuánto cuesta o qué cambia una prueba?
Los envíos simulados consumen cuotas reales y pueden afectar tus estadísticas.
Un SMS a un número mágico se factura a la tarifa normal del destino. Limita las pruebas repetidas porque cada envío simulado puede generar un cargo.
Un destinatario de email simulado cuenta contra tu cuota de envío. El tráfico de sandbox de email también se incluye en las estadísticas agregadas, incluidas las tasas de rebote y queja. Sepáralo en tu análisis para que los fallos de prueba no parezcan problemas de entrega a clientes.
¿Cómo identifico un resultado de prueba?
Asocia el evento con el destinatario de prueba o el identificador de mensaje que registraste al enviar.
Un email simulado aceptado devuelve 202 y estructuras de eventos normales. No hay indicador de prueba en el payload. La aceptación por sí sola no identifica una prueba.
Usa una etiqueta de destinatario como bounce+signup-flow@messagebird.dev para asociar eventos de email con una ejecución. También puedes consultar la línea de tiempo o los eventos del mensaje de email API sin operar un receptor de webhooks.
Mantén una verificación de entrega real por separado cuando necesites comprobar la visualización o la recepción. Los destinos mágicos no prueban esas partes de la ruta de entrega.
En resumen
El destino selecciona el resultado de la prueba.
Usa tu clave y endpoints normales de API. Las direcciones y números reconocidos activan resultados de entrega simulados.
Limita las pruebas a destinos mágicos conocidos.
Una solicitud puede mezclar destinatarios simulados y reales. Las direcciones no reconocidas se tratan como destinatarios normales.
Las pruebas consumen cuotas reales.
Los destinatarios de email simulados consumen cuota de envío. Los números mágicos de SMS se facturan a la tarifa normal del destino.
Registra qué mensajes pertenecen a una prueba.
Los eventos no tienen indicador de prueba. Las etiquetas de email permanecen en las direcciones de destinatario, lo que te permite identificar una ejecución de prueba en sus eventos.