Gestion des événements dans Azure Communication Services

  • Article

Azure Communication Services s'intègre à Azure Event Grid pour fournir des notifications d'événements en temps réel de manière fiable, scalable et sécurisée. L’objectif de cet article est de vous aider à configurer vos applications pour être à l’écoute des événements Communication Services. Par exemple, vous pouvez mettre à jour une base de données, créer un élément de travail et envoyer une notification Push chaque fois qu’un SMS est reçu par un numéro de téléphone associé à votre ressource Communication Services.

Azure Event Grid est un service de routage d’événement complètement managé qui utilise le modèle publication-abonnement. Event Grid offre une prise en charge intégrée des services Azure comme Azure Functions et Azure Logic Apps. Il peut envoyer des alertes d’événement à des services non-Azure à l’aide de webhooks. Pour obtenir une liste complète des gestionnaires d’événements qui prennent en charge Event Grid, consultez Présentation d’Azure Event Grid.

Diagram showing Azure Event Grid's event model.

Remarque

Pour en savoir plus sur le rapport entre la résidence des données et la gestion des événements, consultez la documentation conceptuelle relative à la résidence des données.

Types d’événements

Event Grid utilise les abonnements aux événements pour acheminer les messages d’événements vers les abonnés.

Azure Communication Services émet les types d’événements suivants :

Vous pouvez utiliser le portail Azure ou Azure CLI pour vous abonner aux événements émis par votre ressource Communication Services.

Objets des événements

Le champ subject de tous les événements Communication Services identifie l’utilisateur, le numéro de téléphone ou l’entité que l’événement cible. Les préfixes courants sont utilisés pour autoriser un filtrage Event Grid simple.

Préfixe de l’objet Entité du service de communication
phonenumber/ Numéro de téléphone RTPC
user/ Utilisateur de Communication Services
thread/ Fil de conversation.

L’exemple suivant montre un filtre pour tous les SMS et tous les rapports de remise envoyés à tous les numéros de téléphone dotés de l’indicatif régional 555 détenus par une ressource Communication Services :

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

Étapes suivantes