Este tema describe cómo configurar las notificaciones asíncronas. Estas notificaciones solo están disponibles para los usuarios actuales de esta función. Si no ha utilizado previamente las notificaciones asíncronas, use la nueva función "Event Publishing": Set up event distribution.
Después de enviar una solicitud de correo electrónico mediante el servidor DirectMail, los resultados de entrega se envían al terminal receptor (HTTP, cola de mensajes o tema) del servicio de mensajes, según las reglas de notificación de eventos que haya establecido en Message Service. Puede obtener los resultados de entrega de forma asíncrona mediante los terminales receptores de Message Service.
Para configurar las notificaciones asíncronas, primero active Message Service. Este servicio puede generar costos adicionales.
Para establecer las notificaciones asíncronas, debe crear reglas de notificación de eventos en la consola de Message Service y luego crear las notificaciones asíncronas en la consola de DirectMail. Por lo tanto, es necesario habilitar Message Service, lo cual puede implicar cargos.
Use la cuenta principal de Alibaba Cloud para configurar las notificaciones asíncronas. Actualmente, Message Service no admite RAM.
Creación de reglas de notificación de eventos
Se recomienda crear primero una cola de recepción de mensajes antes de definir una regla de notificación que funcione como terminal receptor.
Creación de la cola de recepción de mensajes
Inicie sesión en la consola de Message Service.
En el panel de navegación izquierdo, haga clic en Queues.
Haga clic en el botón Create Queue en la página; aparecerá un cuadro de diálogo.
Ingrese el nombre de la cola, conserve los valores predeterminados en los demás campos y haga clic en OK.
Creación de reglas de notificación de eventos
En el panel de navegación izquierdo de la consola de Message Service, haga clic en Event Notifications.
Haga clic en el botón Create Rule en la página; aparecerá un cuadro de diálogo.
Verifique la región y el nombre del producto, ingrese el nombre de la regla, seleccione el tipo de evento, agregue el terminal receptor y haga clic en OK. Actualmente, el sistema admite dos tipos de terminales receptores (HTTP y Queue). Seleccione la cola de recepción de mensajes creada previamente como terminal receptor.
Nota: Por lo general, la regla recién creada tarda hasta 10 minutos en surtir efecto.
Consulte la referencia de "Event type" a continuación.
Creación de notificaciones asíncronas
Las notificaciones asíncronas se dividen en notificaciones a nivel de cuenta y a nivel de dirección de correo electrónico. Si desea implementar notificaciones asíncronas sobre los resultados de entrega para todas las direcciones de remitente, configure las notificaciones a nivel de cuenta. Si prefiere recibir notificaciones específicas para ciertas direcciones de correo electrónico, establezca las notificaciones a nivel de dirección para esos remitentes en particular. También es posible configurar ambos niveles simultáneamente. Las notificaciones a nivel de dirección tienen mayor prioridad que las de nivel de cuenta. Los remitentes especificados reciben las notificaciones a nivel de dirección, mientras que el resto obtiene las notificaciones a nivel de cuenta. Esto le permite enviar notificaciones de cuentas específicas a distintos terminales de recepción de mensajes.
Creación de notificaciones asíncronas a nivel de cuenta
Inicie sesión en la consola de DirectMail.
En el panel de navegación izquierdo, haga clic en Asynchronous Notifications.
Haga clic en el botón New Account-level Asynchronous Notifications en la página.
Seleccione la región y haga clic en OK.
Creación de notificaciones asíncronas a nivel de dirección de correo electrónico
Haga clic en Email Address-level Asynchronous Notification en la página Asynchronous Notifications.
Haga clic en el botón New Address-level Asynchronous Notifications en la página.
-
Seleccione la dirección del remitente y la región, y haga clic en OK.
La consola de Message Service recibe el mensaje de la cola y verifica que el vínculo sea válido.
Después de enviar una solicitud de correo electrónico mediante el servidor DirectMail:
Inicie sesión en la consola de Message Service.
En el panel de navegación izquierdo, haga clic en Queues.
Seleccione la región para consultar los mensajes activos en la cola creada anteriormente.
Haga clic en Send Messages para consultar las notificaciones de eventos específicas enviadas a la cola.
Tipos de eventos y método de habilitación
Actualmente, se admiten las siguientes categorías de tipos de eventos:
Deliver:SendSuccessfully
Deliver:SendFailed
Deliver:Open
Deliver:Click
¿Cómo habilitar las estadísticas de Deliver:SendSuccessfully y Deliver:SendFailed?
El sistema recopila la información de entrega de manera predeterminada.
¿Cómo habilitar las estadísticas de Deliver:Open y Deliver:Click?
Consulte ¿Cómo habilito la función de seguimiento de datos?.
Estructura del mensaje de entrega exitosa y con errores
Ejemplo de entrega exitosa
X-Notify-Message-ID=3121639760461820&env_id=12769055421&msg_id=37483d95-7a08-41fb-9738-3d3ffa24d415@example.com&account=example@example.com&from=example@example.com&rcpt=example1@example.com&recv_time=2017-03-29 14:22:40&end_time=2017-03-29 14:22:43&status=0&event=deliver®ion=cn-hangzhou&err_code=250&err_msg=250 Send Mail OK&failed_type=SendOk
Ejemplo de entrega con errores
X-Notify-Message-ID=3121639760461824&env_id=12625010655&msg_id=ac349efc-0d79-489b-affa-f178dce3e49e@example.com&account=example@example.com&from=example@example.com&rcpt=example1@example.com&recv_time=2017-03-28 19:09:49&end_time=2017-03-28 19:09:51&status=4&event=deliver®ion=cn-hangzhou&err_code=524&err_msg=524 Host not found by dns resolve [@ou070302]&failed_type=SysOutDnsResolveFail
¿Cómo analizar el mensaje?
Use "&" para separar los pares clave-valor y "=" para dividir la clave de su valor. La definición de cada clave se encuentra en la lista de valores.
¿Cómo distinguir entre mensajes de éxito y de error?
El código err_code 250 indica que el envío fue exitoso. Cualquier otro código de retorno señala que el envío falló.
Lista de valores
|
Nombre |
Descripción |
|
X-Notify-Message-ID |
Encabezado personalizado X-Notify-Message-ID. |
|
env_id |
Identificador interno del sistema (utilizado para dar seguimiento a consultas). |
|
msg_id |
Campo Message-ID del texto del correo electrónico. |
|
account |
Dirección del remitente. |
|
from |
Dirección del remitente. |
|
rcpt |
Dirección del destinatario. |
|
recv_time |
Hora en que el correo electrónico se recibió en la cola. |
|
end_time |
Hora en que finalizó la entrega del correo electrónico. |
|
status |
Resultados de la entrega (0: éxito, 2: dirección no válida, 3: correo marcado como spam por el receptor, 4: fallo). |
|
event |
Tipo de evento; "deliver" indica el evento de entrega. |
|
region |
Región donde ocurren los eventos. |
|
err_code |
Código de retorno del ESP desde el lado receptor tras completar la entrega. |
|
err_msg |
Información de retorno del ESP desde el lado receptor tras completar la entrega. |
Definición de los valores comunes de failed_type:
|
Valor |
Definición y sugerencia |
|
SendOk |
Entrega exitosa. |
|
SysOutDnsResolveFail |
La resolución DNS del dominio del destinatario falló, generalmente debido a un dominio no válido. Elimine este dominio de su lista de destinatarios. |
|
SmtpMfFreq |
La cuenta de envío está bajo control de flujo. Reduzca la frecuencia de sus envíos. |
|
SmtpContSpam |
Los destinatarios han clasificado el contenido como spam. Optimice el contenido de su correo electrónico o deje de enviar mensajes con esta plantilla a dichos destinatarios. |
|
SmtpAuthFail |
Falló la verificación SPF, DKIM o DMARC. Configure correctamente el registro SPF, compruebe si existen registros DMARC configurados y verifique que DKIM sea correcto. |
|
SmtpNxBox |
Dirección no válida; se agregó a la biblioteca de direcciones no válidas a nivel de cuenta. |
|
SysOutInvRcpt |
Coincidencia con la biblioteca global de direcciones no válidas. Si confirma que la dirección es válida, repórtelo o desactive la biblioteca global de direcciones no válidas. |
|
SmtpRcptFreq |
Control de fatiga del sistema de recepción de correos. Suspenda temporalmente los envíos al destinatario actual. |
|
SmtpSslTlsErr |
Error temporal. La conexión SSL/TLS falló debido a un problema de red o a la indisponibilidad del par. Inténtelo de nuevo. |
|
SmtpTempErr |
Error temporal. Inténtelo nuevamente. |
|
SmtpZPermErr |
Error permanente. No reintente el envío. Determine la causa del fallo basándose en el mensaje devuelto por el destinatario. |
|
SysOutSocksConnError |
Exceso de errores de conexión; la causa probable es que el extremo remoto rechaza el vínculo o que el registro MX del dominio receptor es incorrecto. |
|
SmtpFullBox |
El buzón del destinatario está lleno. Deje de enviar correos a este destinatario. |
|
SmtpIPFreq |
El sistema receptor aplica control de flujo a la IP entrante. Reduzca la velocidad de envío e inténtelo más tarde. |
|
SysOutSocksError |
Exceso de errores de conexión; la causa probable es que el extremo remoto rechaza el vínculo o que el registro MX del dominio receptor es incorrecto. |
|
SysOutConnError |
Exceso de errores de conexión; la causa probable es que el extremo remoto rechaza el vínculo o que el registro MX del dominio receptor es incorrecto. |
|
SysOutConnTooMuch |
Exceso de errores de conexión; la causa probable es que el extremo remoto rechaza el vínculo o que el registro MX del dominio receptor es incorrecto. |
|
UnkSmtpError |
Error desconocido. Revise la configuración de envío y la dirección de recepción según el mensaje de error; confirme que no existan fallos antes de volver a enviar. |
|
SmtpMfdFreq |
El dominio de envío está bajo control de flujo. Reduzca la frecuencia de sus correos electrónicos. |
|
SmtpMiscSpam |
Los destinatarios han clasificado el contenido como spam. Optimice el contenido de su correo electrónico. |
|
SmtpMfBad |
El sistema receptor incluyó al remitente en una lista negra. Deje de enviar correos a dicha parte o contacte al sistema del destinatario para solicitar la eliminación de la lista. |
|
SmtpSpfFail |
Falló la verificación SPF. Configure el registro SPF correcto. |
|
SmtpMfLimit |
La cantidad de correos enviados por el remitente durante todo el día superó el límite del dominio receptor. Inténtelo al día siguiente. |
|
SmtpDmaFail |
Dominio configurado con DMARC; falló la verificación SPF o DKIM. Configure el registro SPF correcto y verifique que DKIM funcione adecuadamente. |
|
SmtpProtErr |
Interacción incorrecta del protocolo con el par. Reporte el incidente a Alibaba Cloud para su solución. |
|
SysOutRecipientReportedSpam |
El destinatario reportó su dirección o dominio de envío. Deje de enviar correos a ese destinatario o dominio. |
|
SysOutHoneypot |
El destinatario es una dirección honeypot. Deje de enviar correos a esta dirección; de lo contrario, recibirá sanciones de la organización antispam. |
|
SysOutRecipientUnsubscribed |
El destinatario canceló la suscripción a su dirección o dominio de envío. Deje de enviar correos a ese destinatario o dominio. |
|
SysIncomingInvRcpt |
Coincidencia con la biblioteca global de direcciones no válidas. Si confirma que la dirección es válida, repórtelo o desactive la biblioteca global de direcciones no válidas. |
|
SysOutRcptOnAccountLevelBounceList |
Coincidencia con la biblioteca de direcciones no válidas a nivel de cuenta. Si confirma que la dirección es válida, elimínela en la página correspondiente o desactive dicha biblioteca. |
|
SmtpDbl |
Coincidencia con la lista negra de dominios de Spamhaus. Pause los envíos y visite check.spamhaus.org para solicitar la eliminación de la lista. Tras ser retirado, vigile la calidad de sus correos y evite enviar mensajes a usuarios que hayan cancelado su suscripción. |
Estructura del mensaje del evento de apertura
Ejemplo
event=Open®ion=cn-hangzhou&env_id=270016664318&msg_id=1688486074.7.1673022065730@example.com&from=example@example.com&rcpt=example@example.com&operate_time=2023-01-07 01:43:51
Lista de valores
|
Nombre |
Descripción |
|
event |
Event type |
|
region |
The region where events happen |
|
env_id |
System internal ID (used for feedback of inquiries) |
|
msgid |
The Message-ID field of the email text |
|
from |
The sender address |
|
rcpt |
Dirección del destinatario. |
|
operate_time |
Hora de operación del evento. |
Estructura del mensaje del evento de clic
Ejemplo
event=Click®ion=cn-hangzhou&env_id=17870283365788973187&msg_id=02785cb2-71b1-4fb5-bdbb-a49dfbe3326f@example.com&from=example@example.com&
rcpt=example@example.com&operate_time=2023-01-12 09:54:09&url=httpsxxx
Lista de valores
|
Nombre |
Descripción |
|
event |
Event type |
|
region |
The region where events happen |
|
env_id |
System internal ID (used for feedback of inquiries) |
|
msgid |
The Message-ID field of the email text |
|
from |
The sender address |
|
rcpt |
Dirección del destinatario. |
|
operate_time |
Hora de operación del evento. |
|
url |
URL del clic. |