The Slack integration widget provides a portal into your slack channels which you can view and contribute to through your digital workplace.
Sections in this article:
Limitations
Slack limits the number of API calls that can be made per second from a single source. Including multiple slack widgets on a single page, or having multiple tabs open containing slack widgets may exceed this limit and cause the widgets to stop working. For more information, see Slack's rate limits.
Set up
- Place an
Integrations widget on a page, space, or dashboard. For more information, see Placing and setting up a widget.
- Select the placed widget's Edit button.
- Under Integration Library, select Igloo Integration Library.
- Select
Slack from the library.
- Review and make changes to the settings on the Options and Appearance tabs. You can find details about the widget's settings in the Settings section below.
- In the widget editor, select Update to apply your changes.
- At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.
Approving the Igloo App
The Igloo App is not listed in the Slack App Directory. Depending on the Slack Team's permissions, the Team Owner may need to approve the Igloo App before it can connect to the Slack Team. Signing into the Slack Integration before it has been approved results in the following message:
To approve the Igloo App, the Team Owner or a member who has permission to add Apps, must sign into Slack using the Integration. When signing in they will receive the following Authorization request:
Select Authorize to approve the app.
Refer to Slack's article, Manage apps for your workspace, if you encounter issues with authorizing the app.
Settings
| Setting | Descriptions |
|---|---|
| Title |
Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections. When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select This field can contain a maximum of 140 characters. |
| Title link |
Enter the URL of a location in your digital workplace. Users who click the widget's title, if it has one, will go to this location. Whether you enter the link as a relative URL or an absolute URL does not matter, it will convert to an absolute URL the next time you edit the widget. This field can contain a maximum of 2,083 characters. |
| Description |
Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget. When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select |
| Setting | Description |
|---|---|
| Channel Name | Enter the name of the channel that you would like to be displayed by default through the widget. |
| Team ID | Enter a Team ID which will be used when connecting to Slack. If left blank, users will be prompted for the ID when connecting through the widget for the first time. |
| Enable Channel Change | Select whether users can change channels. |
| Number of previous messages to show | Enter how many recent messages will be shown from the channel history. |
Appearance tab
| Setting | Description |
|---|---|
| Class |
Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets. |
| Height |
Select the height of the widget. The default value is Auto (leftmost slider position) scales the widget's height to fit its contents. You can use the slider to set a fixed height between 50px to 600px in increments of 50px. Selecting a height less than what is needed to display its contents results in the widget having a vertical scrollbar. |
Note
Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.
Using it
View
You can see what is posted in your Slack channels through the integration. The feed shows posts and updates automatically when new entries are made from either the widget or other Slack interfaces. Scrolling through previous messages will automatically load additional messages if they exist.
Post messages
You can add new messages that include #hashtags, @mentions, and emojis. For more information about formatting your messages, see Slack's article about formatting your messages.
Upload files
You can upload files from your computer into slack. These follow the same restrictions as normal file restrictions in Slack. When uploading a file you can include a title and comment that will be published at the same time as the file upload.
Change Channel
If enabled, select which of your existing Slack channels to display in the feed. Use the search option to quickly locate channels in addition to scrolling through the channel list.
Threaded Replies
You can create a reply thread by clicking the speech bubble icon located on a message. Messages with existing threads will contain a View Thread link that can be clicked to view the existing threaded replies.