In this article
...
Use this Snap to perform the following Channel operations in your Slack Workspaceworkspace:
- Archive Channelchannel
- Create Channelchannel
- Invite Useruser
- List Membersmembers
- Remove Useruser
- Rename Channelchannel
- Retrieve Channel Infochannel info
- Unarchive Channelchannel
Prerequisites
A valid and active account in the Slack Workspaceworkspace.
Slack Scopes required
Any action you want to perform within a Slack Workspaceworkspace, additionally needs appropriate Scopes assigned to your app. See the Scope and Permissions article in Slack API documentation for the complete list and each Account page under Configuring Slack Accounts (Doc in Progress) for information on defining Scopes for your app.
To | Bot Token Accounts | User Token Accounts ( user_scope ) |
---|---|---|
| Channelschannels:manage
|
|
| Channelschannels:read | Channelschannels:read |
Unarchive Channelchannel | N/A |
|
Support for Ultra Pipelines
...
Input/Output | Type of View | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| A document containing details required for a specific Channel the selected channel operation. |
Output | Document |
|
| A document containing the result (success/failure) of performing the selected Channel channel operation. |
Snap Settings
Parameter Name | Data Type | Description | Default Value | Example | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Label | String |
| Channel Operations | Channel Operations | ||||||||
Operation | Drop-down list | Select an operation from the following list of permitted Channel channel operations . The number and list of fields required for the operation are displayed after you select an operation to perform.and specify the corresponding details needed:
| List Members | Invite User | ||||||||
Channel | String/Expression/Suggestion | Conditional: Required for all Channel channel operations except Create Channel. Select a Channel channel from the list of suggested Channels channels to perform the selected Channel channel operation on. Alternatively, you can enter the Channel channel name and/or Channel channel ID in one of the following formats.
| N/A | #testprivate:G019B3ETYMB | ||||||||
User/Users | String/Expression/Suggestion | Conditional: Required for Channel operations channel operation - Invite User, Remove User. Select a user from the suggested values which are typically the list of users available in the Workspaceworkspace. Alternatively, you can enter one or more usernames and/or user IDs, separated by commas, in one of the following formats.:
The specified set of users are invited to join or removed from the selected Channel accordinglychannel. | N/A@user.name:W01A94P7MK1 | @user.name:W01A94P7MK1 | ||||||||
User | String/Expression/Suggestion | Required for channel operation - Remove User. Select a user from the suggested values which are typically the list of users available in the workspace. Alternatively, you can enter one or more usernames and/or user IDs, separated by commas, in one of the following formats:
The specified user is removed from the selected channel. | ||||||||||
Name | String/Expression | Conditional: Required for Channelchannel operation - Create Channel. Enter a name for the new Channelchannel. | N/A | Support_Vertical | ||||||||
New Name | String/Expression/Suggestion | Conditional: Required for Channelchannel operation - Rename Channel. Enter the new name for the Channelchannel. | N/A | ReleaseTeam_Channel | ||||||||
Snap Execution | Drop-down list | Select one of the three following modes in which the Snap executes:
| Execute only | Validate & Execute |
Troubleshooting
Error | Reason | Resolution | |||
---|---|---|---|---|---|
Failure: Unable to rename the given Channelchannel. Reason: invalid_name_specials | You have provided an invalid name for renaming the channel. | Ensure that the token and the inputs are valid, and try again; contact support team if the problem persists. | Failure: name provided for the channel is valid (does not contain invalid special characters). | ||
Unable to kick user from Channel.Channelchannel. Reason: Channel_not_found | You have specified an invalid channel to remove the user. | Ensure the token and the inputs are valid, and try again; contact support team if the problem persists. | Failure: Unable to archive Channel. | Channelthat the user to be removed currently exists in the channel members list. | |
Unable to archive channel. Reason: Channel_not_found | You have specified an invalid channel to archive. | Ensure that the token and the inputs are valid, and try again; contact support team if the problem persists.Failure: channel exists in the workspace and is not archived already. | |||
Unable to unarchive Channel.Channelchannel. Reason: Channel_not_found | You have specified an invalid channel to unarchive. | Ensure that the token and the inputs are valid, and try again; contact support team if the problem persists. | Failure: Input error. | No Channel provided | Supply an existing Channel, and proceedchannel exists in the workspace and is archived already. |
Input error. Reason: No Channel provided | You have not specified a channel to perform the selected channel operation. | Ensure that you provide a channel in the Channel field and that it exists in this workspace. |
Examples
<Example under revision>
...