# Integrating Microsoft Outlook with the Amazon Q Business Add-in Microsoft Outlook Amazon Q Business can enhance your users' Microsoft Outlook (Outlook) experience by increasing their email productivity, bringing Amazon Q's AI-powered assistance directly into their daily email workflows. As your users use their email, the Amazon Q Add-in can answer questions, provide summaries, draft responses and get insights from emails threads it has access to or from its general knowledge right in your Outlook enhancing your users' email productivity by bringing Amazon Q's AI-powered assistance directly into their daily email workflows. With the Amazon Q Outlook Add-in your users can: + Summarize your emails + Draft contextual responses + Access Amazon Q's company knowledge and general knowledge + Upload documents and use other features available in [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 Outlook Add-in for use ](configuring-integration-msoutlook.md) + [ ## Removing the Amazon Q Business Add-in as a Microsoft Outlook integration ](#removing-integration-msoutlook) + [ # Using the Amazon Q Business Add-in for Microsoft Outlook ](using-integration-msoutlook.md) # Configuring the Amazon Q Business Microsoft Outlook Add-in for use Configuring **Note** The Amazon Q Business customer integrating Microsoft Outlook (Outlook) must have a paid Outlook 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 does not support the Outlook Add-in. Access using the Amazon Q Business API is not supported at this time. Amazon Q Business does not use 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 section ](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/using-web-experience.html#upload-documents) in the Using web experience topic. **Topics** + [ ## Prerequisites for integrating the Amazon Q Microsoft Outlook Add-in ](#integration-msoutlooks-prerequisites) + [ ## Integrating Microsoft Outlook with the Amazon Q Business Add-in ](#integrating-integration-msoutlook) ## Prerequisites for integrating the Amazon Q Microsoft Outlook Add-in Prerequisites As admins, before you can integrate the Amazon Q Business Microsoft Outlook (Outlook) Add-in, 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. You need 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*. 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](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application.html) and create your Amazon Q Business web experience. **Note** [IAM federated application environments](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application-iam.html) do not support integrations with Outlook. 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. To use this feature, you must 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 [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_ChatSync.html#qbusiness-ChatSync-request-chatMode](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_ChatSync.html#qbusiness-ChatSync-request-chatMode) if you are configuring programmatically. ## Integrating Microsoft Outlook with the Amazon Q Business Add-in Integrating To use the Amazon Q Business Add-in for Microsoft Outlook, you must allow it to connect to your Amazon Q Business application environment and web experience. **Note** This integration can only be added using the Amazon Q Business console. ### Using the console 1. Sign in to the Amazon Q Business 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 Outlook** as your integration. 1. On the **Add Outlook 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. In the **Workspace** section, enter your Microsoft **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 Outlook 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 Outlook 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 you have added the integration, Amazon Q will deploy your integration. You will see that update on the **Integration details page**. Once the integration is *deployed*, choose the name of your Outlook integration from the list of integrations in the **Integrations** section. 1. Copy the **Manifest URL** in the **Integration details** section. **Note** You will now continue the remainder of this procedure within the *Microsoft 365 admin center*. 1. In the Microsoft 365 admin center, choose **Integrated apps** from the left navigation and choose **Upload custom apps** This will open the **Deploy New App** page. 1. Choose **Office Add-in** as your App type. 1. Paste the manifest URL link you copied in the **Provide link to manifest file** and choose **Validate**. 1. Choose the users you want to add in the **Add users** section. 1. Choose **Accept permissions** in the **Accept permissions requests** section and deploy the Add-in. Once deployment is completed, you users will be able to install the Amazon Q Business Add-in in their Microsoft Outlook. **Note** Authentication may be required. ## Removing the Amazon Q Business Add-in as a Microsoft Outlook integration Removing To remove the Microsoft Outlook (Outlook) integration, Admin users can use the Amazon Q Business console. **Note** This integration can only be added using the Amazon Q Business console. ### Using the console 1. Sign in to the Amazon Q Business console. 1. Choose **Applications**, then select the name of your application environment from the list. 1. Choose **Integrations** under **Enhancements**. 1. Choose your integration from the list in the **Integrations** section and choose **Delete**. Confirm your choice and choose **Delete**. **Note** You will now continue the remainder of this procedure within the *Microsoft 365 admin center*. 1. Once your integration has been deleted, login to the Microsoft 365 admin center and choose **Integrated apps** from the left navigation. 1. Choose Amazon Q Business **Office Add-in** as your App and choose **Remove app** from the Amazon Q Business property details section that pops up. **Confirm** your choice. **Note** Once you remove your Microsoft Outlook (Outlook) Add-in from here, the Add-in will no longer appear as an Add-in to use or add in their Outlook. # Using the Amazon Q Business Add-in for Microsoft Outlook Using **Topics** + [ ## Prerequisites ](#integration-msoutlook-user-prerequisites) + [ ## Install the Amazon Q Business Add-in to your Microsoft Outlook ## Install the Add-in ](#install-configure-integration-msoutlook) + [ ## Common use cases for using the Amazon Q Business Add-in for Microsoft Outlook ](#integration-msoutlook-common-use-cases) + [ ## Considerations for using the Amazon Q Business Add-in for Microsoft Outlook ](#integration-msoutlook-considerations) + [ ## Troubleshooting the Amazon Q Business Add-in for Microsoft Outlook ](#integration-msoutlook-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 add the Amazon Q Business Add-in to your Microsoft 365 organization. ## Install the Amazon Q Business Add-in to your Microsoft Outlook ## Install the Add-in The following are instructions on how to install the Amazon Q app in Microsoft Outlook (Outlook): 1. Open your Microsoft Outlook. 1. Go to **Add-Ins** and search for *Amazon Q Business* and choose **Amazon Q Business** 1. You will now see a **Q** icon/logo on the top bar on the right where you can access the Amazon Q Business chat assistant. 1. Once you have successfully logged on, you can use your Amazon Q Business Add-In. ## Common use cases for using the Amazon Q Business Add-in for Microsoft Outlook Use cases The following are some of the common use cases that will help you make the best use of your Amazon Q Business Add-in for Microsoft Outlook (Outlook): 1. **Analyze email threads**: Get summaries of long email discussions and identify key points, decisions, and action items. 1. **Draft email responses**: Select an email thread and ask Amazon Q to help draft appropriate responses based on the conversation context. 1. **Ask questions about email content**: Select any portion of an email thread and add it to the context, then ask your question. You can include multiple emails to provide more context. 1. **Ask a question about Amazon Q's company knowledge and general** (if enabled). 1. **Generate email content**: Describe what you need, and Amazon Q will generate suggested email content that matches the conversation's tone and context. 1. **Analyze up to 4 files that you want to send or have received for (collective) analysis**. ## Considerations for using the Amazon Q Business Add-in for Microsoft Outlook Considerations 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 Microsoft Outlook (Outlook) 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. To reset your conversation context, choose *new chat*. If you close the Amazon Q Business chat panel it will end the conversation and will start a new conversation the next time you reopen it. 1. All conversations with Amazon Q including uploaded web page snapshots and files from the Outlook will be deleted after 30 days of inactivity. 1. You can access all history of previous conversations (including attachments to those conversations) that have not been deleted from the Amazon Q web experience conversation history. 1. Amazon Q's responses aren't always 100% accurate. 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 Add-in for Microsoft Outlook Troubleshooting + **My admin has enabled the Microsoft Outlook (Outlook), but I'm unable to login.** Try having a conversation on your Amazon Q web experience first and then try the Microsoft Outlook (Outlook) again. If this doesn't work, then contact your Amazon Q admin or IT department. + **Amazon Q doesn't respond helpfully or doesn't use the context of my email or document.** Try starting a new chat. If it still does not work, submit feedback using the feedback button and include any non-confidential details about the type of web page where the extension failed. + **I get the error, 'To use the Amazon Q Business Add-in your administrator needs to enable "Allow end users to send queries directly to the LLM" in the Amazon Q Business console'**. Contact your Admin or IT department with the error. + **Amazon Q doesn't recognize updated information when my thread updates.** Amazon Q only has access to your email thread right at the point you are viewing it. Similar to a photograph, this is all the information in the email thread is from the point it is viewed. To refresh the snapshot of your thread, go to the latest message in the thread.