diff --git a/.github/workflows/slack/README.md b/.github/workflows/slack/README.md index 44625aa90..c2c373c0f 100644 --- a/.github/workflows/slack/README.md +++ b/.github/workflows/slack/README.md @@ -65,6 +65,10 @@ Three main resources are created using the slack integration: - Use of bot token of the format `xoxo-` is not supported for creating user groups. - The user group should be unique across the workspace (i.e., no channel, user, or user group should have the same handle). - Please [import](#importing-existing-resources) the user groups to terraform state if they already exist in the workspace, as they **cannot be deleted** in Slack 😢. +- **You have to invite the bot to all managed channels to make it work.** + +> [!WARNING] +> **Creation of multitudes of groups leads to a lot of API calls and can lead to rate limiting. Please be cautious while creating groups, otherwise you will get `Error: couldn't get usergroups: slack rate limit exceeded, retry after 30s`**. Related issue (not fixed even thought it is closed): https://github.com/pablovarela/terraform-provider-slack/issues/64 > [!IMPORTANT] > The terraform state will overwrite any description, name, or topic change. It is better to manage the changes in the YAML files and then apply them. However, the terraform state will not affect bookmarks, pinned items, etc. diff --git a/.github/workflows/slack/groups/groups.yaml b/.github/workflows/slack/groups/groups.yaml index 35a5695ef..eeff3e129 100644 --- a/.github/workflows/slack/groups/groups.yaml +++ b/.github/workflows/slack/groups/groups.yaml @@ -22,7 +22,7 @@ - name: "Studio" handle: "studio" - description: "To notify all regular Studio contributors at once. If you don't contribute regularly but want to get notified too, please open a PR to get added." + description: "To notify all regular Studio contributors at once, please open PR to get added" users: - "U01RWDD69PZ" - "U0572R8J927"