bots-notification-only.md

title	description	ms.topic	ms.localizationpriority	ms.date
Notification-only bots	In this module, learn what notification-only bots are in Microsoft Teams, app manifest and its best practices and limitations.	conceptual	medium	04/02/2023

Notification-only bots in Microsoft Teams

[!includev3-to-v4-SDK-pointer]

If your bot's sole purpose is to deliver notification to users and isn't conversational, you can enable the isNotificationOnly field in your app manifest. This produces the following changes:

• Users can't message your notification-only bot.
• Users can't @mention the bot.

Note

The bot-only apps will surface in the personal app tray in both cases: isNotificationOnly: true or isNotificationOnly: false.

The tab naming convention for your installed bot depends on the isNotificationOnly manifest property setting:

isNotificationOnly: true

When the isNotificationOnly manifest property is set to true, the tab for the installed bot app is named Activity.

:::image type="content" source="~/assets/images/bots/notification_bot_true.png" alt-text="Screenshot shows an example of Activity tab.":::

isNotificationOnly: false

When the isNotificationOnly manifest property is set to false, the tab for the installed bot app is named Chat.

:::image type="content" source="~/assets/images/bots/notification_bot_false.png" alt-text="Screenshot shows an example of Chat tab.":::

---

App manifest

To enable this, set isNotificationOnly to true.

Note

The value of isNotificationOnly is Boolean and not a string.

{
  ⋮
  "bots":[
    {
      "botId":"[Microsoft App ID for your bot]",
      "isNotificationOnly": true,
      "scopes": [
        "personal",
        "team"
      ],
    }
  ],
  ...
}

Best practices and limitations

Notification-only bots use proactive messaging to communicate with the user. For more information, see Proactive messaging for bots.