Muokkaa

Jaa

Build an interactive notification bot

  • Artikkeli

For an interactive notification, a bot sends messages in a Teams channel, group chat, or personal chat. You can trigger an interactive notification bot with an HTTP request, such as cards or texts. For proactive notifications from tab apps, use activity feed notifications.

Screenshot shows you the conceptual notification bot in Teams client

In this tutorial, learn about an interactive notification bot app in one of the following ways.

  • GitHub Codespaces: The codespace instance allows you to experience a Teams app instantaneously. It opens Visual Studio Code (VS Code) where the Teams Toolkit extension, the app source code, and all the dependencies are pre-packaged for you.
  • Step-by-step guide: Allows you to set up your development environment and build a Teams app from the start.

Before you create your codespace, ensure that you have the following prerequisites:

Tip

GitHub Codespaces offers a free plan with a fixed amount of usage per month. If you need to free up more space, go to github.com/codespaces and delete the codespace that you no longer need.

To create an interactive Teams notification bot with GitHub Codespaces, follow these steps:

  1. Select the following button to open GitHub Codespaces.

    Open hello-world tab in GitHub Codespaces

    You might be asked to sign in to GitHub account if you haven't already.

  2. Select Create new codespace.

    Screenshot shows you the GitHub page to create a codespace for bot.

    The Setting up your codespace page appears.

    Screenshot shows you the codespace building your notification bot.

    Teams Toolkit prepares an interactive notification bot project for you and opens it in VS Code in the browser. The Teams Toolkit icon appears in the activity bar of VS Code.

  3. Select Sign in to your Microsoft 365 and Sign in to Azure to sign in with your Microsoft 365 account.

    Screenshot shows you the Teams Toolkit window in browser to sign in.

    Note

    When you build your app, GitHub Codespaces loads it to the Teams client in a new tab. If your browser blocks pop-up tabs or windows, you need to allow pop-ups for your app to open.

  4. Select Preview your Teams App (F5).

    Screenshot shows you the Teams Toolkit window in browser with your notification bot.

    GitHub Codespaces builds your interactive notification bot app, loads it to Teams client, and opens it in a separate browser tab.

  5. Select Add to install your interactive notification bot in Teams.

    Screenshot of the app details dialog to install the notification bot app in Teams.

    When the app is added, a dialog appears where you can select the scope to use your app.

  6. Select Open to open the app in personal scope.

    Alternatively, you can either search and select the required scope or select a channel, chat, or meeting from the list, and move through the dialog to select Go.

    Screenshot of the scope selection dialog with the options to select from shared scopes.

  7. Open a new terminal in your codespace and run the following command to trigger an event for sending an interactive notification to your bot:

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

    Tip

    In real time, events are triggered by an external source, such as a third-party API that cause the notification bot to send the user an interactive notification. To emulate an event trigger, you can send an event manually through curl commands on terminal.

    The notification bot app sends an interactive notification as an Adaptive Card to your Teams client:

    Screenshot shows your notification bot loaded in the Teams client.

    You've now successfully created an interactive notification bot and loaded it in the Teams client.

If you want to build a message extension, go to:

Build message extension

If you want to build basic tab app, go to:

Build your basic tab app