| title | author | description | ms.topic | ms.localizationpriority | ms.author |
|---|---|---|---|---|---|
Map your use cases to Teams app features and capabilities |
surbhigupta |
Identify how your app's use cases can work within the Teams experience, app features and capabilities; map common use cases with capabilities. |
conceptual |
high |
anclear |
A well-defined use case helps you to chart out the framework of features you want in the Teams app. After you've determined the user requirements, define the scope and Teams capability best suited for your app.
You can map your use case based on:
- Sharing and collaborating on items in an external system.
- Starting workflows and sending notifications to users.
- Using social platforms, conversational bots, and combining multiple features.
The next step is to match use cases with app capabilities.
Here's a list of common user scenarios mapped to Teams capabilities. It isn't an exhaustive list, but helps you think through some of the possibilities available to you.
Create, share, and collaborate on items in an external system
Apps to interact with your data
| If you want to... | Try ... |
|---|---|
| Search external systems and share the results as an interactive card. | Message extensions with search commands |
| Collect information to insert into a data store or run advanced searches. | Message extensions with action commands |
| Create embedded web experiences to view, work with and share data. | Tabs |
| Push data and send data out of the Teams client. | Connectors and webhooks |
| Interactive modal forms from wherever you need them to collect or display information. | Task modules |
Initiate workflows and processes
A quick way to start a process or workflow in an external system.
| If you want to... | Try ... |
|---|---|
| Trigger messages, allowing your users to quickly send the contents of a message to your web services. | Message extensions action commands |
| Open messages from a tab, a bot, or a message extension to collect information before initiating a workflow. | Task modules |
| Interact with your users through text and rich cards. | Conversational bots |
| A good choice for a simple back-and-forth interaction when you don't need to build an entire conversational bot. | Outgoing webhooks |
Send notifications and alerts
Send asynchronous notifications and alerts to your users in Teams.
| If you want to... | Try ... |
|---|---|
| Send proactive messages to groups, channels, or individual users. | Conversational bots |
| Permit a channel to subscribe to receive messages. A connector lets users tailor the subscription with a configuration page. | Connectors and incoming webhooks |
Ask questions and get answers
Connect with your users and resolve their queries
| If you want to... | Try ... |
|---|---|
| Natural language processing, AI, machine learning, and all the buzzwords. Use a bot powered by the intelligent cloud to connect your users to the answers they need. | Conversational bots |
| Embed your existing web portal in Teams or create a Teams-specific version for added functionality. | Tabs |
The Microsoft Teams platform offers a large variety of features. Each feature is a way of interacting with your users that makes the Teams app capability relevant to the user need.
Let's look at how Teams capabilities enable different features for your app.
:::image type="content" source="../../assets/images/overview/teams-apps-capabilities.png" alt-text="Image showing Teams capabilities":::
For example:
- Use the tab capability to display task modules, request device permissions, display <
iframe> content, or using deep links. - Use the message extension capability to send cards, unfurl links, or take action on messages.