# Integrating Microsoft Teams (Teams) with Amazon Q Business Microsoft Teams Amazon Q Business can enhance your users' Microsoft Teams (Teams) experience by increasing their productivity, bringing Amazon Q's AI-powered assistance directly into their daily workflows. With the Amazon Q Assistant in Teams, users can access Amazon Q's knowledge without context switching during communications. Users can ask Amazon Q questions about its company knowledge, general knowledge (if enabled), and uploaded files using the Teams AI assistant side panel. Users can also mention *@Amazon Q Business* in Teams threads to add it as a collaborator and ask contextual questions about the thread such as "*what are the action items from this thread?*" or "*summarize this thread*". With the Amazon Q Microsoft Teams (Teams) integration your users can do the following: + Mention @*Amazon Q Business* in conversations to add it as a collaborator. + Access Amazon Q's general knowledge. + Access their company's knowledge (if enabled). + Upload documents and other features that they have access to in the [using the Amazon Q web experience](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/using-web-experience.html#upload-documents). **Topics** + [ # Configuring the Amazon Q Business Microsoft Teams (Teams) integration for use ](msteams-configuration.md) + [ # Using the Amazon Q Business Microsoft Teams app ](msteams-using.md) # Configuring the Amazon Q Business Microsoft Teams (Teams) integration for use Configuring Teams Integration **Note** When Amazon Q is invoked by a user in a public Teams channel, it generates responses based on the invoking user's permissions, which may include content that other channel members aren't authorized to access. To prevent unintended exposure of sensitive information, carefully evaluate the use of Amazon Q in public channels. The Amazon Q Business customer integrating Microsoft Teams (Teams) must have a paid Teams organization. Amazon Q supports users who authenticate using external SAML providers through IAM Identity Center. For more information, see [Create an IAM Identity Center-integrated application](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application.html). Amazon Q application environment created with IAM Federation do not support integrations with Teams at this time. Access using the Amazon Q Business API is not supported at this time. Amazon Q Business does not use your user data for service improvement or for training its underlying large language models (LLMs). For more information, see [Amazon Q Business Service improvement](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/service-improvement.html). Uploading documents and conversations will follow the same behavior as the web experience. For more information, see the [Chat and file uploads](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/using-web-experience.html#upload-documents) section in the Using web experience topic. **Topics** + [ ## Prerequisites ](#msteams-configuration-prerequisites) + [ ## Adding an Amazon Q Business integration for Microsoft Teams ](#msteams-adding) + [ ## Removing Microsoft Teams as an integration ](#msteams-removing) ## Prerequisites Prerequisites As admins, before you can add the Amazon Q Business integration to your Microsoft Teams (Teams), you must complete the following steps: 1. You must have a Microsoft 365 Business subscription and be a *Global Admin* or someone with administrative permissions, specifically `AppCatalog.ReadWrite.All`. 1. [Get started with Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/getting-started.html) 1. [Create an IAM Identity Center-integrated application environment](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application.html) environment and create your Amazon Q Business web experience. **Note** [IAM federated application environment](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application-iam.html) environments do not support integrations with Teams. 1. Optionally, to enhance your end users' experience with Amazon Q in Teams, you can enable *Allow end users to send queries directly to the LLM* in your Admin controls and guardrails. For more information, see the [Response settings](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/guardrails-global-controls.html#guardrails-global-response) topic in [Admin controls and guardrails](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/guardrails.html) and `chatMode` if you are configuring programmatically. 1. Add the two IAM roles and trust policies for adding integrations. For more information, see [IAM roles and trust policy for your integrations](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/amazon-q-business-integrations-iam.html) 1. Your Microsoft 365 tenant ID. For more information, see [How to find your tenant ID - Microsoft Entra](https://learn.microsoft.com/en-us/entra/fundamentals/how-to-find-tenant) in the Microsoft Learn portal. ## Adding an Amazon Q Business integration for Microsoft Teams Adding Teams Integration To use the Amazon Q Business Teams integration, you must allow it to connect to your Amazon Q Business application environment and web experience. To do this, admins can use the Amazon Q Business console, API, SDK, or AWS CLI. **Note** This integration can only be added using the AWS Management Console at this time. **Topics** + [ ### Using the console ](#msteams-adding-console) + [ ### Installing the Amazon Q Business app in your Microsoft Teams organization ](#msteams-installing) ### Using the console Console 1. Sign in to the Amazon Q console. 1. Choose **Applications**, then select the name of your application environment from the list. 1. Choose **Integrations** under **Enhancements**. 1. Choose **Add integration** from the **Integrations** section on the main page. 1. Choose **Microsoft Teams** as your integration. 1. On the **Add Teams integration page**, enter the **Name** of your integration. This is the display name for the integration resource in AWS. 1. Add a **description** (optional). 1. Enter your **Teams Tenant ID**. This can be found in the *Microsoft Entra Admin Center*. For more information, see [How to find your tenant ID - Microsoft Entra](https://learn.microsoft.com/en-us/entra/fundamentals/how-to-find-tenant) 1. Choose the type of **Service access** method that you want the Teams integration to use as authorization while accessing your service. You can **Create a new service role** or **Use an existing service role**. For more information, see [IAM role for allowing the integration to call Amazon Q Business on your end user's behalf](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/amazon-q-business-integrations-iam-allow-integration-access.html). 1. Choose the **Access management access** for the Teams integration to authorize to connect to IAM Identity center. For more information, see [IAM role for allowing Amazon Q Business to monitor the resources that the integration creates in your account](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/amazon-q-business-integrations-iam-allow-qbusiness-monitor.html). 1. Optionally, add any **Tags** that are relevant for this Teams integration. 1. Choose **Add integration**. 1. Once the integration has been successfully created, you will move to the **Integration details page**. 1. Choose **Deploy integration**. 1. Choose **Access Teams**. **Note** This link will take you to the Teams domain outside of AWS. 1. You will continue this procedure within the Teams domain. ### Installing the Amazon Q Business app in your Microsoft Teams organization Installing in Teams The following instructions show how to install the Amazon Q Business App in your Microsoft Teams (Teams) workspace using a link from the Amazon Q console as shown in the previous topic. **Note** Only a Teams *Global Admin* or someone with administrative permissions can add the Amazon Q Business App to your Teams organization, specifically `AppCatalog.ReadWrite.All`. There can be only one instance of the Amazon Q App per Teams organization. That instance will be connected to the application environment that the Teams integration was configured with in the previous topic. 1. Open the link and login as Global Admin or or someone with administrative permissions can add the Amazon Q Business App to the Microsoft Teams admin center for your organization. 1. Choose **Teams apps** in the left navigation. 1. Choose **Amazon Q Business** from the list of available apps. 1. Review and grant admin consent by choosing the **Permissions** tab and reviewing the permissions and choose **Grant admin consent**. **Note** If permissions are already granted, proceed to the end of the procedure, there is no further action required. 1. Authenticate and choose **Accept** for Amazon Q Business app. 1. Confirm that an app titled **Amazon Q Business Permissions** tab now says **Admin consent granted for all required permissions**. All users assigned to the app from the **Teams admin center** can now find the app in the **Built for your org** section of the **Apps** page of their Teams app. ## Removing Microsoft Teams as an integration Removing Teams Integration To remove the Microsoft Teams (Teams) integration, admin users can use the Amazon Q Business console. **Note** This integration can only be removed using the AWS Management Console at this time. ### Using the console Console 1. Sign in to the Amazon Q console. 1. Choose **Applications**, then select the name of your application environment from the list. 1. Choose **Integrations** under **Enhancements**. 1. Find and select your Teams integration from the **Integrations** section on the main page. 1. Choose **Delete** and confirm your choice. Once you disable your Microsoft Teams (Teams) integration, your users will no longer be able to login. However you will still need to take steps to uninstall the Amazon Q Business App in your Teams organization. # Using the Amazon Q Business Microsoft Teams app Using Teams App **Topics** + [ ## Prerequisites ](#msteams-using-prerequisites) + [ ## Install and configure the Amazon Q Business app in Microsoft Teams ](#msteams-using-install) + [ ## Features of the Amazon Q Business Microsoft Teams bot ](#msteams-using-features) + [ ## Considerations using the Amazon Q Business bot for Microsoft Teams (Teams) ](#msteams-considerations) + [ ## Troubleshooting the Amazon Q Business app for Microsoft Teams ](#msteams-troubleshooting) ## Prerequisites Prerequisites + You must have an Amazon Q Business user subscription. + You must have a Microsoft 365 Business subscription. + Your Amazon Q admin must connect the Amazon Q Business App to your Microsoft Teams organization. ## Install and configure the Amazon Q Business app in Microsoft Teams Install and Configure The following are instructions on how to install the Amazon Q app in Microsoft Teams (Teams): 1. Open and login to the Teams organization for your company. 1. Go to **Apps** on the left navigation and search for *Amazon Q Business* 1. Choose **Amazon Q Business** 1. You will now see a **Q** icon/logo on the top bar on the right where you can access and chat with Amazon Q Business. For more information, see [Chat with a bot in Microsoft Teams](https://support.microsoft.com/en-us/office/chat-with-a-bot-in-microsoft-teams-9c7bab5e-b1a2-4e35-801a-80d076e26f3f) from Microsoft support. ## Features of the Amazon Q Business Microsoft Teams bot Features Following are some of the features supported by the Amazon Q Microsoft Teams (Teams) App: + In direct messages (DMs) to the Amazon Q contact, it responds to all messages and queries. + In channels it responds only to @mentions, and always in replies. + Thumbs up and down buttons to track feedback and help improve performance over time. + Provides Source Attribution - see references to sources used by Amazon Q Business. + It tracks the conversation and applies context. + Process up to 5 attached files for contextual question answering, summaries, etc. JPEG/JPG image file types are not supported as file uploads in the Teams integration. **Important** The Amazon Q Business Microsoft Teams integration does not support [actions or plugins](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/actions.html). ## Considerations using the Amazon Q Business bot for Microsoft Teams (Teams) Considerations 1. When Amazon Q is invoked by a user in a public Teams channel, it generates responses based on the invoking user's permissions, which may include content that other channel members aren't authorized to access. To prevent unintended exposure of sensitive information, carefully evaluate the use of Amazon Q in public channels. 1. Amazon Q Business does not use customer data for service improvement or for improving its underlying large language models (LLMs). Also, none of the data you include in your Teams conversations will be indexed into your company's Amazon Q Business instance. For more information, see [Amazon Q Business Service improvement](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/service-improvement.html). 1. The Amazon Q Business Teams app will have access to the same knowledge available in the corresponding Amazon Q Business web experience. 1. To reset, start new conversation, using the */new\$1conversation* command. 1. When you upload a file, the Amazon Q bot for Teams will only be able to respond from the file (and general knowledge if your Amazon Q admin has enabled it). Start a new chat if you want to return to getting answers from company knowledge. 1. Closing the Amazon Q Business bot for Teams side panel will end the current conversation. Users can review past conversations in Teams or all conversations from all channels (Teams, browser extensions, etc.) in your Amazon Q Business web experience. You can access all the history of previous conversations including, the names of the attachments in those conversations. 1. All conversations in Amazon Q Business are deleted after 30 days of inactivity. Teams may store conversations for longer depending on your company's Teams conversation history rules. 1. Amazon Q may provide inaccurate responses at times. For more information, see [Hallucination](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/concepts-terms.html#hallucination) in the topic Key concepts of Amazon Q Business. ## Troubleshooting the Amazon Q Business app for Microsoft Teams Troubleshooting My admin has enabled the Amazon Q Business app for Microsoft Teams (Teams), but I'm unable to login. Try having a conversation on your Amazon Q web experience first and then try Teams again. If this doesn't work, then contact your Amazon Q admin or IT department. I am getting a "Can't access document" error. This happens when a document uses an unsupported format from which Amazon Q app is unable to pull relevant data to provide a helpful response. If you encounter this error and would like your file format to be supported, please submit feedback via the feedback button. Amazon Q doesn't respond helpfully or doesn't use the context of the document I added. Try starting a new chat and adding the document again. If it still does not work, contact your Amazon Q Business admin for further support.