Partager via

Démarrage rapide : gérer les événements de messagerie avancée

  • Article

Azure Communication Services vous permet désormais d’envoyer et de recevoir des messages WhatsApp à l’aide du Kit de développement logiciel (SDK) de messagerie avancée. Commencez à configurer des événements Event Grid pour recevoir des messages de rapports d’état WhatsApp envoyer/recevoir. Le fait de suivre ce guide de démarrage rapide entraîne une petite dépense de quelques cents USD tout au plus dans votre compte Azure.

Prérequis

À 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. Dans cet article, nous envoyons des événements à une application web qui collecte et affiche les messages.

Configurer Event Grid Viewer

La visionneuse Event Grid est un exemple de site qui vous permet d’afficher les événements entrants à partir d’Event Grid.

  1. Accéder à ce lien Azure Event Grid Viewer : exemples de code | Microsoft Learn. Déployez l’exemple de visionneuse Event Grid en cliquant sur le bouton Déployer sur Azure.

    Screenshot that shows the Event Grid Viewer Sample Page with Deploy To Azure option.

  2. Après avoir cliqué sur Déployer sur Azure, renseignez les champs requis. Étant donné que le nom du site crée une entrée DNS, il doit être globalement unique. Nous vous recommandons d’inclure votre alias dans le nom de cette étape. Bien que ce guide de démarrage rapide ne nécessite aucune configuration spéciale pour cette étape, voici des suggestions pour remplir les détails du déploiement :

  • Subscription : sélectionnez l’abonnement qui contient votre ressource Azure Communication Services. Cet abonnement spécifique n’est pas obligatoire, mais il facilite le nettoyage une fois que le démarrage rapide est terminé.

  • Resource Group : sélectionnez le groupe de ressources qui contient votre ressource Azure Communication Services. Ce groupe de ressources spécifique n’est pas obligatoire, mais il facilite le nettoyage une fois que le démarrage rapide est terminé.

  • Region : sélectionnez le groupe de ressources qui contient votre ressource Azure Communication Services. Cette région spécifique n’est pas obligatoire, mais elle est recommandée.

  • « Nom du site » : créez un nom globalement unique. Ce nom de site est utilisé pour créer un domaine qui sera connecté à votre visionneuse Event Grid.

  • « Nom du plan d’hébergement » : créez un nom pour identifier votre plan d’hébergement.

  • « SKU » : les références SKU F1 peuvent être utilisées à des fins de développement et de test. Si vous rencontrez des erreurs de validation lors de la création de votre visionneuse Event Grid indiquant qu’il n’y a plus de capacité pour le plan F1, essayez de sélectionner une autre région. Pour plus d’informations sur les références SKU, consultez la tarification Azure App Service

    Screenshot that shows Custom deployment of Events Viewer web app and properties you need to provide to successfully deploy.

  1. Sélectionnez ensuite Vérifier + créer.

  2. Une fois le déploiement terminé, sélectionnez la ressource App Service pour l’ouvrir.

    Screenshot that shows Events Viewer web app.

  3. Dans la page de présentation de la ressource, sélectionnez le bouton de copie en regard de la propriété Domaine par défaut.

    Screenshot that shows URL of Events Viewer web app.

  4. L’URL de la visionneuse Event Grid correspond au nom du site que vous avez utilisé pour créer le déploiement avec le chemin d’accès /api/update ajouté. Par exemple : « https://{{nom-site}}.azurewebsites.net/api/updates ». Vous en aurez besoin pour l’étape suivante et lors de la création de l’application de démonstration.

S’abonner aux événements de messagerie avancée

  1. Ouvrez votre ressource Communication Services dans le portail Azure, accédez à l’option Événements dans le volet gauche, puis sélectionnez +Abonnement aux événements.

    Screenshot that shows Azure Communication Services Events subscription option and allows you to subscribe to Advanced Messaging events.

  2. Renseignez les détails du nouvel abonnement aux événements.

    • Nom de l’abonnement.

    • Nom de la rubrique système : entrez un nom unique, sauf si ce nom est déjà prérempli avec une rubrique de votre abonnement.

    • Types d’événements : sélectionnez les deux événements de messagerie avancés de la liste.

      Screenshot that shows create event subscription properties.

    • Pour le type de point de terminaison, sélectionnez « Webhook » et entrez l’URL de la visionneuse Event Grid créée à l’étape Configurer la visionneuse Event Grid avec le chemin /api/updates ajouté. Par exemple : https://{{site-name}}.azurewebsites.net/api/updates.

      Screenshot that shows how to update webhook url of event subscription to receive events.

    • Sélectionnez Créer.

  3. Revenez à l’option Événements dans le volet gauche de votre ressource Azure Communication Services. Notez le nouvel abonnement aux événements avec les événements Messagerie avancée.

    Screenshot that shows two Advanced messaging events subscribed.

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

Passez à l’article suivant pour apprendre à utiliser le Kit de développement logiciel (SDK) de messagerie avancée pour la messagerie WhatsApp.

Prise en main du Kit de développement logiciel (SDK) Advanced Communication Messages.