Slack Integration

Key Features

  • Forward ovice @mention chats to Slack
    When you receive a direct message in ovice, it will also be sent to your direct messages in Slack.
    Note: This applies only to one-on-one direct messages. Group mentions (like @all or @here) and messages to multiple recipients are not forwarded.
  • Sync your Slack status to ovice
    Display your current Slack status directly in your ovice space.

 

Required Permissions

Setup for the Organization Organization Owners or groups assigned a Permission Groups.
Linking Individual Accounts Admins or Members of a space within the organization.
Viewing Slack Statuses Admins or Members of a space within the organization.

 

Setup by an Organization Owner

Before You Begin

Make sure you have the following permissions:

  • Slack Admin permissions
  • ovice Organization Owner permissions

 

Slack Configuration

1. Go to https://api.slack.com/apps.

2. Click Create New App.

The 'Create an app' page on api.slack.com.

3. Click From scratch.

4. Enter a name for your app in the App name field.

Note: Only alphanumeric characters are allowed. Japanese characters cannot be used.

5. Under Pick a workspace to develop your app in:, select your Slack workspace.

6. Click Create App.

7. From the menu on the left, click OAuth & Permissions.

Screenshot showing the 'OAuth & Permissions' option in the Slack app settings menu.

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

The 'Add an OAuth Scope' button under Bot Token Scopes in Slack settings.

9. Add the following OAuth Scopes:

  • users:read
  • users:read.email
  • chat:write

Screenshot showing the required OAuth scopes: users:read, users:read.email, and chat:write.

10. Scroll back up to the OAuth Tokens for Your Workspace section and click Install to Workspace.

The 'Install to Workspace' button in Slack's OAuth & Permissions settings.

11. When prompted to grant the app permission to access your Slack workspace, click Allow.

The Slack permission request screen, with the 'Allow' button highlighted.

12. Copy the generated Bot User OAuth Token.

A generated Bot User OAuth Token with a copy button.

 

ovice Configuration

1. Click the hamburger menu icon in the top-left corner and select the Organization tab.

The 'Organization' tab in the ovice main menu.

2. Go to Organization SettingsIntegrations → and click the External Services tab.

3. Click the Slack app.

The Slack app icon in the ovice Integrations settings.

4. Fill in the required fields and click Save.

Bot User OAuth Token Enter the token you copied during the Slack Settings step.
Slack Workspace For "your-workspace.slack.com", enter only the "your-workspace" part.


The ovice settings page for configuring the Slack integration, with fields for the OAuth token and workspace name.

This will add the Slack integration option to the personal Integrations settings for all members in your organization's spaces. This option is only visible to space admins and members.

 

Linking Your Account

1. Go to your personal Integrations settings.

2. Click Connect for Slack.

3. In the new window, select your Slack workspace from the dropdown menu in the top-right corner.

The Slack authorization screen, showing the workspace selection dropdown and the 'Allow' button.

4. Review the permission request and click Allow.

  • The integration will connect successfully if a Slack account exists with the same email address as your ovice account.
  • Once you connect your account in one space, the integration will automatically be active in all other spaces within your organization.

 

Using the Slack Integration

Forwarding ovice @mention chats to Slack

Sender's Slack Integration Status How it Appears in Slack
If the sender has also connected their Slack account The message will appear in your DM conversation with the sender.
If the sender has not connected their Slack account
(or if they are a guest or visitor)
You'll receive a direct message from the app you created (e.g., Slackbot or your custom app name).

 

Syncing your Slack status to ovice

Users who have linked their accounts will have their Slack status displayed on  My Seat. You can also hover over another connected user's desk to see their status and send them an @mention chat from the pop-up menu.

Slack Status Example in ovice

A calendar emoji in Slack.

Slack status text: 'In a meeting'.

An ovice user's desk showing their synced Slack status: 'In a meeting'.

A 'zzz' emoji in Slack.

Slack status text: 'Out of office'.

*Do Not Disturb mode

An ovice user's desk showing their synced Slack status: 'Out of office' with a Do Not Disturb icon.

A sick face emoji in Slack.

Slack status text: 'Out sick'.

An ovice user's desk showing their synced Slack status: 'Out sick'.

A palm tree emoji in Slack.

Slack status text: 'Vacationing'.

*Do Not Disturb mode

An ovice user's desk showing their synced Slack status: 'Vacationing' with a Do Not Disturb icon.


You can also see Slack statuses in these other areas of the ovice interface:

Quick Action Menu

Slack status shown in the Quick Action Menu.

Avatar Pop-up

Slack status shown in the pop-up when hovering over a user's avatar.

Profile

Slack status shown on a user's profile page.

User List

uselist status us.png

 

Disconnecting the Integration

1. Go to your personal Integrations settings.

2. Click the Connected button for Slack to disconnect.

 

Tips

  • If you set up the Slack integration before June 25, 2025, only the feature to forward ovice direct messages to Slack is available. To use all features, including status sync, you must disconnect and reconnect the integration.
  • When a Member or Admin sends a direct message to a user who has the Slack integration enabled, a notice saying "This message will also be sent to Slack" will appear in the chat box. This notice appears even if the sender has not connected their own account. (Remember, only one-on-one direct messages are sent to Slack; messages to multiple recipients are not forwarded.)

Screenshot of the ovice chat box showing the notification: 'This message will also be sent to Slack.'

Was this article helpful?
0 out of 0 found this helpful

Articles in this section