Integrating Amazon Q Business Application with Slack Channel

In this blog, we will discuss the technical steps involved in integrating the Amazon Q Business Application with a Slack Channel.

Step 1: Create Integration in Amazon Q

1. Navigate to Amazon Q Business Applications.

1. Click on the Business App where you need to integrate with Slack.
2. Under Enhancements, click on Integrations.

1. Click on “Add integration” from the integrations tab.

1. You can create integrations with Slack and MS Teams.
2. Click on the “+” icon next to Slack to launch the Slack integration page.

1. On the “Add Slack integration” page, provide the name and description of your integration.

2. Under the Workspace section, provide the Slack workspace team ID starting with “T”. You can find this in the URL of the main page of your Slack workspace in the browser.
   Example: https://app.slack.com/client/T0123456789
   

3. Select the “Create and use a new service role” radio button under “Service access” and “Access management access”.

1. Click on “Add integration” once done.

Step 2: Deploy the Integration in Slack

1. After completing Step 1, your integration status will change to “ready to deploy”.

1. Open the integration and click on “Deploy integration” to start the integration with Slack.
2. A pop-up will appear with a link for accessing Slack. This link is used for integration with Slack.

1. Upon opening the link, it redirects to your Slack workspace and requests permissions to integrate with Slack. Upon providing confirmation in the Slack URL, it will start the integration, and you will receive a confirmation message once done.

1. The Slack integration status in the Amazon Q integrations page will change to “deployed”.

1. The Amazon Q app will automatically be available in the Slack channel under Apps.

Step 3: Using Amazon Q Application in Slack

1. Access the Amazon Q app on the Slack channel and say "Hello".
2. Amazon Q Business will reply, asking you to sign in.

1. Click on the link, which redirects to the AWS login page.
2. Log in with your Amazon Q user with an “Amazon Q Business Pro” license. • Note: Please ensure you have a confirmed identity source in the “IAM Identity Center” for this authentication to work.
3. After signing in, I asked the bot some questions but received the following error: • “There was an error processing your Amazon Q Business chat. Error from Q Business: No retriever is in a valid state. (Service: QBusiness, Status Code: 409, Request ID:...)”

1. I realized that I hadn’t configured a data source for my Amazon Q Business App, hence the error.
2. I went back and integrated my S3 bucket as the data source. You can add multiple data sources to the Amazon Q Business App.
3. After adding my data source to the Amazon Q Business App, it started giving me the right answers, as shown in the screenshot below.

---

I hope this blog is informative and gives you an idea of how to integrate the Amazon Q Business App with Slack. Please leave any questions or comments below.

---