How to set up Zoom Contact Center CRM connector for Salesforce

Zoom Contact Center integrates with Salesforce through a CRM connector that gives agents instant customer context when interactions arrive. When a customer calls or chats, Salesforce automatically looks up their record and shows the agent their contact details, previous cases, interaction history, and account information — all before the agent answers. After the interaction, the connector logs everything back to Salesforce: duration, channel, disposition, and agent notes.

What the Integration Does

Here’s exactly what happens once the CRM connector is configured:

When a customer calls in (voice):

1. Customer calls your contact center number and is routed to a queue.
2. An agent in the queue receives the interaction in the Zoom agent desktop.
3. Simultaneously, Salesforce searches Contacts, Leads, and Accounts for the caller’s phone number.
4. If a match is found, Salesforce opens the customer’s record automatically (screen pop) — the agent sees name, account, recent cases, and interaction history.
5. If multiple matches exist, Salesforce shows a list for the agent to select.
6. If no match, Salesforce opens a new Contact form pre-populated with the caller’s phone number.
7. The agent handles the interaction with full context.
8. After the call, the agent selects a disposition code and adds notes.
9. Salesforce creates an Activity (Task) on the customer’s record with interaction details.

When a customer starts a chat or messaging interaction:

1. Customer initiates a web chat, SMS, or WhatsApp message.
2. Zoom Contact Center routes the interaction to an available agent.
3. Salesforce searches for the customer by email address (for web chat) or phone number (for SMS/WhatsApp).
4. Screen pop opens the matching record — same as voice.
5. After resolution, an Activity is logged on the customer’s record.

What gets logged on every interaction:

Prerequisites

• Zoom Contact Center licenses for all agents
• Salesforce Lightning Experience (Classic is not supported)
• Salesforce admin access to install packages and configure connected apps
• Zoom admin access to enable the Salesforce CRM connector
• Open CTI enabled in Salesforce (included in all Lightning editions)

Step 1: Enable the CRM Connector in Zoom

1. Sign in to the Zoom web portal as an admin.
2. Navigate to Contact Center > Integrations.
3. Find Salesforce in the integration list.
4. Click Configure > toggle the integration On.
5. Note any configuration values shown (API keys, callback URLs) — you’ll need these in Salesforce.

Step 2: Install the Zoom Contact Center Package in Salesforce

1. Go to Salesforce AppExchange.
2. Search for Zoom Contact Center for Salesforce.
   • Important: This is a separate package from “Zoom for Salesforce” (meetings) and “Zoom Phone for Salesforce” (phone CTI). Make sure you install the Contact Center-specific package.
3. Click Get It Now > select your Salesforce org.
4. Choose Install for All Users (recommended) or specific profiles.
5. Click Install. The package creates custom objects, fields, and a connected app.

Step 3: Authorize the Connection

After installing the package:

1. In Salesforce, go to Setup > Connected Apps > find the Zoom Contact Center app.
2. Verify the OAuth settings are correct (the package should have pre-configured these).
3. In the Zoom admin portal, go to Contact Center > Integrations > Salesforce.
4. Click Authorize and sign in with your Salesforce admin credentials.
5. Grant the requested permissions — the connector needs access to Contacts, Leads, Accounts, Cases, and Activities.

Step 4: Configure Customer Lookup Rules

The CRM connector needs to know how to find customers in Salesforce when an interaction arrives.

1. In the Zoom admin portal, go to Contact Center > Integrations > Salesforce > Lookup Configuration.
2. Configure matching rules:

Voice Interactions (Phone Number Lookup)

Chat / Messaging Interactions (Email Lookup)

Advanced: Custom Field Matching

For scenarios where you match by a custom identifier (e.g., customer ID entered in the IVR):

1. In the lookup configuration, add a custom matching rule.
2. Set the Source to a Zoom Contact Center flow variable (populated by the IVR or chatbot).
3. Set the Target to the custom Salesforce field (e.g., Customer_ID__c).

Step 5: Configure the Agent Desktop Screen Pop

Control what agents see when a customer record opens:

1. In Salesforce Setup, search for Softphone Layouts in Quick Find.
2. Create a new layout or edit the default:

Inbound Voice Layout

Inbound Chat/Messaging Layout

3. Click Save.
4. Assign the layout to the user profiles used by contact center agents.

Step 6: Configure Disposition Code Syncing

Map Zoom Contact Center disposition codes to Salesforce fields so agent wrap-up data flows to CRM records.

Create Disposition Codes in Zoom

1. In the Zoom admin portal, go to Contact Center > Queues > select a queue > Disposition Codes.
2. Create codes that match your business needs:

Map Dispositions to Salesforce

1. In the CRM connector settings, go to Disposition Mapping.
2. Map each Zoom disposition code to:
   • Salesforce Activity Status — e.g., “Completed” or “In Progress”
   • Custom picklist field — e.g., a Disposition__c field on the Task object
   • Case Status — if the interaction is related to a Case (e.g., “Resolved” → Case Status = “Closed”)

Step 7: Configure Activity Logging

Control what gets written to Salesforce after each interaction:

1. In the CRM connector settings, go to Activity Logging.
2. Configure:

Step 8: Add the Agent Widget to the Salesforce App

1. In Salesforce Setup, search for App Manager in Quick Find.
2. Find the app your agents use (e.g., “Service Console”) > click Edit.
3. In the app editor, click Utility Items in the left sidebar.
4. Click Add Utility Item > select Open CTI Softphone.
5. Configure:
   • Label: “Zoom Contact Center” or “Phone”
   • Width: 400
   • Height: 600
   • Start automatically: Yes
6. Click Save.

The Zoom Contact Center widget now appears in the bottom-left of the Salesforce interface for all agents using that app.

Step 9: Test the Integration

Test Inbound Voice

1. Call your contact center number from an external phone.
2. Navigate the IVR to reach a queue where a test agent is available.
3. Verify:
   • Agent receives the interaction in the Zoom agent desktop
   • Salesforce performs a screen pop (opens the matching Contact or shows “New Contact”)
   • After hanging up, an Activity appears on the record in Salesforce
   • Disposition code is synced to the Activity

Test Inbound Chat

1. Start a web chat on your website (or test URL).
2. Verify:
   • Agent receives the chat in the Zoom agent desktop
   • Salesforce looks up the customer by email and shows the matching record
   • After ending the chat, an Activity is logged with the chat transcript

Test Activity Logging

Check the Activity record for:

• Correct duration
• Correct channel (voice/chat)
• Disposition code present
• Wrap-up notes saved
• Recording link (for voice, if recording is enabled)

Advanced: Case Auto-Creation

Automatically create Salesforce Cases from contact center interactions:

1. In the CRM connector settings, go to Case Configuration.
2. Enable Auto-create Case on interaction.
3. Configure:
   • When to create: On every interaction / Only when no open case exists / Only for specific queues
   • Case fields: Map interaction data to Case fields (queue name → Case Origin, disposition → Case Status)
   • Assignment rules: Use Salesforce assignment rules to route Cases to the right team

This means every customer interaction automatically creates a trackable Case in Salesforce, even if the agent doesn’t manually create one.

Common Issues

• Screen pop not working — Check the customer lookup configuration. The caller’s phone number must match a number stored on a Contact, Lead, or Account. Phone number format is the most common issue — Zoom sends numbers in E.164 format (+1XXXXXXXXXX) while Salesforce may store them as “(555) 123-4567”. Standardize phone formats in Salesforce or configure the connector’s matching rules to normalize numbers.
• Agent widget not appearing in Salesforce — Verify the Open CTI Softphone utility item is added to the agent’s Lightning app (Setup > App Manager > edit the app > Utility Items). Also check that the agent’s Salesforce profile has permission to use the CTI adapter.
• Disposition codes not syncing to Salesforce — Verify the disposition mapping configuration in the CRM connector settings. Check that the target Salesforce field exists and the agent’s profile has write access to it.
• Activities logged on wrong record — When multiple Contacts share the same phone number, the auto-match may pick the wrong one. Configure the screen pop to show a selection list for multiple matches. Also verify the agent selected the correct record during the screen pop.
• Chat interactions not logging email — The customer’s email must be captured during the chat flow (e.g., pre-chat form). If the chat starts without an email, there’s nothing to match against in Salesforce. Add an email capture step to your web chat flow.
• Recording link not appearing in Activity — Call recording must be enabled in the Zoom Contact Center settings for the queue. Also verify the Salesforce connected app has permission to access recordings.
• “No matching records” on every call — Phone number format mismatch (see first issue). Also check that the lookup configuration includes all relevant phone fields (Phone, Mobile Phone, Other Phone) — some organizations only store numbers in the Mobile Phone field.
• Duplicate Activities being created — If you also have the Zoom Phone CTI package installed, both packages may try to log the same call. Configure the Contact Center connector to handle all contact center interactions and the Phone CTI to handle only direct Zoom Phone calls (non-contact center).