Setting up Manage Slack Connection is a coordinated activity between the Salesforce admin and the Slack workspace admin. The four-step process covers: install the Salesforce app into Slack with the right OAuth scopes, authorize the connection from the Salesforce side, configure user identity mapping, and enable the specific Salesforce-Slack features the org wants. After that, ongoing operation is monitoring the connection health and re-authorizing when tokens expire. Each step is short on its own, but skipping any of them leaves a half-working integration that confuses users.
- Install the Salesforce app into the Slack workspace
Have the Slack workspace admin install the Salesforce app from the Slack App Directory. The install prompts for OAuth scope approval; grant the scopes the Salesforce documentation lists (channels:read, chat:write, users:read, files:read, and others). After install, the Slack admin sees the Salesforce app in the workspace app list. Configure the app allowed channels and user audience per Slack workspace policy. Capture the workspace name and the Slack app Client ID; the Salesforce side needs both to authorize the connection.
- Authorize the connection from Manage Slack Connection
In Salesforce, open Setup, search Manage Slack Connection. Click Connect to Slack. Enter the Slack workspace name and follow the OAuth flow to authorize the connection. The Salesforce platform stores the resulting refresh token in the Connected App configuration. After the OAuth flow completes, the Manage Slack Connection page shows the workspace as Connected with a green status indicator. Test the connection with the Test Connection button; a successful test sends a smoke-test message to a test channel. Document the connection details (workspace name, connection date, granted scopes) in the integration runbook.
- Configure user identity mapping
On the Manage Slack Connection page, navigate to User Mapping. Choose between Email Matching and SSO Mapping. For Email Matching, confirm that the Salesforce User Email field matches the Slack User Email; users with mismatched emails cannot use the integration until the mapping is fixed. For SSO Mapping, confirm both Salesforce and Slack are connected to the same SAML or OIDC identity provider. Run a User Mapping Audit Report to identify any users whose Slack identity cannot be determined; resolve each before declaring the integration ready for general use.
- Enable features and roll out to user groups
On the Manage Slack Connection page, enable the specific features the org wants (Sales Notifications, Account Plans, Service Cloud for Slack, etc.). Each feature has its own configuration sub-page; complete the configuration for each enabled feature. Roll out features in waves: a pilot user group for two weeks, expand to 25 percent of users for one week, then 50 percent, then full population. Capture user feedback at each wave and adjust the configuration as needed. Document the rollout schedule and the feature-by-feature ownership in the integration runbook so future admins inherit a clear picture.
- OAuth tokens do not auto-rotate. If the Slack workspace admin revokes the app or rotates the secret, every Salesforce-Slack feature fails until re-authorization. Monitor the connection health email alerts.
- Email Matching mapping breaks the moment a user email changes (marriage, name change, departmental email rebrand). SSO Mapping is more resilient; pick it during initial setup if SSO is available.
- Disabling the Salesforce app in Slack does not auto-update the Manage Slack Connection status to Error immediately. The first user impact may surface before the dashboard does; build proactive monitoring.
- Feature toggles are org-wide. Enabling Sales Notifications affects every user in the org, not just the pilot group. Use per-feature permission sets or profile permissions to limit the audience before enabling.
- Slack scope changes (new feature requires a new scope) require re-authorization, not just an update. Plan for re-auth during quarterly Salesforce releases when new Slack features ship.