Inicio rápido: Control de eventos de Email

  • Artículo

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, aprenderá a suscribirse a eventos de servicios de comunicación y a 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 usaremos para generar y recibir eventos, siga los pasos descritos en las secciones siguientes.

Registro del proveedor de recursos de Event Grid

Si no ha usado anteriormente Event Grid en su suscripción de Azure, puede que tenga que registrar el proveedor de recursos de Event Grid. 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, usaremos el visor de Event Grid para ver eventos prácticamente 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, vaya al recurso de Communication Services que creó.

  2. En el recurso de Communication Services, seleccione, 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 llama al 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 del tema del sistema, puede 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, se usará la dirección URL del visor de Event Grid configurado 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; es decir, 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 icono de ojo situado junto al evento para ver toda la carga útil. Los eventos deben tener un aspecto similar a los datos siguientes:

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.

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. P. ej. Si el usuario ha interactuado en 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 interacción; los valores posibles son "View" y "Click".

Más información sobre los 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.

Es posible que también le interesen los siguientes artículos: