Partage via

Gérer les événements SMS

Commencez avec les Azure Communication Services en utilisant Azure Event Grid pour gérer les événements SMS d'Azure Communication Services. Après vous être abonné à des événements SMS tels que les messages entrants et les rapports de remise, vous générez et recevez ces événements.

Le fait d’effectuer les étapes de cet article entraîne un coût minime de quelques centimes de dollar USD ou moins sur votre compte Azure.

Important

Les fonctionnalités SMS et PSTN dépendent du numéro de téléphone que vous utilisez et du pays/région dans lequel vous opérez, comme déterminé par votre adresse de facturation Azure. Pour plus d’informations, consultez la documentation relative à l’éligibilité des abonnements.

Conditions préalables

À propos d’Event Grid

Event Grid est un service d’événement cloud. Dans cet article, vous apprendrez comment vous abonner à des événements de service de communication et comment déclencher un événement pour voir le résultat. En règle générale, vous envoyez des événements à un point de terminaison qui traite les données d’événement et entreprend des actions. Cet article explique comment envoyer les événements à une application web qui collecte et affiche les messages.

Configurer l’environnement

Pour configurer l’environnement pour générer et recevoir des événements, suivez les sections suivantes.

Enregistrer le fournisseur de ressources Event Grid

Si vous n’utilisez pas Event Grid dans votre abonnement Azure, vous devez inscrire votre fournisseur de ressources Event Grid. Pour inscrire le fournisseur, procédez comme suit :

  1. Accédez au portail Azure.
  2. Sélectionner Abonnements dans le menu de gauche.
  3. Sélectionnez l’abonnement que vous utilisez pour Event Grid.
  4. Dans le menu de gauche, sous Paramètres, sélectionnez Fournisseurs de ressources.
  5. Recherchez Microsoft.EventGrid.
  6. Si le fournisseur de ressources n’est pas inscrit, sélectionnez Enregistrer.

L’inscription peut prendre un certain temps. Sélectionnez Actualiser pour mettre à jour l’état. Lorsque Enregistré s’affiche sous le Statut, vous êtes prêt à continuer

Déployer la visionneuse "Event Grid"

Pour cet exemple, utilisez une visionneuse Event Grid pour afficher les événements en quasi-temps réel. La visionneuse offre à l’utilisateur l’expérience d’un flux en temps réel. De plus, la charge utile de chaque événement doit être disponible pour inspection.

Pour configurer la visionneuse, suivez les étapes décrites dans Visionneuse Azure Event Grid.

S’abonner aux événements SMS à l’aide de web hooks

Vous pouvez vous abonner à des événements spécifiques pour fournir à Event Grid des informations sur l’emplacement d’envoi des événements que vous souhaitez suivre.

  1. Dans le portail, accédez à la ressource Communication Services que vous avez créée.

  2. Dans la ressource Communication Services, sélectionnez Événements dans le menu de gauche de la page Communication Services.

  3. Sélectionnez Ajouter un abonnement aux événements.

    Capture d’écran montrant la page Événements d’une ressource Azure Communication Services. Le bouton Abonnement aux événements est mis en évidence.

  4. Dans la page Créer un abonnement aux événements, entrez un nom pour l’abonnement aux événements.

  5. Sous Types d’événements, sélectionnez les événements auxquels vous souhaitez vous abonner. Pour SMS, vous pouvez choisir SMS Received et SMS Delivery Report Received.

  6. Si vous êtes invité à fournir un Nom de rubrique système, n’hésitez pas à fournir une chaîne unique. Ce champ n’a aucun impact sur votre expérience et est utilisé à des fins de télémétrie interne.

    Capture d’écran montrant la boîte de dialogue Créer un abonnement aux événements. Sous Types d’événements, sms reçus et rapport de remise SMS reçus sont sélectionnés.

  7. Pour le type de point de terminaison, sélectionnez Web Hook.

    Capture d’écran montrant un détail de la boîte de dialogue Créer un abonnement aux événements. Dans la liste Type de point de terminaison, Webhook est sélectionné.

  8. Pour le Point de terminaison, choisissez Sélectionner un point de terminaison, puis entrez l’URL de votre application web.

    Dans ce cas, utilisez l’URL de la visionneuse Event Grid que nous avons configurée dans le guide d'initiation rapide précédemment. L’URL de l’exemple a ce format : https://{{site-name}}.azurewebsites.net/api/updates

  9. Sélectionnez Confirmer la sélection.

    Capture d’écran montrant la boîte de dialogue Sélectionner un webhook. La zone Point de terminaison de l’Abonné contient un URL, et le bouton Confirmer la sélection est visible.

Afficher les événements de SMS

Pour générer et recevoir des événements SMS, procédez comme suit.

Déclencher des événements SMS

Pour afficher les déclencheurs d’événements, nous devons générer certains événements.

  • SMS Received les événements sont générés lorsque le numéro de téléphone Communication Services reçoit un sms. Pour déclencher un événement, envoyez un message de votre téléphone au numéro de téléphone attaché à votre ressource Communication Services.
  • SMS Delivery Report Received les événements sont générés lorsque vous envoyez un SMS à un utilisateur à l’aide d’un numéro de téléphone Communication Services. Pour déclencher un événement, vous devez activer l’option Delivery Report du SMS que vous envoyez. Essayez d’envoyer un message à votre téléphone avec Delivery Report activé. L’exécution de cette action entraîne un petit coût de quelques cents USD ou moins dans votre compte Azure.

Consultez la liste complète des événements pris en charge par Azure Communication Services.

Recevoir des événements SMS

Après avoir généré un événement, vérifiez que les événements SMS Received et SMS Delivery Report Received sont envoyés à votre point de terminaison. Ces événements s’affichent dans lavisionneuse Event Grid que nous avons configurée au début de ce démarrage rapide. Pour afficher l’intégralité de la charge utile, sélectionnez l’icône d’œil en regard de l’événement. Les évènements doivent ressembler aux données suivantes :

Capture d’écran de la visionneuse Azure Event Grid montrant le schéma Event Grid d’un événement reçu par SMS.

Capture d’écran de la visionneuse Azure Event Grid montrant le schéma Event Grid pour un événement de rapport de remise SMS.

Découvrez-en plus sur les schémas d’événements et d’autres concepts liés aux événements.

Nettoyer les ressources

Si vous voulez nettoyer et supprimer un abonnement Communication Services, vous pouvez supprimer la ressource ou le groupe de ressources. La suppression du groupe de ressources efface également les autres ressources qui y sont associées. Apprenez-en davantage sur le nettoyage des ressources.

Étapes suivantes

Envoyer un SMS

  • Last updated on