Tutorial: Get started with Slack

Add Amazon Q Developer to the Slack workspace:

1. In Slack, on the left navigation pane, choose Automations.

   Note

   If you do not see Automations in the left navigation pane, choose More, then choose Automations.

2. If Amazon Q Developer is not listed, choose the Browse Apps Directory button.

3. Browse the directory for the Amazon Q Developer app and then choose Add to add Amazon Q Developer to your workspace.

Open the Amazon Q Developer in chat applications console at https://console.aws.amazon.com/chatbot/.

Under Configure a chat client, choose Slack, then choose Configure.

From the dropdown list at the top right, choose the Slack workspace that you want to use with Amazon Q Developer.

There's no limit to the number of workspaces that you can set up for Amazon Q Developer, but you can set up only one at a time.

Choose Allow.

Add Amazon Q Developer to the Slack channel:

1. In your Slack channel, enter invite @aws.

2. Choose Invite Them.

Associate a channel with your configuration:

1. On the Workspace details page in the Amazon Q Developer console, choose Configure new channel.

2. Under Configuration details, enter a name for your configuration. The name must be unique across your account and can't be edited later.

3. If you want to enable logging for this configuration, choose Publish logs to Amazon CloudWatch Logs. For more information, see Amazon CloudWatch Logs for Amazon Q Developer.

   Note

   There is an extra charge for using CloudWatch Logs.

4. For Slack channel, choose the channel you used in step 1. Amazon Q Developer supports both public and private channels.

   (Optional) To configure a private channel with Amazon Q Developer:

   1. In Slack, copy the Channel ID of the private channel by right-clicking on the channel name in the left pane and choosing Copy Link. The Channel ID is the string at the end of the URL (for example, AB3BBLZZ8YY).

   2. In Amazon Q Developer, paste the ID into the Channel URL field. (If you copy the URL of the private Slack channel, the Amazon Q Developer console shows only the Channel ID value when you paste it into the field.)

Define user permissions:

1. Choose your Role Setting.

   Tip

   Your role setting dictates what permissions your channel members have. A channel role gives all members the same permissions. This is useful if your channel members typically perform the same actions in Slack. A user role requires your channel members to choose their own roles. As such, different users in your channels can have different permissions. This is useful if your channel members are diverse or you don’t want new channel members to perform actions as soon as they join the channel. For more information, see Role setting.

   Channel role

   1. For Role setting, choose Channel role.

   2. For Channel role, choose Create an IAM role using a template. If you want to use an existing role instead, choose Use an existing IAM role. To use an existing IAM role, you will need to modify it for use with Amazon Q Developer. For more information, see Configuring an IAM Role for Amazon Q Developer.

   3. For Role name, enter a name. Valid characters: a-z, A-Z, 0-9, .\w+=,.@-_.

   4. (Optional) For Policy template, select Amazon Q permissions and any other templates you wish to use.

      Note

      The Amazon Q permissions template allows you to chat with Amazon Q Developer in natural language. For more information, see Chatting with Amazon Q Developer in chat channels.

      You can also use AWS software development kits (SDKs) to configure channels with Amazon Q permissions.

   User roles

   1. For Role setting, choose User roles.

2. Select the policies that will make up your channel guardrails. Your channel guardrails control what actions are available to your channel members.

3. (Optional) Add AmazonQDeveloperAccess as a channel guardrail to allow your users to chat with Amazon Q Developer from your Slack channel.

(Optional) Add Amazon SNS topics:

1. Choose your notification settings:

   1. For SNS Region, choose the AWS Region that hosts the SNS topics for this Amazon Q Developer subscription.

   2. For SNS topic, choose the Amazon SNS topic for the client subscription. This topic determines the content that's sent to the Slack channel. If the region has additional SNS topics, you can choose them from the same dropdown list. The SNS topics you choose must be configured in the services for which you want to receive notifications. For more information, see Monitoring AWS services using Amazon Q Developer in chat applications.

   3. To add an Amazon SNS topic from another AWS Region to the notification subscription, choose Add another Region.

      Note

      For a tutorial on subscribing existing Amazon SNS topics to Amazon Q Developer, see Tutorial: Subscribing an Amazon SNS topic to Amazon Q Developer.

      Notifications from supported services that publish to the chosen Amazon SNS topics will now appear in the Slack channel.

Choose Save.

Open the Amazon Q Developer console.

Choose the configured client you want to test.

In the configured client, choose the channel to send a test notification to.

Choose Send test message.

View the confirmation message at the top of the screen that shows a message was sent to your Amazon SNS topic.

Confirm the test message in your Slack channel.