Compartir a través de

Controlar eventos de correo electrónico

Para empezar con Azure Communication Services, use Azure Event Grid para administrar eventos de Email de Communication Services. Después de suscribirse a los eventos de Email, como los informes de entrega y los de involucración del usuario, debe generar y recibir estos eventos. Este inicio rápido supone un pequeño costo en su cuenta de Azure.

Requisitos previos

Acerca de Event Grid

Event Grid es un servicio de eventos basado en la nube. En este artículo se describe cómo suscribirse a eventos del servicio de comunicación y desencadenar un evento para ver el resultado. Por lo general, se envían eventos a un punto de conexión que procesa los datos del evento y realiza acciones. En este artículo, los eventos se envían a una aplicación web que recopila y muestra los mensajes.

Configuración del entorno

Para configurar el entorno que usamos para generar y recibir eventos, complete los pasos descritos en las secciones siguientes.

Registro del proveedor de recursos de Event Grid

Es posible que necesite registrar el proveedor de servicios de Event Grid si aún no ha utilizado Event Grid en su suscripción de Azure. Para registrar el proveedor, siga estos pasos:

  1. Vaya a Azure Portal.
  2. En el menú de la izquierda, seleccione Suscripciones.
  3. Seleccione la suscripción que usa para Event Grid.
  4. En el menú de la izquierda, en Configuración, seleccione Proveedores de recursos.
  5. Busque Microsoft.EventGrid.
  6. Si el proveedor de recursos no está registrado, seleccione Registrar.

El registro puede tardar unos instantes en finalizar. Seleccione Actualizar para actualizar el estado. Cuando aparezca Registrado bajo Estado, estará listo para continuar.

Implementación del visor de Event Grid

En este inicio rápido, usamos un visor de Event Grid para ver eventos casi en tiempo real. Esto proporcionará al usuario la experiencia de una fuente en tiempo real. Además, la carga útil de cada evento debe estar disponible para su inspección.

Para configurar el visor, siga los pasos descritos en Visor de Azure Event Grid.

Suscripción a eventos de Email mediante webhooks

Puede suscribirse a eventos específicos para proporcionar a Event Grid información sobre dónde enviar los eventos a los que desea realizar el seguimiento.

  1. En el portal, acceda al recurso de Communication Services que creó.

  2. En el recurso de Communication Services, en el menú de la izquierda de la página Communication Services, seleccione Eventos.

  3. Seleccione Agregar una suscripción a evento.

    Captura de pantalla que muestra la página Eventos de un recurso de Azure Communication Services. Se señala el botón Suscripción de eventos.

  4. En la página Crear suscripción de eventos, escriba un nombre para la suscripción al evento.

  5. En Tipos de eventos, seleccione los eventos a los que desea suscribirse. En el caso de Email, puede elegir Email Delivery Report Received y Email Engagement Tracking Report Received.

  6. Si se le pide que proporcione un nombre de tema del sistema, no dude en proporcionar una cadena única. Este campo no afecta en modo alguno a la experiencia y se usa para telemetría interna.

    Captura de pantalla en la que se muestra el cuadro de diálogo Crear suscripción a eventos. En Tipos de eventos, se seleccionan Informe de entrega de Email recibido e Informe de seguimiento de involucración de Email recibido.

  7. En Tipo de punto de conexión, seleccione Webhook.

    Captura de pantalla que muestra un detalle del cuadro de diálogo Crear suscripción a eventos. En la lista Tipo de punto de conexión, se selecciona Webhook.

  8. En Punto de conexión, elija Seleccione un punto de conexión y escriba la dirección URL de la aplicación web.

    En este caso, usamos la dirección URL del visor de Event Grid que configuramos anteriormente en el inicio rápido. La dirección URL del ejemplo tiene este formato: https://{{site-name}}.azurewebsites.net/api/updates

  9. Seleccione Confirm Selection (Confirmar selección).

    Captura de pantalla en la que se muestra el cuadro de diálogo Seleccionar webhook. El cuadro Punto de conexión del suscriptor contiene una dirección URL y está visible un botón Confirmar selección.

Visualización de eventos de Email

Para generar y recibir eventos de Email, siga los pasos de las secciones siguientes.

Desencadenamiento de eventos de Email

Para ver los desencadenadores de eventos, es necesario generar algunos eventos. Para desencadenar un evento, envíe un correo electrónico mediante el recurso de dominio Email asociado al recurso de Communication Services.

  • Los eventos Email Delivery Report Received se generan cuando Email está en estado terminal; como, Entregado, Erróneo, FilteredSpam, En cuarentena.

  • Los eventos Email Engagement Tracking Report Received se generan cuando se abre el correo electrónico enviado o se hace clic en un vínculo en este. Para desencadenar un evento, debe activar la opción User Interaction Tracking en el recurso de dominio Email.

Consulte la lista completa de eventos admitidos en Communication Services.

Recepción de eventos de Email

Después de generar un evento, observará que los eventos Email Delivery Report Received y Email Engagement Tracking Report Received se envían al punto de conexión. Estos eventos se muestran en el visor de Event Grid que configuramos al principio del inicio rápido. Seleccione el icono de ojo situado junto al evento para ver toda la carga útil. Los eventos deben tener un aspecto similar a los datos siguientes:

Evento Microsoft.Communication.EmailDeliveryReportReceived

Captura de pantalla del visor de Azure Event Grid en la que se muestra el esquema de Event Grid para un evento recibido de informe de entrega de Email.

Evento Microsoft.Communication.EmailEngagementTrackingReportReceived

Captura de pantalla del visor de Azure Event Grid en la que se muestra el esquema de Event Grid para un evento de informe de seguimiento de involucración de Email.

  • EngagementContext hace referencia al vínculo en el que se hace clic cuando engagementType es Click.
  • UserAgent hace referencia al agente de usuario desde el que se originó este evento de interacción por correo electrónico. Por ejemplo, si el usuario interactúó en Microsoft Edge con una máquina Win10: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, como Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
  • EngagementType hace referencia al tipo de compromiso. Los valores posibles son View o Click.
  • Recipient hace referencia al destinatario que se ha comprometido con el correo electrónico. Tenga en cuenta que este campo está vacío cuando el correo electrónico original se envió a varios destinatarios a la vez.

Para obtener más información, consulte esquemas de eventos y otros conceptos de eventos.

Limpieza de recursos

Si quiere limpiar y quitar una suscripción a Communication Services, puede eliminar el recurso o grupo de recursos. Al eliminar el grupo de recursos, también se elimina cualquier otro recurso que esté asociado a él. Obtenga más información sobre la limpieza de recursos.

Pasos siguientes

En este inicio rápido, ha descubierto cómo consumir eventos Email. Puede recibir eventos Email creando una suscripción de Event Grid.

Enviar correo electrónico

Para obtener información de esquema y eventos de ejemplo, consulte Azure Communication Services: eventos de correo electrónico.