Inicio rápido: Control de eventos de informes de entrega y SMS

  • Artículo

Para empezar con Azure Communication Services, use Azure Event Grid para administrar eventos SMS de Communication Services. Después de suscribirse a los eventos de SMS, como los mensajes entrantes y los informes de entrega, genera y recibe estos eventos. Este inicio rápido supone un pequeño costo en su cuenta de Azure.

Importante

Las capacidades de SMS y RTC dependen del número de teléfono que use y del país o región en el que trabaja, según lo que especifique la dirección de facturación de Azure. Para más información, visite la documentación de Idoneidad de la suscripción.

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 SMS 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. Para SMS, puede elegir SMS Received y SMS Delivery 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 que muestra el cuadro de diálogo Crear suscripción a eventos. En Tipos de eventos, se seleccionan SMS recibidos e Informe de entrega de SMS.

  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 que 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 SMS

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

Desencadenamiento de eventos de SMS

Para ver los desencadenadores de eventos, es necesario generar algunos eventos.

  • Los eventos SMS Received se generan cuando el número de teléfono de Communication Services recibe un mensaje de texto. Para desencadenar un evento, envíe un mensaje desde el teléfono al número de teléfono asociado al recurso de Communication Services.
  • Los eventos SMS Delivery Report Received se generan cuando se envía un SMS a un usuario mediante un número de teléfono de Communication Services. Para desencadenar un evento, debe activar la opción Delivery Report del SMS que envíe. Pruebe a enviar un mensaje a su teléfono con Delivery Report activado. La realización de esta acción supone un pequeño costo de unos céntimos en su cuenta de Azure.

Consulte la lista completa de eventos admitidos en Communication Services.

Recepción de eventos de SMS

Después de generar un evento, observará que los eventos SMS Received y SMS Delivery 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 que muestra el esquema de Event Grid para un evento recibido por SMS.

Captura de pantalla del visor de Azure Event Grid que muestra el esquema de Event Grid para un evento de informe de entrega de SMS.

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 tutorial, ha aprendido a utilizar eventos SMS. Puede recibir mensajes SMS mediante la creación de una suscripción de Event Grid.

Envío de SMS

También puede que desee consultar: