Configuring Salesforce with integration users and OAuth authentication
This article provides a step-by-step guide for integrating your organization's Salesforce instances using a dedicated integration user who is provisioned with the Salesforce Integration user license and either the Salesforce API Only System Integrations or Minimum Access - API Only Integrations profile. These instructions are designed to ensure seamless integration and compatibility, especially for organizations planning to install and utilize the latest version of the Zoom for Lightning package.
Notes:
- If your organization does not intend to use the Zoom package, specific steps related to permissions for features like Zoom Phone and Zoom ZRA Analysis can be skipped.
- If you want to use Zoom for Lightning package (versions 2.9.0 or later), learn more about the "Share conversation analysis with Salesforce" option when getting started.
Learn more about integrating Revenue Accelerator with Salesforce and configuring Revenue Accelerator in Salesforce.
Requirements for configuring Salesforce with integration users and OAuth authentication
- Pro, Business, Enterprise, or Zoom Phone standalone account
- Licensed user with Zoom Revenue Accelerator license
- Account owner or admin privileges for the Zoom web portal and Salesforce Console
- Approved associated domain
- Users must integrate their calendar with Zoom
- Account utilizing any of the supported Salesforce tools
Note: The account admin must integrate their Customer Relationship Management (CRM) account with Zoom so that Zoom can sync deal progress with Zoom Revenue Accelerator and provide additional analytics
How to create a new integration user
- Sign in to the Salesforce Settings page as an admin.
- In the navigation menu, under Administration, click Users then click the Users tab.
- On the Users page, click New User.
You will be directed to the user setup page. - Under General Information, enter the required information for the user and use the following configurations:
- User License: Select Salesforce Integration.
- Profile: Select Salesforce API Only System Integrations or Minimum Access - API Only Integrations.
- Click Save.
- Once the integration user is created, access Permission Set License Assignments, then click Edit Assignments.
- Enable Salesforce API Integration.
- Click Save.
After saving, an email will be sent to the integration user's email address to verify the account and create a password.
How to create permission sets
Create a permission set for the same profile that's used for the integration user.
- Sign in to the Salesforce Settings page as an admin.
- From the Setup menu, under Administration, click Users then click Permission Sets.
- Click New.
You will be directed to the permission set setup page. - In the Enter permission set information section, enter the permission set details.
- (Optional) Select the Session Activation Required checkbox.
- In the Select the type of users who will use this permission set section, click the License dropdown and select --None--.
Selecting --None-- allows the permission set customizations to be flexible regardless of which user licenses customers choose. In this case, it is a good fit for the Salesforce Integration user license. - Click Save.
Access permission set overview page
- From the Setup menu, under Administration, click Users then Permission Sets.
- Select the permission set you want to manage.
The permission set overview page will appear.
How to edit permission sets
Once a permission set is created, edit the following information.
Note: Enabling all permissions for the following objects and fields prevents the need for customers to retroactively update the permission set if future use cases arise. For example, a Zoom Revenue Accelerator (ZRA) object may only need to be read today but may need updates later.
Edit Account information
- Access the permission set overview page of the permission set you want to manage.
- Click Object Settings.
- Click Accounts.
You will be directed to the Accounts page, which shows an overview of standard objects and Zoom objects. - In the Object Permissions section, select the following checkboxes:
- Read
- Created
- Edit
- Delete
- View All
- Modify All
- In the Field Permissions section, select Read Access and Edit Access for all fields.
- Click Save.
Edit Contacts information
- Access the permission set overview page of the permission set you want to manage.
- Click Object Settings.
- Click Contacts.
- In the Object Permissions section, select the following checkboxes:
- Read
- Created
- Edit
- Delete
- View All
- Modify All
- In the Field Permissions section, select Read Access and Edit Access for all fields.
- Click Save.
Edit Opportunities information
- Access the permission set overview page of the permission set you want to manage.
- Click Object Settings.
- Click Opportunities.
- In the Object Permissions section, select the following checkboxes:
- Read
- Created
- Edit
- Delete
- View All
- Modify All
- In the Field Permissions section, select Read Access and Edit Access for all fields.
- Click Save.
Edit Leads information
- Access the permission set overview page of the permission set you want to manage.
- Click Object Settings.
- Click Leads.
- In the Object Permissions section, select the following checkboxes:
- Read
- Created
- Edit
- Delete
- View All
- Modify All
- In the Field Permissions section, select Read Access and Edit Access for all fields.
- Click Save.
Edit Tasks information
- Access the permission set overview page of the permission set you want to manage.
- Click Object Settings.
- Click Tasks.
- In the Field Permissions section, select Read Access and Edit Access for all fields.
- Click Save.
Edit Zoom Call Logs information
Note: This is used for Zoom for Salesforce Lightning-managed package versions 2.9.0 or later.
- Access the permission set overview page of the permission set you want to manage.
- Click Object Settings.
- Access Zoom Call Logs.
- In the Object Permissions section, select the following checkboxes:
- Read
- Created
- Edit
- Delete
- View All
- Modify All
- In the Field Permissions section, select Read Access and Edit Access for all fields.
- Click Save.
Edit Zoom Meetings information
Note: This is used for Zoom for Salesforce Lightning-managed package versions 2.9.0 or later.
- Access the permission set overview page of the permission set you want to manage.
- Click Object Settings.
- Access Zoom Meetings.
- In the Object Permissions section, select the following checkboxes:
- Read
- Created
- Edit
- Delete
- View All
- Modify All
- In the Field Permissions section, select Read Access and Edit Access for all fields.
- Click Save.
Edit Zoom ZRA Analysis information
Note: This is used for Zoom for Salesforce Lightning-managed package versions 2.9.0 or later.
- Access the permission set overview page of the permission set you want to manage.
- Click Object Settings.
- Access Zoom ZRA Analysis.
- In the Object Permissions section, select the following checkboxes:
- Read
- Created
- Edit
- Delete
- View All
- Modify All
- In the Field Permissions section, select Read Access and Edit Access for all fields.
- Click Save.
Edit other Zoom objects information
Note: For Zoom for Salesforce Lightning-managed package versions earlier than 2.9.0, enable similar permission settings as the above sections for the following Zoom objects.
- Access the permission set overview page of the permission set you want to manage.
- Click Object Settings.
- Access the either of the following Zoom objects:
- Zoom Call Logs (zoom_app__ZOOM_call_log__c)
- Zoom Events (zoom_app__Zoom_Event__c)
- In the Object Permissions section, select the following checkboxes:
- Read
- Created
- Edit
- Delete
- View All
- Modify All
- In the Field Permissions section, select Read Access and Edit Access for all fields.
- Click Save.
How to configure system permissions for the permission set
Enable permission to Activities Related Fields
Note: This is used for tasks and events.
- Access the permission set overview page of the permission set you want to manage.
- Click System Permissions.
- Click System to expand the list of system permissions.
- To the right of the permission name, under the Enabled column, select the checkbox to enable the permission:
- Access Activities: Access tasks, events, calendar, and email.
- Edit Events: Create, edit, and delete events.
- Edit Tasks: Create, edit, and delete tasks.
- Modify All Data: Create, edit, and delete all organization data, regardless of sharing settings.
Note: This automatically enables other settings elsewhere.
- Click Save.
Enable permission to users and roles
Note: This is used to pull team information.
- Access the permission set overview page of the permission set you want to manage.
- Click System Permissions.
- Click User to expand the list of user permissions.
- To the right of the permission name, under the Enabled column, select the Manage Users checkbox to enable the permission.
Note: This automatically enables other settings. - Click Save.
Enable permission to Change Data Capture permissions
- Access the permission set overview page of the permission set you want to manage.
- Click System Permissions.
- Click Change Data Capture to expand the list of permissions.
- To the right of the permission name, under the Enabled column, select the checkbox to enable the permission:
- Modify Metadata Through Metadata API Functions: Create, read, edit, and delete org metadata. Users must have appropriate access rights to the metadata they're trying to modify.
Note: Some metadata executes in system context, when object permissions, field-level security, and sharing rules that apply to the user are ignored. - Customize Application: Customize the organization using the App Setup menu options.
- Click Save.
Enable permission to Others
- Access the permission set overview page of the permission set you want to manage.
- Click System Permissions.
- Click Others to expand the list of permissions.
- To the right of the permission name, under the Enabled column, select the API Enabled checkbox to enable the permission.
- Click Save.
How to assign a permission set to an integration user
After edits to the permission sets are made and system permissions are configured, you can assign the permission set to an integration user.
- Access the permission set overview page of the permission set you want to manage.
- At the top of the page, click Manage Assignments.
- Click Add Assignment.
- Select the user to whom you want to assign the permission set.
- Click Assign.
- Click Done.
After this step, the user will be assigned the permission set.
How to use the OAuth method in Revenue Accelerator
In ZRA, set up the Salesforce integration using the OAuth method.
Note: For Zoom for Salesforce Lightning accounts, verify that ZRA Analysis and/or Task objects are updated in Salesforce accordingly.
Verify ZRA data in Deals
- Sign in to the Zoom web portal with the Salesforce integration user credentials.
- In the navigation menu, click Revenue Accelerator, then click Deals.
- Click the Open Deals tab.
- On the Deals dashboard, verify that the ZRA data is accurately displayed from the Salesforce integration.
Verify ZRA data in Teams
- Sign in to the Zoom web portal with the Salesforce integration user credentials.
- In the navigation menu, click Revenue Accelerator, then click Teams.
- On the Teams page, verify that the ZRA data is accurately displayed from the Salesforce integration.