Azure Communication Services: eventos de correo electrónico

Artículo
07/24/2023

En este artículo se proporcionan las propiedades y el esquema de los eventos de correo electrónico de los servicios de comunicación. Para una introducción a los esquemas de eventos, consulte Esquema de eventos de Azure Event Grid.

Tipos de eventos

Azure Communication Services emite los siguientes tipos de eventos de telefonía y SMS:

Tipo de evento	Descripción
Microsoft.Communication.EmailDeliveryReportReceived	Se publica cuando se recibe un informe de entrega de un correo electrónico enviado por Communication Services.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Se publica cuando el correo electrónico enviado se abre o se hace clic en el vínculo, si procede.

Respuestas de eventos

Cuando se desencadena un evento, el servicio Event Grid envía datos sobre ese evento a los puntos de conexión correspondientes.

Esta sección contiene un ejemplo del aspecto que deben tener los datos para cada evento.

Evento Microsoft.Communication.EmailDeliveryReportReceived

[{
  "id": "00000000-0000-0000-0000-000000000000",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
  "subject": "sender/senderid@azure.com/message/00000000-0000-0000-0000-000000000000",
  "data": {
    "sender": "senderid@azure.com", 
    "recipient": "receiver@azure.com",
    "messageId": "00000000-0000-0000-0000-000000000000",
    "status": "Delivered",
    "deliveryStatusDetails": {
      "statusMessage": "Status Message"
    },
    "deliveryAttemptTimeStamp": "2020-09-18T00:22:20.2855749+00:00",
  },
  "eventType": "Microsoft.Communication.EmailDeliveryReportReceived",
  "dataVersion": "1.0",
  "metadataVersion": "1",
  "eventTime": "2020-09-18T00:22:20.822Z"
}]

Nota

Los valores posibles para Status son:

Delivered: el mensaje se entregó correctamente al destino previsto (agente de transferencia de correo del destinatario).
Suppressed: el correo electrónico del destinatario se rechazó de forma permanente y, por ello, todos los correos electrónicos posteriores a este destinatario se suprimen temporalmente.
Bounced: el correo electrónico se rechazó de forma permanente. Puede haber ocurrido porque la dirección de correo electrónico no existe o el dominio no es válido.
Quarantined: el mensaje se puso en cuarentena (como correo no deseado, masivo o ce suplantación de identidad).
FilteredSpam: el mensaje se identificó como correo no deseado y se rechazó o bloqueó (no se puso en cuarentena).
Expanded: se expandió un destinatario del grupo de distribución antes de la entrega a los miembros individuales del grupo.
Failed: el mensaje no se entregó.

Evento Microsoft.Communication.EmailEngagementTrackingReportReceived

[{
  "id": "00000000-0000-0000-0000-000000000000",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
  "subject": "sender/senderid@azure.com/message/00000000-0000-0000-0000-000000000000",
  "data": {
    "sender": "senderid@azure.com", 
    "messageId": "00000000-0000-0000-0000-000000000000",
    "userActionTimeStamp": "2022-09-06T22:34:52.1303595+00:00",
    "engagementContext": "",
    "userAgent": "",
    "engagementType": "view"
  },
  "eventType": "Microsoft.Communication.EmailEngagementTrackingReportReceived",
  "dataVersion": "1.0",
  "metadataVersion": "1",
  "eventTime": "2022-09-06T22:34:52.688Z"
}]

Nota:

Los valores posibles de engagementType son View y Click. Cuando engagementType es Click, engagementContext es el vínculo del correo electrónico enviado al que se hizo clic.

Tutorial

Para ver un tutorial que muestra cómo suscribirse a eventos de correo electrónico mediante webhooks, consulte Inicio rápido: Control de eventos de correo electrónico.

Compartir a través de