Installation in Slack
Required Roles for Slack Installation
The required roles for the Slack installation are:
- Slack (Enterprise Grid) Admin: A user with administrative privileges who can manage app installations, approve app requests, and configure app settings across the Slack Enterprise Grid organization. This role is essential for overseeing the Skill Assistant integration and ensuring proper deployment.
- Customer Contact with TechWolf: A designated representative who coordinates with TechWolf’s team to facilitate the integration process, provide necessary information, and ensure successful implementation of the Skill Assistant in your Slack environment.
Required Slack App Permissions
The required permissions for the Slack app are:
| OAuth Scope | Description | Request Reason |
|---|---|---|
| chat:write | Send messages as Skill Assistant | The app needs to be able to send messages containing suggestions, reminders and other content to the users of the app. |
| im:history | View messages and other content in direct messages that Skill Assistant has been added to | The app needs to be able to view messages users send to the app to be able to answer those messages. |
| im:write | Start direct messages with people | The app needs to be able to start sending messages directly to users, to for example send them skill suggestions. |
| users:read | View people in a workspace | The app needs to be able to get all the users from the workspace to be able to send suggestions to them. |
Installation steps
The installation consists of several steps, which are described in detail below. TechWolf needs to configure the Skill Assistant to work with your Slack environment and you need to install the app in your Slack environment.
Share your Enterprise or Workspace ID with TechWolf.
If you are using a Slack Enterprise Grid, you need to share your Enterprise ID with TechWolf. If you only have a single Slack Workspace, you need to share your Workspace ID with TechWolf.
Link Slack users to TechWolf Employees
We need a method to link Employees in the TechWolf API to Slack Users. See Linking users and TechWolf Employees .
Install in Skill Assistant application in Slack
Install the Skill Assistant in your Slack environment by following these steps
Enable the Skill Assistant for your workspaces
This step is only required if you are using a Slack Enterprise Grid.
Enable the Skill Assistant for your workspaces by following these steps
Linking Slack users and TechWolf Employees
In order for TechWolf’s Skill Assistant to deliver personalized and timely skill suggestions via Slack, it is crucial that we can accurately link each employee in your organization to their corresponding Slack user.
This can be done by setting a
Custom Property
on the Employee in TechWolf. The Skill Assistant will then use this Custom
Property to link the Employee to the user in the messaging platform. The Slack
ID should be stored in the Custom Property with the key employee_slack_id. The
mapping between the employee ID known in TechWolf’s SkillEngine and their
corresponding custom property should be sent to TechWolf via a datasource
integration so that we can store it accordingly.
Install the Skill Assistant in Slack
To install the Skill Assistant in Slack, you need to install the app in your Slack environment. Follow the following steps:
If your data should be stored in the US region, you need to install the app in the US region. Otherwise, you need to install the app in the EU region.
Click here to install the Skill Assistant in the US region
Click here to install the Skill Assistant in the EU region
Allow the app
Allow the app to access your Slack environment.
The Skill Assistant app is currently not available in the Slack Marketplace. Slack will display a warning that shows this.
Succesful installation
If the installation is successful, you will see the following message.
Using Enterprise Grid
Using a single workspace
Enable the Skill Assistant for your workspaces
This step is only required if you are using a Slack Enterprise Grid.
If you are using a Slack Enterprise Grid, you need to enable the Skill Assistant for your workspaces. Follow the following steps:
Add the app to your workspaces
If the installation was successful, you will see a button named “Add the app to your workspaces”. This will bring you to the page where you can add the app to your workspaces.
Add the app to your workspaces
At the right top corner of the page, you will see a dropdown named “Manage”. Click it and select “Add to more workspaces”.
Select the workspaces
Select the workspaces you want to add the app to and click on “Next”.
Review the permissions
Review the permissions and click on “Next”.
Add to the workspaces
Select the checkbox “I’m ready to add this app” and click the button “Add App”.