# Integrating Microsoft Word with the Amazon Q Business Add-in
Amazon Q Business can enhance your users' Microsoft Word (Word) experience by increasing their productivity, bringing Amazon Q's AI-powered assistance directly into their daily document workflows. As your users work on their documents, the Amazon Q Add-in can answer questions, review documents, suggest revisions and get insights from documents it has access to or from its general knowledge enhancing your users' productivity by bringing Amazon Q's AI-powered assistance directly into their document workflows.
With the Amazon Q Word Add-in your users can:
+ Review, draft, and revise documents
+ Summarize documents and get insights
+ Simplify and improve your writing
+ 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 Word Add-in for use](configuring-integration-msword.md)
+ [Removing the Amazon Q Business Add-in as a Microsoft Word integration](#removing-integration-msword)
+ [Using the Amazon Q Business Add-in for Microsoft Word](using-integration-msword.md)
# Configuring the Amazon Q Business Microsoft Word Add-in for use
**Note**
The Amazon Q Business customer integrating Microsoft Word (Word) must have a paid Word 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 Word 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 Word Add-in](#integration-mswords-prerequisites)
+ [Integrating Microsoft Word with theAmazon Q Business Add-in](#integrating-integration-msword)
## Prerequisites for integrating the Amazon Q Microsoft Word Add-in
As admins, before you can integrate the Amazon Q Business Microsoft Word (Word) 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 Word.
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 Word with theAmazon Q Business Add-in
To use the Amazon Q Business Add-in for Microsoft Word, 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 **Word** as your integration.
1. On the **Add Word 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 Word 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 Word 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 Word 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 Word.
**Note**
Authentication may be required.
## Removing the Amazon Q Business Add-in as a Microsoft Word integration
To remove the Microsoft Word (Word) 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 Word (Word) Add-in from here, the Add-in will no longer appear as an Add-in to use or add in their Word.
# Using the Amazon Q Business Add-in for Microsoft Word
**Topics**
+ [Prerequisites](#integration-msword-user-prerequisites)
+ [Install the Amazon Q Business Add-in to your Microsoft WordInstall the Add-in](#install-configure-integration-msword)
+ [Common use cases for using the Amazon Q Business Add-in for Microsoft Word](#integration-msword-common-use-cases)
+ [Considerations for using the Amazon Q Business Add-in for Microsoft Word](#integration-msword-considerations)
+ [Troubleshooting the Amazon Q Business Add-in for Microsoft Word](#integration-msword-troubleshooting)
## 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 Word
## Install the Add-in
The following are instructions on how to install the Amazon Q app in Microsoft Word (Word):
1. Open your Microsoft Word.
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 Word
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 Word (Word):
1. **Review your document**: Select the text you want to review and get suggestions for improving clarity, grammar, and style.
1. **Summarize the document/generate content**: Open the Amazon Q Business add-in when reviewing a document and click on the **executive summary**, or **generate conclusion** quick prompts
1. **Ask questions about your content**: Select any portion of your document and add it as context, and ask your question. You can select multiple sections to provide more context or use quick prompts such as **explain in simple terms**.
1. **Simplify your content**: Select any portion of your document and ask your question. You can select multiple sections to provide more context or use quick prompts such as **simplify writing**.
1. **Generate content suggestions**: Select where you want to add content, describe what you need, and Amazon Q will generate suggestions that match your document's style and context.
1. **Draft your document or improve sections of your document:** Describe what you need, and Amazon Q will generate suggested draft content that matches the context.
1. **Ask a question about Amazon Q's company knowledge and general knowledge** (if enabled).
1. **Analyze up to 4 files that you want to review, summarize, or get insights from for (collective) analysis**.
## Considerations for using the Amazon Q Business Add-in for Microsoft Word
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 Word (Word) 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 Word 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 Word
+ **My admin has enabled the Microsoft Word (Word), but I'm unable to login.**
Try having a conversation on your Amazon Q web experience first and then try the Microsoft Word (Word) 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.