Slack White Labeled app
As a reseller, you can add your own Slack app for integration. Integrating your Slack app will provide the following features:
- import the members of a workspace as targets in a new group named after the workspace and
- members of the workspace can receive Slack notifications as well as email notifications of new enrollments.
Use the links below to learn more about creating and integrating your Slack app
- Creating your Slack app to install in one Slack workspace
- Integrating your slack app in the integration store
- Syncing your workspace members to targets
- Changing Client ID and Client Secret
- Expanding your Slack App to install it to more than one workspace
- Submitting your app to the Slack App Directory
At a minimum, you will be making a slack app that will contain a bot user with these permissions:
- users:read, and
Also, your redirect URL for the Slack app will use your domain.
*NOTE: You will need permissions to install Slack apps to your desired workspace for the integration to succeed.
Once your Slack app is created, you can integrate it in the integration store. After you have installed your Slack app in a workspace, tested your changes, and saved your settings, you will be able to install your Slack app into other workspaces provided that your Slack app is configured to do so.
Creating your Slack app to install in one Slack workspace
- Copy the following App Manifest JSON into a text editor like Notepad or TextEdit
"name": " My Enrollment Notifier ",
"description": "You will be notified of a new enrollment.",
"long_description": "My Enrollment Notifier will let any member of your workspace know when they have been enrolled into a course with a message directly to them in your Slack workspace. You can install Enroll Notifier into as many of your workspaces that you need to make for sure that your members receive notifications of their enrollments."
"display_name": "My Enrollment Notifier",
- Substitute “<your-domain-here>” in oauth_conifg.redirect_urls with the domain that you use. Note: Once we complete this section of the documentation, it will be easier to modify the other fields for your app.
- Navigate to slack.com/apps.
- Click the “Create New App” button.
- Choose the “From an app manifest” option.
- Next, you will choose where you will develop your app. This should be a workspace that you have permission to install apps to. If you want to install your Slack app into a single workspace, you will choose that workspace here.
- After clicking Next in the previous step, choose JSON as your format. Then, copy and paste your modified App Manifest JSON.
- The last section is a summary of the app that you are about to create. Click “Create” to continue.
- At this point, your Slack app is ready to be installed through portal into the workspace that you chose in step 6.
Integrating your Slack app in the integration store
After you install your Slack app into your first workspace, you will be able to install your Slack app into other workspaces if your app is setup to do so. We will cover how to setup your app to be installed in other workspaces in the Expanding your Slack App to install it to more than one workspace section. For now, let’s install your app into a workspace through portal.
- Enter the integration store (Administration > Integration Store).
- Click Setup to get started.
- Add your Client ID and Client Secret from your Slack app into their corresponding fields. The Client ID and Client Secret can be found in the Basic Information section for your Slack app at https://api.slack.com/apps/<your-app-id>.
- Next, click the “Add to Slack” button. In this screen, you will allow permissions for your app to install into the workspace.
- If all goes well, you will get a message that the integration was successful.
- Activate the integration by clicking the “Active” toggle.
- You will need to save your settings by clicking “Test” then “Save”.
- At this point, your Slack app is installed into the workspace and the users in that work space can receive Slack notifications for new enrollments.
- If your app is ready to be installed to other workspaces, you can now use the “Add to Slack” button to install your Slack app to more workspaces.
Syncing your workspace members to targets
- In the Integration Store, click the Edit button for the Slack – Enrollment Notifier.
- If you want to sync all of your workspaces into their groups, click the Sync All Groups slider to “Yes”.
- If you want to sync only some of your workspaces into their groups, click the Sync All Groups slider to “No”. This will bring up a menu for you to choose which groups that you would like to sync.
- When you are finished, click the Test button to test your new settings.
- Click Save to save your settings.
Changing Client ID and Client Secret
You can integrate one Slack app per account. If you need to change what app sends out the Slack notifications, you can do the following:
- Uninstall all integrated workspaces by choosing “Uninstall” in the Actions column in the Edit Configuration modal for the Slack app in the integration store.
- Change both the Client ID and Client Secret to the new Client ID and Client Secret.
- Click the “Add to Slack” button and allow permissions to install it into a workspace.
- Click “Test” then “Save” to save your new settings.
- At this point, you can install your app into other workspaces if your Slack app is set to be publicly distributed.
Expanding your Slack App to install it to more than one workspace
If you would like to install your Slack app into more than one workspace, you will need to “Activate Public Distribution” for your app. Slack has certain requirements that you must first meet before you can publicly distribute your app. Those requirements are below:
- Install your app to the workspace that you are developing in.
- See the Integrating your Slack app in the integration store section for how to install your Slack app into your workspace.
- Verify that all hard coded information is removed.
- You can do this in your Slack app settings in slack.com/apps for your app. This is under the “Manage Distribution” section.
After verifying the things above, you will go to the “Manage Distribution” section of your app and click the “Activate Public Distribution” button. Now, you can install your Slack app into more than one workspace.
During the install process noted in the Integrating your Slack app in the integration store section, you will choose a workspace in step 4:
Submitting your app to the Slack App Directory
If you want your Slack app to be available on the Slack app directory, you will need to adhere to Slack’s requirements for submitting your app to the Slack app directory. You will, also, need to do the following:
- Complete the Expanding your Slack App to install it to more than one workspace section above to activate your app for public distribution.
- Fill out all the information needed in the “Basic Information” section of your Slack app.
- In the “Basic Information” page, set your app to “Install from your landing page” in the “Installing Your App” section.
- Your landing page url will have information on how to install the Slack app along with how to sign up for your services. A clear path to how to get to the “Add to Slack” button will need to be described.
- On your landing page, you can link to the integration store with a link with a URL like this “https://your-domain/integration_store.php”. Clicking the link will require the user to log in but will direct them to the integration store after they are authenticated which will lead the user to the “Add to Slack” button.