# Integrating Slack with Amazon Q Business Slack Amazon Q Business can enhance your users' Slack experience by increasing their productivity, bringing Amazon Q's AI-powered assistance directly into their daily workflows. With the Amazon Q assistant in Slack, 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 Slack AI assistant side panel. Users can also mention *@Amazon Q Business* in Slack 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 Slack integration your users can do the following: + Mention @*Amazon Q Business* in conversations to add it as a collaborator. + Ask contextual questions about conversations like "summarize this thread". + 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 Slack integration for use ](slack-configuration.md) + [ # Using the Amazon Q Business Slack App ](slack-using.md) # Configuring the Amazon Q Business Slack integration for use Configuring Slack Integration The Amazon Q Business integration for Slack is only available for use by Amazon Q Business Pro users. **Note** When Amazon Q is invoked by a user in a public Slack 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 Slack must have a paid Slack workspace. Amazon Q only supports user access management through IAM Identity Center for Slack integrations. This includes authentication using external SAML providers through IAM Identity Center. To integrate Slack with Amazon Q, you must create an IAM Identity Center-integrated application. 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 doesn't support Slack integrations for [Amazon Q applications using IAM federation](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application-iam.html) for user access management. 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 ](#slack-configuration-prerequisites) + [ ## Adding an Amazon Q Business integration for Slack ](#slack-adding) + [ ## Removing Slack as an integration ](#slack-removing) ## Prerequisites Prerequisites As admins, before you can add the Amazon Q Business integration to your Slack, you must complete the following steps: 1. Must have a paid Slack workspace 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** Amazon Q doesn't support Slack integrations for [Amazon Q applications using IAM federation](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application-iam.html) for user access management. 1. Optionally, to enhance your end users' experience with Amazon Q in Slack, 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. Admin access to your Slack workspace. 1. Your Slack workspace ID. Your WorkSpace ID must start with a *T*. One way to find your Slack workspace ID is by navigating to your Slack workspace and starting a chat with the *Slack Developer Tools* app running the `/sdt whoami` command. For more information, see [Locate your Slack URL or ID](https://slack.com/help/articles/221769328-Locate-your-Slack-URL-or-ID) in the Slack help center. ## Adding an Amazon Q Business integration for Slack Adding Slack Integration To use the Amazon Q Business Slack 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 ](#slack-adding-console) + [ ### Installing the Amazon Q Business App in your Slack workspace ](#slack-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 **Slack** as your integration. 1. On the **Add Slack 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 Slack workspace ID. This is a unique identifier of your Slack workspace starting and can be found using the Slack developer tools app. To find your workspace ID: 1. Navigate to your Slack workspace and in “Apps” search for “Slack Developer Tools”. 1. Open the Slack Developer Tools app and run the command /sdt whoami 1. You will receive a response that contains your Workspace ID starting with a “T” 1. For other ways to locate your workspace ID, refer to [Locate your Slack URL or ID](https://slack.com/help/articles/221769328-Locate-your-Slack-URL-or-ID) in the Slack help center. 1. Choose the type of **Service access** method that you want the Slack 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 Slack 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 Slack 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 Slack**. **Note** This link will take you to the Slack domain outside of AWS. 1. You will continue this procedure within the Slack domain. ### Installing the Amazon Q Business App in your Slack workspace Installing in Slack The following instructions show how to install the Amazon Q Business App in your Slack workspace using a link from the Amazon Q console as shown in the previous topic. **Note** Only a Slack workspace owner can use the link to install the Amazon Q App into your Slack workspace. There can be only one instance of the Amazon Q App per Slack workspace. That instance will be connected to the application environment that integration was configured with in the previous topic. You may see a "This app is not approved by Slack banner." This message can be ignored. 1. The link will open to a Slack login page where after you login (as admin) you will need to find and be asked to install the Amazon Q app within your Slack workspace. 1. Choose **Allow** to install your Amazon Q App for Slack. 1. Once the installation is complete, you will see the page confirming that the **Congratulations\$1 Your Slack App has been successfully installed.** 1. Choose **Open the Amazon Q Business App in Slack**. 1. This will open your Slack workspace where all users will be required to sign-in. ## Removing Slack as an integration Removing Slack Integration To remove the Slack 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 Slack integration from the **Integrations** section on the main page. 1. Choose **Delete** and confirm your choice. Once you disable your Slacks 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 Slack Workspace. # Using the Amazon Q Business Slack App Using Slack App The Amazon Q Business Slack app is available to all Amazon Q Business users. **Topics** + [ ## Prerequisites ](#slack-using-prerequisites) + [ ## Install and configure the Amazon Q Business App in Slack ](#slack-using-install) + [ ## Features of the Amazon Q Business Slack App ](#slack-using-features) + [ ## Considerations for using the Amazon Q Business App for Slack ](#slack-considerations) + [ ## Troubleshooting the Amazon Q Business App for Slack ](#slack-troubleshooting) ## Prerequisites Prerequisites + Your Amazon Q admin must connect the Amazon Q Business Slack app to your Slack workspace. ## Install and configure the Amazon Q Business App in Slack Install and Configure The following are instructions on how to install the Amazon Q Business App in Slack: 1. Open and login to the Slack workspace for your company. 1. Choose **More** in the left navigation, then select **Automations**. 1. Choose **Apps**. 1. Choose **\$1 Add apps** 1. Search for "Amazon Q Business" and choose **Amazon Q Business** 1. This will take you to the **About** page. Choose the 3 vertical dots (that say "more actions") to the right of the New Chat button. 1. Choose **add assistant to top bar** 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 [Understand AI apps in Slack](https://slack.com/help/articles/33076000248851-Understand-AI-apps-in-Slack#find-apps) in the Slack help center. ## Features of the Amazon Q Business Slack App Features Following are some of the features supported by the Amazon Q Slack App: + In direct messages (DMs) to the Amazon Q Business contact, it responds to all messages and queries. + In channels it responds only to @mentions, and always replies in thread. + 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. **Important** The Amazon Q Business Slack integration does not support [actions or plugins](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/actions.html). ## Considerations for using the Amazon Q Business App for Slack Considerations 1. When Amazon Q is invoked by a user in a public Slack 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 browser extension 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 Slack app will have access to the same knowledge available in the corresponding Amazon Q Business web experience. 1. To reset, start new conversation, direct message as a *New chat*. 1. When you upload a file, the Amazon Q Slack app 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 Slack app side panel will end the current conversation. Users can review past conversations in Slack or all conversations from all channels (Slack, 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. Slack may store conversations for longer depending on your company's Slack 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 Slack Troubleshooting My admin has enabled the Amazon Q Business app for Slack, but I'm unable to login. Try having a conversation on your Amazon Q web experience first and then try Slack 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 in the browser extension. 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.