Notification-only bots in Microsoft Teams


This article is based on the v3 Bot Framework SDK. If you are looking for current documentation version 4.6 or later of the SDK, see the conversational bots section.

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.


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

App manifest

To enable this, set isNotificationOnly to true.


The value of isNotificationOnly is Boolean and not a string.

      "botId":"[Microsoft App ID for your bot]",
      "isNotificationOnly": true,
      "scopes": [

Best practices and limitations

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