Test your Microsoft Teams bot
You can test your bot in two different contexts:
- For use in any team using channels
- For personal chat with individual team members.
Both processes are listed below. Note that each method triggers a slightly different flow and enables bots in different contexts.
For published bots, end users will be able to access the via the Discover Bots access points in the product.
Your tenant administrator will need to enable uploading of apps for your organization. Here's how.
Adding a bot to a team for use in channels
To add a bot to a team, so it is usable in the team channel by all team members, the bot must be part of an app. You create an app package and upload it to the appropriate team. This process makes the bot available in all channels within the team (when @mentioned) as well as for all team members in personal context. Please note that the bot will not be available in other teams without being explicitly added to them.
When a bot is first added via the above method, Teams will send the
conversationUpdate event. The payload for this event will contain a
channelData object with the team information. For more information about bot events, see the documentation here. This event is sent in both team and personal conversations, but in personal conversations the payload is empty since channel data does not apply.
Adding a bot for personal chat
If your bot only needs to be accessed in personal chat, not made available for channel conversations, you can directly upload your bot for that purpose.
There are two ways to test load your bot for personal conversations in Microsoft Teams:
On the Bot Dashboard page for your bot, under Channels, select Add to Microsoft Teams.
Microsoft Teams will launch with a personal chat with your bot.
Directly reference your bot's app ID from within Microsoft Teams:
On the Bot Dashboard page for your bot, under Details, copy the Microsoft App ID for your bot.
From within Microsoft Teams, on the Chat pane, select the Add chat icon. For To:, paste your bot's Microsoft App ID.
The app ID should resolve to your bot name.
Select your bot and send a message to initiate a conversation.
Alternatively, you can paste your bot's app ID in the search box in the top left in Microsoft Teams. In the search results page, navigate to the People tab to see your bot and to start chatting with it.
Create a deeplink to your bot using the Teams deep-link format. This will launch Microsoft Teams directly with your bot's app ID. The format is
When a bot has been added through one of these methods, it will not be addressable in channel conversations. Nor can you take advantage of other Microsoft Teams app capabilities like tabs or messaging extensions.
Your bot will receive the
conversationUpdate event just like bots added to a team, but without the team information in the
Blocking a bot in personal chat
Note that users can choose to block your bot from sending personal chat messages. They may toggle this by right-clicking your bot in the chat channel and choosing Block bot conversation. This means your bots will continue to send messages but the user will not receive those messages.
Removing a bot from a team
Users can delete the bot by choosing the trash-can icon on the bots list in their teams view. Note that this only removes the bot from that team's use; individual users will still be able to interact in personal context.
Bots in personal context cannot be disabled or removed by a user, short of completely removing the bot from Teams.
Disabling a bot in Teams
To stop your bot receiving messages, go to your Bot Dashboard and edit the Microsoft Teams channel. Clear the Enable on Microsoft Teams option. This prevents users from interacting with the bot, but it will still be discoverable and users will still be able to add it to teams.
Deleting a bot from Teams
To remove your bot completely from Teams, go to your Bot Dashboard and edit the Microsoft Teams channel. Choose the Delete button at the bottom. This prevents users from discovering, adding, or interacting with your bot. Note that this does not remove the bot from other users' Teams instances, although it will cease functioning for them as well.
Removing your bot from AppSource
If you want to remove your bot from your Teams app in AppSource (formerly Office Store), you must remove the bot from your app manifest and resubmit your app for validation. See Publish your Microsoft Teams app to AppSource for more information.
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.