Control de eventos en Azure Communication Services

  • Artículo

Azure Communication Services se integra con Azure Event Grid para ofrecer notificaciones de eventos en tiempo real de manera confiable, escalable y segura. Este artículo tiene como objetivo ayudarle a configurar las aplicaciones para que escuchen eventos de Communication Services. Por ejemplo, puede que quiera actualizar una base de datos, crear un elemento de trabajo y entregar una notificación de inserción al recibir un SMS de un número de teléfono asociado al recurso de Communication Services.

Azure Event Grid es un servicio de enrutamiento de eventos totalmente administrado que usa un modelo de publicación-suscripción. Event Grid tiene compatibilidad integrada con servicios de Azure, como Azure Functions y Azure Logic Apps. Puede proporcionar alertas de eventos para servicios que no sean de Azure mediante webhooks. Para obtener una lista completa de los controladores de eventos que Event Grid admite, vea una introducción a Azure Event Grid.

Diagram showing Azure Event Grid's event model.

Nota:

Para más información sobre cómo se relaciona la residencia de datos con el control de eventos, visite la documentación conceptual sobre residencia de datos.

Tipos de eventos

Event Grid usa las suscripciones a eventos para enrutar los mensajes de eventos a los suscriptores.

Azure Communication Services emite los siguientes tipos de evento:

Puede usar Azure Portal o la CLI de Azure para suscribirse a eventos emitidos por el recurso de Communication Services.

Asuntos de eventos

El campo subject de todos los eventos de Communication Services identifica el usuario, el número de teléfono o la entidad de destino del evento. Los prefijos comunes se utilizan para permitir el filtrado de Event Grid simple.

Prefijo de asunto Entidad de Communication Services
phonenumber/ Número de teléfono RTC
user/ Usuario de Communication Services
thread/ Subproceso de chat

En el ejemplo siguiente se muestra un filtro para todos los mensajes SMS y los informes de entrega enviados a todos los números de teléfono de código de área 555 propiedad de un recurso de Communication Services:

"filter": {
  "includedEventTypes": [
    "Microsoft.Communication.SMSReceived",
    "Microsoft.Communication.SMSDeliveryReportReceived"
  ],
  "subjectBeginsWith": "phonenumber/1555",
}

Pasos siguientes