Have a personal (one-on-one) conversation with a Microsoft Teams bot

Important

The articles in this section are based on the v3 Bot Framework SDK. If you're looking for current documentation (version 4.6 or later of the SDK) see the Conversational Bots section.

Microsoft Teams allows users to engage in direct conversations with bots built on the Microsoft Bot Framework. Users can find bots in the Discover Apps gallery and add them to their Teams experience for personal conversations. Team owners and users with the appropriate permissions can also add bots as team members (see Interact in a team channel), which not only makes them available in that team's channels, but for personal chat for all of those users as well.

Personal chat differs from chat in channels in that the user does not need to @mention the bot. If a bot is used in multiple contexts (personal, groupChat or channel) you will need to detect if the bot is in a group chat or channel, and process messages a little differently. See Interact in a team channel or group chat for more details.

Designing a great personal bot

A great bot in Microsoft Teams helps users get the information they need, all within the context of the Teams experience. Personal conversations with a bot are private exchanges between a bot and its user; they're a great way to provide information specific and relevant to that user in the personal context. A bot in personal chat is really a dialog between your service and the individual, where a bot in a group chat or channel broadcasts everything to a group of people.

Depending on the experience you want to create, the bot might need to work in multiple scopes - personal, groupChat and/or team. The work to support more than one scope is minimal. There is no expectation in Teams that your bot function in all scopes, but you should ensure that your bot makes sense and provides user value in whatever scope(s) you choose to support.

Best practice: Welcome messages in personal conversations

Your bot should proactively send a welcome message to a personal chat the first time (and only the first time) a user initiates a personal chat with your bot. (This recommendation does not apply to first-time contacts in a channel.)