Slack

When you connect a Slack workspace to Oblique, Oblique will automatically sync the workspace, its members, its channels, and its user groups. The same integration is also used to send request notifications to Slack.

As you add people to Slack, change their role, or add them to or remove them from channels, these changes are automatically synced to Oblique.

You can add multiple Slack workspaces to Oblique. Each is a separate integration, identified by its workspace name.

Supported options

Oblique syncs the following from your Slack workspace.

Slack object	Oblique object	Capability
Members	Accounts	Read-only
Workspace	Resources	Read-only
Channels	Resources	Read-only
User groups	Resources	Read-only
Roles	Roles	Read-only
Workspace membership	Entitlements	Read-only
Channel membership	Entitlements	Read-only
User group membership	Entitlements	Read-only

Accounts

Oblique syncs each Slack member, including guests, as an Oblique account. Deactivated members, members who haven’t accepted their invitation, and bots and apps, including Slackbot, aren’t synced.

Slack accounts are matched to Oblique users by their email (profile.email).

Account matching

Caution

If Slack accounts are missing, Oblique may not have the scopes it needs. Reading emails requires the users:read.email scope, shown as View email addresses of people in your workspace. Change the integration’s authorizations to add it.

Resources

Oblique’s Slack integration is read-only. Oblique can’t make changes to your Slack workspace, its members, channels, and user groups, or their roles.

Oblique syncs the following from Slack as resources:

• The Slack workspace you connected
• Each public channel in the workspace
• Each private channel in the workspace that the Oblique app has been added to
• Each user group in the workspace

User groups may only be available on certain Slack pricing plans.

Every account has an entitlement for the workspace.

Archived channels, direct messages, group direct messages, and disabled user groups aren’t synced.

Caution

Oblique only sees the private channels that the Oblique app has explicitly been added to. To sync a private channel, invite @Oblique to the channel in Slack.

Roles

Oblique syncs Slack roles as Oblique roles.

Every entitlement for the workspace is for exactly one role. Membership in a channel or user group has no role. Channel managers aren’t synced.

Required permissions

The Oblique Slack app requests the following permissions for your Slack workspace:

• View the name, email domain, and icon for the workspace
• View people in your workspace
• View email addresses of people in your workspace
• View basic information about public channels in your workspace
• View basic information about private channels that @Oblique has been added to
• View user groups in your workspace
• Join public channels in your workspace
• Send messages as @Oblique
• View URLs in messages
• Preview links in messages

Request link previews

When someone posts a link to an Oblique request in Slack, Oblique adds a preview card under the message showing the request and its status. The card updates whenever the request changes. If approvals from Slack are enabled, the card of an open request includes Approve and Close buttons.

The card is visible to everyone in the conversation. Oblique only adds it when the person who posted the link is an Oblique user who can view the request.

Workspaces connected before link previews were available need to be reconnected to grant the permissions to view and preview links.

Add Slack integration

You must be an admin to add an integration.

If you aren’t a member of the Slack workspace, create an install link and send it to someone who is. An install link lets someone who isn’t an Oblique admin connect an integration. They then become an owner of the integration.

You connect a Slack workspace to Oblique by installing the Oblique app in the workspace and approving the access Oblique asks for.

To add a Slack integration, navigate to the Integrations page:

1. Select Add integration.
2. Select Slack.
3. Select Connect Slack.
4. Select the Slack workspace to connect, review the access Oblique asks for, and select Allow.

Oblique will immediately start syncing the workspace’s members, channels, and user groups.

Note

The Oblique Slack app isn’t currently available via the Slack Marketplace. You will need to manually install it from Oblique. Because it isn’t in the Slack Marketplace, you also cannot install it at the organization level, like in Slack Enterprise Grid, and will need to install it for each workspace. The Oblique Slack app will have either the app ID A09EG3AJEHZ (US) or A0A5AA3PHC0 (Europe), depending on the Oblique region you are using.

Approve the Oblique app in your Slack workspace

By default, any Slack member can add an app to a workspace.

If your Slack workspace or organization has configured app approval to restrict installing Slack apps that aren’t approved, then your Slack workspace owner will need to approve the Oblique app for workspace members to use it. You can’t pre-approve the Oblique app since it’s not available in Slack Marketplace.

If you have already installed the Oblique app in your Slack workspace, approve it for all workspace members:

1. Find the app in your list of installed apps, at https://app.slack.com/apps-manage/$workspace-id/integrations/installed and select the app. Alternatively, navigate directly to the Oblique Slack app at https://$workspace-name.slack.com/marketplace/A09EG3AJEHZ-oblique (US) or https://$workspace-name.slack.com/marketplace/A0A5AA3PHC0-oblique (Europe).
2. On the app listing, find the desired workspace. Next to Manage app for entire workspace?, select Approve.

If you have app requests enabled, and a workspace member has requested the app, then:

1. Find the app in your list of app requests, at https://app.slack.com/apps-manage/$workspace-id/integrations/requests and select the app. Alternatively, navigate directly to the Oblique Slack app at https://$workspace-name.slack.com/marketplace/A09EG3AJEHZ-oblique (US) or https://$workspace-name.slack.com/marketplace/A0A5AA3PHC0-oblique (Europe).
2. On the app listing, find the desired workspace. Next to Manage app for entire workspace?, select Approve.

Once the app is approved, it will be listed in your list of installed apps, at https://app.slack.com/apps-manage/$workspace-id/integrations/installed, with the App resolution Approved. The app listing, at https://$workspace-name.slack.com/marketplace/A09EG3AJEHZ-oblique (US) or https://$workspace-name.slack.com/marketplace/A0A5AA3PHC0-oblique (Europe), will also show as approved for your workspace.

Change Slack integration’s authorizations

You must be an admin to change an integration’s authorizations.

To reconnect the Slack integration, for example, to change the member it’s tied to or to grant permissions Oblique has added since it was connected, go to the integration’s detail page:

1. Navigate to the Settings tab.
2. Under Connection, select Reconnect.
3. Review the access Oblique asks for and select Allow.

You can only reconnect the current workspace. To change the workspace, instead delete the integration and add another one.

Manage entitlements

Oblique’s Slack integration is read-only, so it can’t be used to manage your Slack workspace, its members, channels, and user groups, or their roles. Make these changes in Slack directly, and Oblique will sync them automatically.

Remove Slack integration

You must be an admin to remove an integration.

To remove a Slack integration, from the integration’s detail page:

1. Navigate to the Settings tab.
2. At the bottom of the page, under Delete integration, select Delete integration….
3. In the confirmation dialog, type the text to confirm, then select Delete integration.

This will immediately stop all syncing, remove all resources from the integration, and stop sending notifications to Slack.

Caution

Removing the integration doesn’t revoke Oblique’s access to Slack. To revoke it, remove the Oblique app from the Slack workspace.

Troubleshooting

If you get the error Apologies, but Oblique can't be installed, your Slack workspace or organization has configured app approval to restrict installing Slack apps that aren’t approved or aren’t in the Slack Marketplace. See Approve the Oblique app in your Slack workspace.