How to Connect the Slack Widget from the Widget Marketplace

This article explains how to connect the Slack widget to your Slack channel, allowing you to display its content on your screen.

1. Visit https://api.slack.com/apps while logged in as a workspace administrator.
2. Click "Create an App" or "Create New App".
   
3. Click "From scratch".
   
4. Under "App Name," enter a name for your app, such as "Signage Messages."
5. Next, select the required workspace (usually, there will be only one).
   
   
6. Click "Create App".
7. In the left-hand menu, click "OAuth & Permissions."

8. Scroll down to the "Scopes" section and click "Add an OAuth Scope" under "Bot Token Scopes."

    

   
9. Add the following scopes
   1. channels:history
   2. channels:read
   3. files:read
   4. groups:history
   5. groups:read
   6. team:read
   7. users:read
   Repeat this process to add all the required scopes. Each scope is saved automatically as you add it.
   
   
   
   

10. In the left-hand menu, click "Install App," then click the "Install to [your workspace]" button.

    

11. You will be presented with a confirmation screen. Click "Allow."

    
12. Copy the value below "Bot User OAuth Token" and save it in a text file
    

Copy the value shown under "Bot User OAuth Token" and save it in a text file for later use.

Bot User OAuth Token

Open MagicINFO Widget Marketplace

In the Widget Marketplace, create an instance of the Slack widget. Enter the "Bot User OAuth Token" into the "Token" field.

The "Channel" property is a text field where you can enter the name of a Slack channel you previously created. Ensure the channel exists and that you have entered its name correctly.

Once the widget is created, you can copy the URL and paste it into your MagicINFO environment, then schedule it as a content item. Note that this requires MagicINFO Premium.

If the channel you want to display messages from is private (indicated by a lock symbol), you’ll need to add the app to that channel. Doing this from within the Slack app may not show your newly created app due to caching issues, so it's easier to add it via a browser.

1. Open your workspace in the browser: https://yourworkspace.slack.com/
2. Navigate to the channel where you want to add the app.
3. Click the channel details button below the search field, then click the arrow next to the channel name to expand the menu.
4. Click the "Integrations" tab.
5. In the Apps section, click "Add apps."
6. Search for your newly created app (e.g., "Signage Messages").
7. Click the "Add" button next to the app name.

Once added, the channel will immediately display a message notifying other users that the app has been added. The channel overview will also show the connected app.