Configuring a Slack channel - Amazon Web Services Support
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Configuring a Slack channel

After you authorize your Slack workspace, you can configure your Slack channels to use the Amazon Web Services Support App.

The channel where you invite and add the Amazon Web Services Support App is where you can create and search for cases, and receive case notifications. This channel shows case updates, such as newly created or resolved cases, added correspondences, and shared case details.

The Slack channel inherits permissions from the IAM role. This means that any user in the Slack channel has the same permissions that are specified in the IAM policy that is attached to the role.

For example, if your IAM policy allows the role to have full read and write permissions to your support cases, anyone in your Slack channel can create, update, and resolve your support cases. If your IAM policy allows the role read-only permissions, then users in your Slack channel only have read permissions to your support cases.

You can add up to 20 channels for an account. A Slack channel can have up to 100 Amazon Web Services accounts. This means that only 100 accounts can add the same Slack channel to the Amazon Web Services Support App. We recommend that you only add the accounts that you need to manage support cases for your organization. This can reduce the number of notifications that you receive in the channel so that you and your team have fewer distractions.

Each Amazon Web Services account must configure a Slack channel separately in the Amazon Web Services Support App. This way, the Amazon Web Services Support App can access the support cases in that Amazon Web Services account. If another Amazon Web Services account in your organization already invited the Amazon Web Services Support App to that Slack channel, skip to step 3.

Note

You can configure channels that are part of Slack Connect and channels that are shared with multiple workspaces. However, only the first workspace that configured the shared channel for an Amazon Web Services account can use the Amazon Web Services Support App. The Amazon Web Services Support App returns an error message if you try to configure the same Slack channel for another workspace.

To configure a Slack channel
  1. From your Slack application, choose the Slack channel that you want to use with the Amazon Web Services Support App.

  2. Complete the following steps to invite the Amazon Web Services Support App to your channel:

    1. Choose the + icon and enter invite, and then, when prompted, choose Add apps to this channel.

    2. To search for the app, under Add apps to channelName enter Amazon Web Services Support App.

    3. Choose Add next to the Amazon Web Services Support App.

  3. Sign in to the Support Center Console and choose Slack configuration.

  4. Choose Add channel.

  5. On the Add channel page, under Workspace, choose the workspace name that you previously authorized. You can choose the refresh icon if the workspace name doesn't appear in the list.

  6. Under Slack channel, for Channel type, choose one of the following:

    • Public – Under Public channel, choose the Slack channel that you invited the Amazon Web Services Support App to (step 2). If your channel doesn't appear in the list, choose the refresh icon and try again.

    • Private – Under Channel ID, enter the ID or the URL of the Slack channel that you invited the Amazon Web Services Support App to.

      Tip

      To find the channel ID, open the context (right-click) menu for the channel name in Slack, and then choose Copy, and then choose Copy link. Your channel ID is the value that looks like C01234A5BCD.

  7. Under Channel configuration name, enter a name that easily identifies your Slack channel configuration for the Amazon Web Services Support App. This name appears only in your Amazon Web Services account and doesn't appear in Slack. You can rename your channel configuration later.

    Your Slack channel type might look like the following example.

  8. Under Permissions, for IAM role for the Amazon Web Services Support App in Slack, choose a role that you created for the Amazon Web Services Support App. Only roles that have the Amazon Web Services Support App as a trusted entity appear in the list.

    Note

    If you haven't created a role or don't see your role in the list, see Managing access to the Amazon Web Services Support App.

  9. Under Notifications, specify how to get notified for cases.

    • All cases – Get notified for all case updates.

    • High-severity cases – Get notified for only cases that affect a production system or higher. For more information, see Choosing a severity.

    • None – Don't get notified for case updates.

  10. (Optional) If you choose All cases or High-severity cases, you must select at least one of the following options:

    • New and reopened cases

    • Case correspondences

    • Resolved cases

    The following channel receives case notifications for all case updates in Slack.

  11. Review your configuration and choose Add channel. Your channel appears in the Slack configuration page.

Update your Slack channel configuration

After you configured your Slack channel, you can update them later to change the IAM role or case notification.

To update your Slack channel configuration
  1. Sign in to the Support Center Console and choose Slack configuration.

  2. Under Channels, choose the channel configuration that you want.

  3. On the channelName page, you can do the following tasks:

    • Choose Rename to update your channel configuration name. This name only appears in your Amazon Web Services account and won't appear in Slack.

    • Choose Delete to delete the channel configuration from the Amazon Web Services Support App. See Deleting a Slack channel configuration from the Amazon Web Services Support App.

    • Choose Open in Slack to open the Slack channel in your browser.

    • Choose Edit to change the IAM role or notifications.