Supresión de direcciones de correo electrónico
El canal de correo electrónico de la Messages API de Vonage incluye una función de supresión automática que está activada de forma predeterminada para todos los clientes. La supresión garantiza que las direcciones de correo electrónico identificadas como no válidas o propensas a generar reclamaciones se añadan a la lista de supresión y que nunca se vuelvan a enviar mensajes a dichas direcciones. Cualquier envío bloqueado se registra como un evento de entrega rechazado con el código de error 2003, lo que te permite mantener intacta tu reputación como remitente y proporcionar información precisa sobre el estado del envío a cada destinatario.
Por qué es importante la supresión
El envío de correos electrónicos a direcciones no válidas o propensas a generar quejas perjudica tu reputación como remitente ante los ISP y los proveedores de correo electrónico. Una reputación deteriorada hace que los correos electrónicos legítimos sean marcados como spam o bloqueados directamente.
La función de supresión protege contra esto de la siguiente manera:
- Evitar los intentos de entrega a direcciones que se sabe que son incorrectas antes de que lleguen a los proveedores de servicios de Internet.
- Registrar automáticamente las nuevas direcciones erróneas a medida que se detectan a través de la información sobre las entregas.
- Garantizar que sigas recibiendo información precisa sobre el estado de la entrega de los destinatarios excluidos, en lugar de que se produzca un error silencioso.
Cómo funciona la supresión
La supresión funciona en dos sentidos: comprobando las supresiones existentes antes de un envío y añadiendo nuevas direcciones a la lista de supresión en función de la información de entrega.
Comprobación de la supresión antes del envío
Cada vez que se recibe una solicitud de envío de correo electrónico, se comprueba si alguno de los destinatarios (Para, CC y CCO) figura en la lista de exclusión antes de que el correo se envíe al proveedor. Esto se realiza de forma automática, sin que sea necesario configurar la cuenta.
Hay tres resultados posibles:
Escenario A: no se excluye a ningún destinatario
Todos los destinatarios están correctos. El correo electrónico se envía con normalidad y recibes un ID de mensaje del proveedor que confirma el envío.
Escenario B — Se excluyen algunos destinatarios (exclusión parcial)
Uno o más destinatarios figuran en la lista de exclusión, pero al menos uno no está incluido en ella.
- Los destinatarios ocultos se eliminan del envío.
- El correo electrónico se envía a los destinatarios activos restantes.
- Se publica un aviso de supresión para cada destinatario bloqueado — rechazado con el código de error 2003 — así podrás ver el estado exacto de la entrega de cada destinatario, incluidos aquellos a los que no se les envió nada.
- Recibes el mismo identificador de mensaje del proveedor, que abarca tanto a los destinatarios a los que se ha enviado el mensaje como a los que han sido excluidos.
Escenario C — Se excluyen todos los destinatarios
Todos los destinatarios de los campos «Para», «CC» y «CCO» figuran en la lista de exclusión.
- El correo electrónico no se ha enviado.
- Se publica un evento de supresión para cada destinatario — rechazado con el código de error 2003.
- Recibirás un identificador de mensaje válido del proveedor, que no se puede distinguir de un envío real, por lo que tus sistemas podrán realizar el seguimiento del mensaje con normalidad.
Añadir direcciones a la lista de exclusión
El proveedor de correo electrónico envía eventos de retroalimentación sobre la entrega (mensajes devueltos y reclamaciones) al motor de correo electrónico de Vonage. Estos eventos se procesan para mantener actualizada la lista de supresión.
El tipo de lista de exclusión a la que se añade una dirección depende del evento recibido:
| Tipo de evento | Ámbito de supresión | Añadido a la lista de supresión |
|---|---|---|
| Rebote definitivo | Global | Sí |
| Queja / Denuncia de spam | Por Account + identidad | Sí |
| Otras reclamaciones (detección de virus, correcciones de mensajes no considerados spam, errores de DKIM) | N/A | No |
Referencia sobre los tipos de supresión
La siguiente tabla establece una correspondencia entre los eventos de retroalimentación sobre la entrega de los proveedores y los códigos de error de la Messages API de Vonage, e indica si el evento da lugar a una supresión.
| Tipo de rebote | Código de motivo de Vonage | Descripción | Estado | Código de error | Añadido a la lista de supresión |
|---|---|---|---|---|---|
| Rebote definitivo | RECIPIENT_BLOCKED |
La dirección figura en la lista de bloqueo de la plataforma. | Rechazado | 2003 | Sí (global) |
| Rebote definitivo | RECIPIENT_MISSING |
La dirección de correo electrónico no existe | Rechazado | 1170 | Sí (global) |
| Rebote definitivo | ACCOUNT_BLOCKED |
La dirección figura en la lista de exclusiones de esta cuenta. | Rechazado | 2003 | Sí (global) |
| Rebote suave | MAILBOX_FULL |
El buzón del destinatario está temporalmente lleno | Rechazado | 1180 | No |
| Rebote suave | CONTENT_TOO_LARGE |
El mensaje era demasiado grande para enviarlo | Rechazado | 2002 | No |
| Rebote suave | ATTACHMENT_REJECTED |
El servidor receptor ha rechazado el archivo adjunto | Rechazado | 1382 | No |
| Rebote suave | GATEWAY_TIMEOUT |
Se ha agotado el tiempo de espera de la entrega mientras se esperaba al servidor receptor | Rechazado | 1230 | No |
| Rebote suave | CONTENT_REJECTED |
El contenido ha sido rechazado por el servidor receptor | Rechazado | 1282 | No |
| Rebote definitivo | UNKNOWN |
Rebote sin clasificar | Rechazado | 1330 | Sí (global) |
| Queja | USER_SPAM_REPORT |
El destinatario ha marcado el correo electrónico como spam | No enviado | N/A | Sí (por Account + identidad) |
| Queja | OTHER_FEEDBACK |
Comentarios generales sobre reclamaciones | Rechazado | - | Sí (por Account + identidad) |
| Queja | FRAUD_ALERT |
Correo electrónico marcado como posible fraude | Rechazado | 2001 | No |
| Queja | AUTH_FAILURE |
DKIM / Problema con la autenticación del correo electrónico | Rechazado | 1484 | No |
| Queja | NOT_SPAM_CORRECTION |
El destinatario ha corregido una clasificación errónea de spam | N/A | N/A | No |
| Queja | VIRUS_DETECTED |
Correo electrónico marcado por contener un virus | Rechazado | 1282 | No |
Nota: Vonage siempre envía los eventos rechazados a tu webhook con un código de error 2003 por cada envío de correo electrónico suprimido.
Estado de entrega para destinatarios excluidos
Cuando se excluye a un destinatario, el motor de correo electrónico genera un evento sintético de rebote o de reclamación que reproduce el formato de un evento real del proveedor. Esto significa que:
- Los sistemas posteriores (por ejemplo, el conector de correo electrónico y los webhooks) reciben una actualización de estado correctamente estructurada para cada destinatario, independientemente de si se les ha enviado realmente el mensaje o no.
- Puedes realizar un seguimiento del resultado completo de cada mensaje sin necesidad de aplicar ningún tratamiento especial a los casos suprimidos.