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

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

• Compte Azure avec un abonnement actif
• Enregistrer le fournisseur de ressources Event Grid
• Créer une ressource Azure Communication Services

À 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.

   

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.

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

• Hosting Plan Name : créez un nom pour identifier votre plan d’hébergement.

• Sku : vous pouvez utiliser la référence SKU F1 à 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

  

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

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

   

5. 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.

   

6. 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.

   

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.

     

   • Facultatif : sélectionnez l’événement AdvancedMessageAnalysisCompleted, actuellement en préversion publique, pour recevoir les événements d’analyse des messages. Vous trouverez des instructions sur l’activation de l’analyse des messages dans Activer l’analyse des messages avec Azure OpenAI

     Important

     Cette fonctionnalité d’Azure Communication Services est actuellement en préversion.

     Ces interfaces de programmation d’applications et kits de développement logiciel (SDK) en préversion sont fournis sans contrat au niveau du service. Nous vous recommandons de ne pas les utiliser pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge.

     Pour plus d’informations, consultez Conditions d’utilisation supplémentaires relatives aux préversions de Microsoft Azure.

     

   • 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.

     

   • 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.

   

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.