Guided Slack Setup
Guided Slack Setup is the Salesforce wizard-style configuration tool that walks admins through the end-to-end installation and connection of the Salesforce-Slack integration.
Definition
Guided Slack Setup is the Salesforce wizard-style configuration tool that walks admins through the end-to-end installation and connection of the Salesforce-Slack integration. Instead of navigating multiple Setup pages and coordinating with Slack admins manually, Guided Slack Setup presents a step-by-step flow: install apps in Slack, connect the workspace to Salesforce, map users, configure channels for records, validate the integration health. It is the on-ramp for new Slack-Salesforce deployments and the most reliable way to avoid the half-configured pitfalls that plague manual installations.
The guide lives under Setup, Quick Find, Guided Slack Setup. Each step has clear prerequisites, validation checks, and rollback paths if something fails. Most steps require coordination with the Slack workspace admin; the guide handles the handoff with deep links into Slack and explicit instructions for what the Slack admin needs to do. For greenfield orgs adding Slack integration, this is the recommended starting point. For orgs that already have a partial integration, the guide is still useful as a verification tool to catch missing pieces.
How Guided Slack Setup orchestrates the Salesforce-Slack integration end-to-end
The step-by-step flow
Guided Slack Setup presents a sequenced workflow: confirm Salesforce-side prerequisites, install Slack apps in the target Slack workspace, authenticate the connection, map Salesforce users to Slack users, enable per-object channel-for-records features, run the integration health check. Each step has explicit pass/fail criteria; later steps unlock only when earlier steps succeed. The sequencing prevents the common pattern of half-configured integrations that work for some users and not others.
Coordination handoffs with the Slack admin
Several steps require the Slack workspace admin to act inside Slack (install apps, grant OAuth scopes, configure workspace settings). Guided Slack Setup generates deep links into Slack admin pages and explicit task lists for the Slack admin to execute. The Salesforce admin sends the task list and links to the Slack admin; once done, the next step in the guide unlocks. This handoff pattern is the single biggest UX improvement over manual setup, where admins from both platforms have to coordinate via Slack-message back-and-forth.
User mapping in the guide
The user-mapping step inside Guided Slack Setup runs the auto-match-by-email job and surfaces unmapped users with a manual-resolution UI. Admins can map remaining users one at a time, bulk via CSV, or skip and resolve later. The guide flags unmapped users as a health-check warning rather than blocking progress; deployments can proceed with partial mapping and complete the mapping after rollout. Most orgs hit 90% auto-match on first run.
Validation checks at each step
Every step has built-in validation. The Slack-side install step verifies that the app is present in the workspace; the authentication step verifies the OAuth tokens work; the user-mapping step counts mapped vs unmapped users; the channel-for-records step creates a test channel and verifies bi-directional sync. Failed validations show specific error messages with remediation links. The validation layer is what makes the guide useful as a diagnostic tool, not just an onboarding flow.
Rollback and recovery
Each step is reversible. If channel-for-records configuration produces unintended channel sprawl, the guide includes a rollback option that disables the feature without breaking the underlying integration. If user mapping causes wrong mappings, the rollback re-runs the auto-match. Rollback is by-step, not all-or-nothing; you can rewind only the steps that need fixing. This makes the guide safe to use in production orgs where partial-state rollback matters.
When to use the guide versus manual setup
Use Guided Slack Setup for greenfield Slack integrations, for orgs adding new Slack apps to an existing integration, and for any team that has not done a Slack-Salesforce setup before. Skip the guide and use direct Slack Apps Setup configuration when you are an experienced Slack-Salesforce admin doing a routine change (rotating credentials, adjusting one channel configuration). The guide is overhead for experienced admins on small changes; it is essential for everyone else.
How Guided Slack Setup relates to Slack Apps Setup
Slack Apps Setup is the ongoing-operations dashboard; Guided Slack Setup is the initial-rollout wizard. Both pages exist in Salesforce Setup. The guide writes to the same underlying configuration that Slack Apps Setup exposes. After the guide completes, admins manage day-to-day operations from Slack Apps Setup; they do not return to the guide unless adding new Slack apps or starting fresh.
Running through Guided Slack Setup for a new deployment
The guide is sequential. Allocate two to four hours of focused admin time and coordinate with the Slack admin in advance; some steps require Slack-side actions that cannot be performed from Salesforce alone.
- Open Guided Slack Setup
Setup, Quick Find, Guided Slack Setup. The guide opens at step 1. Read the prerequisite list; confirm the Salesforce edition supports Slack integration and a Slack admin is available for the handoff steps.
- Coordinate the Slack-side install
Send the auto-generated Slack-admin task list (deep links plus written steps) to the Slack admin. They install the apps and grant OAuth scopes. Verify completion in the guide''s validation step before proceeding.
- Authenticate the connection
Click Connect inside Guided Slack Setup. Authenticate via OAuth using a Slack admin user. The guide stores the tokens and validates bi-directional connectivity.
- Run user mapping
The guide runs auto-match by email. Review unmapped users; resolve manually or bulk-import via CSV. Most orgs hit 90% auto-match. The guide flags remaining gaps as warnings, not blockers.
- Configure features and run health check
Enable Slack Channels for Records per object as needed. Configure any Sales Elevate or Service Cloud features. Run the integration health check; resolve any failures before declaring the deployment done.
Strictly sequential; later steps unlock only when earlier ones pass validation. Skipping is not supported.
Auto-match by email, manual mapping for edge cases, bulk CSV import. Most orgs use a combination across the rollout.
Enable per-object Slack Channels for Records, Sales Elevate features, Service Cloud features, Agentforce in Slack per the deployment plan.
Per-step rollback. Reverse only the steps that need fixing; the rest of the integration stays intact.
- Several steps require Slack-side actions. Coordinate with the Slack admin team in advance; without their availability the guide stalls.
- Auto-match-by-email user mapping fails when Salesforce and Slack accounts use different email domains. Bulk CSV import handles these edge cases.
- Feature configuration in the guide is a starting set. Full per-object channel-for-records rules need detailed configuration in Slack Apps Setup after the guide completes.
- The guide is for initial rollout, not ongoing operations. Day-to-day changes happen in Slack Apps Setup; revisiting the guide for routine changes is overhead.
- Permission sets are not configured by the guide. Assign permission sets to users separately after the guide completes; otherwise users cannot use the features the guide enabled.
Trust & references
Cross-checked against the following references.
- Guided Slack Setup OverviewSalesforce Help
- Slack-Salesforce Integration OverviewSalesforce Help
Straight from the source - Salesforce's reference material on Guided Slack Setup.
- Slack Apps SetupSalesforce Help
- Map Salesforce Users to Slack UsersSalesforce Help
About the Author
Dipojjal Chakrabarti is a B2C Solution Architect with 29 Salesforce certifications and over 13 years in the Salesforce ecosystem. He runs salesforcedictionary.com to help admins, developers, architects, and cert/interview candidates sharpen their fundamentals. More about Dipojjal.
Test your knowledge
Q1. Who can benefit from understanding Guided Slack Setup?
Q2. What architecture concept is Guided Slack Setup an example of?
Q3. How does Salesforce's multi-tenant model affect Guided Slack Setup?
Discussion
Loading discussion…