Créer un bot de notification interactif

  • Article

Pour une notification interactive, un bot envoie des messages dans un canal Teams, une conversation de groupe ou une conversation personnelle. Vous pouvez déclencher un bot de notification interactif avec une requête HTTP, telle que des cartes ou des sms. Pour les notifications proactives des applications d’onglet, utilisez les notifications de flux d’activité.

Capture d’écran montrant le bot de notification conceptuelle dans le client Teams

Dans ce tutoriel, découvrez une application de bot de notification interactive de l’une des manières suivantes.

  • GitHub Codespaces : le codespace instance vous permet de découvrir instantanément une application Teams. Il ouvre Visual Studio Code (VS Code) où l’extension Teams Toolkit, le code source de l’application et toutes les dépendances sont pré-empaquetés pour vous.
  • Guide pas à pas : vous permet de configurer votre environnement de développement et de créer une application Teams dès le début.

Avant de créer votre codespace, vérifiez que vous disposez des prérequis suivants :

Conseil

GitHub Codespaces offre un plan gratuit avec une quantité fixe d’utilisation par mois. Si vous avez besoin de libérer plus d’espace, accédez à github.com/codespaces et supprimez le codespace dont vous n’avez plus besoin.

Pour créer un bot de notification Teams interactif avec GitHub Codespaces, procédez comme suit :

  1. Sélectionnez le bouton suivant pour ouvrir GitHub Codespaces.

    Ouvrir l’onglet hello-world dans GitHub Codespaces

    Vous serez peut-être invité à vous connecter au compte GitHub si ce n’est déjà fait.

  2. Sélectionnez Create nouveau codespace.

    Capture d’écran montrant la page GitHub pour créer un codespace pour le bot.

    La page Configuration de votre codespace s’affiche.

    Capture d’écran montrant le codespace qui crée votre bot de notification.

    Teams Toolkit prépare un projet de bot de notification interactif pour vous et l’ouvre dans VS Code dans le navigateur. L’icône Teams Toolkit apparaît dans la barre d’activité de VS Code.

  3. Sélectionnez Se connecter à votre Microsoft 365 et Se connecter à Azure pour vous connecter avec votre compte Microsoft 365.

    Capture d’écran montrant la fenêtre Teams Toolkit dans le navigateur pour vous connecter.

    Remarque

    Lorsque vous générez votre application, GitHub Codespaces la charge sur le client Teams dans un nouvel onglet. Si votre navigateur bloque les fenêtres ou les onglets contextuels, vous devez autoriser l’ouverture des fenêtres contextuelles pour votre application.

  4. Sélectionnez Afficher un aperçu de votre application Teams (F5).

    Capture d’écran montrant la fenêtre Teams Toolkit dans le navigateur avec votre bot de notification.

    GitHub Codespaces génère votre application de bot de notification interactive, la charge sur le client Teams et l’ouvre dans un onglet de navigateur distinct.

  5. Une fois la boîte de dialogue de l’application affichée, sélectionnez Ajouter pour installer votre bot de notification interactive dans Teams.

    Capture d’écran montrant le bot de notification chargé dans le client Teams.

  6. Ouvrez un nouveau terminal dans votre codespace et exécutez la commande suivante pour déclencher un événement pour envoyer une notification interactive à votre bot :

    curl -X POST http://localhost:3978/api/notification

    Conseil

    En temps réel, les événements sont déclenchés par une source externe, telle qu’une API tierce, qui amène le bot de notification à envoyer une notification interactive à l’utilisateur. Pour émuler un déclencheur d’événement, vous pouvez envoyer un événement manuellement via des commandes curl sur le terminal.

    L’application bot de notification envoie une notification interactive sous forme de carte adaptative à votre client Teams :

    Capture d’écran montrant votre bot de notification chargé dans le client Teams.

    Vous avez maintenant créé un bot de notification interactif et l’avez chargé dans le client Teams.

Si vous souhaitez créer une extension de message, accédez à :

Générer l’extension de message

Si vous souhaitez créer une application d’onglet de base, accédez à :

Créer votre application d’onglet de base