Skip to main content

Return to TX Community

Liaison

Setting up the Zoom in your org

Setting up the Zoom connector in your org

Install the Zoom App in Salesforce

You can install the Zoom app in Salesforce AppExchange or Zoom Marketplace. Alternatively, you can install it using the following link:
https://appexchange.salesforce.com/appxListingDetail?listingId=a0N30000000qEuqEAE
1. Navigate to the Zoom Marketplace and sign in as an Admin.
2. Search for Salesforce and click the app.
3. Pre-approve the app if necessary and click Visit site to install.
    Zoom install screen

4. Verify the permissions the app requires and click Authorize:
    Authorize access screen

5. You will be redirected to the listing in Salesforce AppExchange:
App Exchange screen

6. Click Get It Now:

Get It Now button

7. Log in to your Salesforce admin account, if necessary.

If you are directed to the Trailblazer Login page, copy the link into your browser and load it on a tab where you are already logged in to Salesforce.

Log In to AppExchange screen

8. Select if you want to Install in production or Install in sandbox:
Choose location to install package
9. Review the installation details and confirm that you have read and agree to the terms and conditions:
Confirm Installation Details screen

10. Select Confirm and Install.
11. On the following page, choose the option to Install for Admins Only.


Install Zoom screen


12. Click Install.
13. When prompted, verify and Approve Third-Party Access. Check the Field and click Continue.


Approve Third-Party Access screen


14. The Zoom App will then be installed. Once complete, verify that the Zoom App is installed on the Installed Packages page.
 

Installed Packages screen

Configure the Zoom App in Salesforce

Obtain your API Key and Secret

You will need your Zoom API Key and Secret to configure your Salesforce account to work with Zoom. To obtain your API Key and Secret, see this article. You must follow the Accessing your API Key & Secret steps for this section. Once you're done with the Accessing your API Key & Secret steps, Copy your API Key and Secret for use in the next area.

Configure API Key and Secret

1. Navigate to Setup and search for Installed Packages.
2. Click Configure next to Zoom.

Zoom configure option

3. Paste your API Key and Secret from the previous section into the fields Zoom API Key and Zoom API Secret, respectively.

Zoom Configuration panel

4. Click Save.

Note: The User Settings below the Zoom Settings are personal settings for the currently logged-in user only.

Configure the Zoom Settings

These settings are for Admins to set organization-wide settings.

Zoom Settings for API Key

  • Mail Default From Address: If you want to configure an outbound email for all your meeting invitation emails, you can add an Organization-wide email address. Select your desired email address from the list for the field Mail Default From Address. For information on configuring your Organization-Wide Email, see Configuring Org-Wide Email addresses.
  • Populate Meeting Details in Event Description:  If you would like to populate meeting details into the event's description field automatically, check the Field for Populate Details into Event Description. Note: If you are using Salesforce for Outlook, we recommend enabling this setting.
  • Disable Invitation Email: If you want to disable the invitation email from sending, enable this setting.
  • Enable Password for Non-PMI Meeting: If you would like to require passwords for meetings for all users on your account, enable this setting. A password will be automatically generated for each meeting created in Salesforce.

Configure User Settings

These settings are for the currently logged-in user. Each user will need to configure these settings to match their preferences.

Zoom User Settings

  • Enable Personal Meeting ID: To create your meetings in Salesforce, use your Personal Meeting ID (PMI) instead of a generated meeting ID; check the Field for PMI Enabled for Scheduled Meeting.
  • Email Attendees at Meeting Start: To be able to send an email to your meeting attendees when you start a meeting, check the Field for Send Email to Attendees at Launch.
  • Send an ICS attachment in Invitation Emails: To add an ICS file attachment to meeting invites, check the Field for Send ICS in Invitation Email.
  • Disable Invitation Email: If you want to disable the invitation email from sending, enable this setting. Note: This setting depends on the organization setting configured by Salesforce Admins.
  • User Password Settings: If the admin on your account has enabled passwords for your non-PMI meetings, users can choose whether to use the same password for their PMI Meetings, set a password, or generate a random password. 

Zoom user password settings

Setup User Access for the Zoom App

By default, all users have permission to use the Zoom-connected app. If you would like to limit access to the Zoom App, you can change the default permissions to restrict access to specific users in your organization. Note: If you use the default user access settings, move on to the Zoom and Salesforce User Mapping sections. The following steps utilized Salesforce Classic when navigating through these steps.
Follow the steps below:


1. Navigate to edit the Zoom App policy:

  • Salesforce Classic: Navigate to Administration Setup > Manage Apps > Connected Apps and click Edit for the Zoom App.
  • Salesforce Lightning: Navigate to Setup > Platform Tools > Apps > Connected Apps > Manage Connected Apps > Zoom > Edit policies.

Zoom platform tools screen

2. Under OAuth policies, set Permitted Users to Admin-approved users are pre-authorized.

Zoom Oauth Policies setup

3. Click Save.
4. Navigate to Setup and search for Permission Sets.
5. Clone the permission sets for Zoom Admin and Zoom User. You will need to give new labels for the new permission sets.
6. For each new permission set, click Assign Connected Apps > Edit.

Connected Apps setup

7. You will add Zoom to Enabled Connected Apps and click Save.

Enable Connected Apps screen

8. You can then add users to each permission set. Click the permission set and then choose Manage Assignments. Most of your users will likely only need the Zoom User permission set. For reference, the Admin and User have the following privileges:

  • Zoom Admin:
    • Setting for API Key and Secret (org level setting)
    • Personal Setting for Zoom Meetings (user level setting)
    • Customized read/write objects
    • Visual force pages in Zoom Package
  • Zoom User:
    • Setting for Zoom Meetings (Google Calendar Notifications, Use Personal Meeting ID, Send email to attendees before launch)
    • Customized read/write objects
    • Visual force pages in Zoom Package

Add Users to the Zoom Permission Set

After completing the steps above, you can manually add one user at a time to either permission set.

To add one user:

  1. Navigate to Manage Users > Users
  2. Click your desired user
  3. Click Edit Permission Set Assignments
  4. Add the Zoom Permission set to the user

To add Multiple users:
Salesforce Classic:

  1. Navigate to the desired permission set.
  2. Click Manage Assignments
  3. Select the users you would like to add and add them to the permission set.

Salesforce Lightning:

  1. Navigate to Setup > Administration > Users > Permission Sets.
  2. Click Manage Assignments

Clone Zoom User

  1. Select the Users you would like to add and add them to the permission set.

Zoom and Salesforce User Mapping

The Zoom App requires a Salesforce user's email to match their email address in Zoom. If this is not configured correctly, the integration will not work properly for users. For this reason, be sure that the email address of your Salesforce users are unique and match that of their email addresses in Zoom. Without this critical step, the integration won't work correctly for users.
For example, in the screenshot below, User, Integration's email (integration@example.com) must match the email address used in Zoom.

Zoom User mapping

For information on customizing Salesforce objects for Zoom, see Zoom and Salesforce Object Customization
 

Customizing Salesforce objects to include Zoom features

You can customize your Salesforce objects to include Zoom features. Currently, Zoom supports the following:

  • Contact Page Layout
  • Lead Page Layout
  • Event Page Layout
  • Salesforce Event Standard Object

Note: Do not add any other pages to your page layouts that are not listed. It may cause the app to malfunction.

Contact Page Layout Customization 

  1. Navigate to Setup and search for Object Manager.
  2. Click the Contact (Student) object.
  3. Click Page Layouts.
  4. Click the dropdown next to the Contact layout and click Edit.
  5. Click Buttons and move the Start Zoom Meeting to the layout.

Contact detail screen

  1. Click Quick Actions and move the Start Zoom Meeting to the layout.

Quick Actions screen

  1. Click Save.

Lead Page Layout Customization 

These steps are only needed if you are using the LEAD object and wish to use Zoom integration:

  1. Navigate to Setup and search for Object Manager.
  2. Click the Lead object.
  3. Click Page Layouts.
  4. Click the dropdown next to the Contact layout and click Edit.
  5. Click Buttons and move the Start Zoom Meeting to the layout.
  6. Click Quick Actions and move the Start Zoom Meeting to the layout.
  7. Click Save.

Event Page Layout Customization Edit section

  1. Navigate to Setup and search for Object Manager.
  2. Click the Event object.
  3. Click Page Layouts.
  4. Click the dropdown next to the layout and click Edit.
  5. Click Buttons and move the Start Zoom Meeting to the layout.
  6. Click Quick Actions and move the Start Zoom Meeting to the layout.
  7. Create a new section.

Event Page layout Section properties

  1. Name the section: Zoom Meeting Information and add the following fields:
    • Use Personal Meeting ID
    • Enable Join Before Host
    • Schedule a Zoom Meeting
    • Enter the Email Addresses of Attendees
    • If you want to use Timezone for the event, add the fields below.
      • Customer Timezone
      • Customer Start Time
      • Customer Meeting Duration
  2. Create a new section named Zoom Meeting Details.
  3. Select Visualforce Pages and Add ZoomEventDetail to this section. 

Visualforce page option

  1. Configure the height to 400 and click Ok.
  2. Click Save.

Zoom meeting details

Setting up Zoom with Appointment Scheduler

Setting up the Zoom Meetings with TargetX Appointment Scheduler requires additional fields to be populated. Follow the below steps in Salesforce Lightning.

Before completing these steps, you must complete the steps outlined in the Zoom Integration Guide.

To align with Zoom’s recent announcement about their 90-day security initiative, they will require all previous, upcoming, and PMI meetings to need passwords to join meetings. They will begin enforcing this for Paid accounts on May 30th. Please note: To avoid service disruptions for your meetings, please read Zoom’s Blog. This will require you to create a custom field, similar to the PMI, to be updated in the Classic Email Templates via Workflows. 

javascript:void('Edit%20Link')Field & Workflow Setup 

A. Create New User Fields 
  1. Navigate to Setup and search for Object Manager.
  2. Select User.

Note: You must set up the User Object before moving forward.

  1. Select Fields and Relationships
  2. Click New to create a new field:
Step 1: Choose the Field Type

Data Type = Text
Click Next.

Step 2: Enter the Details 

Field Label = Zoom PMI
Length = 15
Check Unique = Do not allow duplicate values 
Click Next.

Step 3:  Setting Field-Level Permissions

Field-Level Security for Profile, leave it as is. 
Click Next.

Step 4: Add to page layouts

Add to page layouts, leave as is, 

Click Save.

B. Create New Organization Event Fields 
  1. Navigate to Object Manager
  2. Select Organization Event
  3. Select Fields and Relationships
  4. Click New to create a new field:
Step 1: Choose the Field Type 

Data Type = Text
Click Next.

Step 2: Enter the Details 

Field Label = Zoom PMI
Length = 15
Click Next.

Step 3: Establish field-level security 

Field-Level Security for Profile, leave it as it is.
Click Next.

Step 4: Add to page layouts 

Click Save.

C. Update Organization Event Field Set Edit section
  1. Navigate to Object Manager
  2. Select Organization Event
  3. Select Field Sets
  4. Select Event Details
  5. Drag the new Field you created above onto the Layout
  6. Click Save.
D. Create a Workflow 
  1. Go to Setup and search for Workflow Rules
  2. Click New Rule:
Step 1: Select Object 

From the dropdown Field, select: Organization Event
Click Next.

Step 2: Configure Workflow Rule 

Enter Rule Name = Zoom PMI Workflow
Evaluation Criteria: created, and any time it’s edited to meet criteria subsequently.
Rule Criteria:
Field the Dropdown, Select: Organization Event: Owner 

Note: DO NOT use Organization Event: Event Owner.

Operator = is not equal to
Value = <blank>
Click Save & Next.

Step 3: Specify Workflow Actions 

Under Immediate Workflow Actions, from the dropdown, select New Field Update.
Name = Zoom Field Update.
Unique Name will automatically update when you click the tab key.
Field to Update dropdown = Zoom PMI.
Specify New Field Value =Use a formula to set the new value.
Select Show Formula Editor.

Select Insert Field
Highlight Organization Event >
In the following Field to the right, select, Owner (User) >
In the following Field to the right, choose Zoom PMI
In the following Field, click the Insert button.

Click Save.
Click Done.

Step 4: Activate Workflow 

From Workflow Screen, click Activate.

E. Configure Users 

You’ll need to complete these steps for each user utilizing Zoom:

  1. Go to Setup and search for Users.
  2. Click Users
  3. Find the user you’d like to utilize.
  4. Click Edit
  5. Add the Users Zoom PMI code (found on the Users Zoom account)
  6. Click Save.
Email Template Setup 
Student Appointment Confirmation Email Template 

Complete the following steps for a Salesforce Email Template:

  1. Navigate to Setup and search for Classic Email Templates.
  2. Under the Folder dropdown, select: Appointment Email Templates
  3. Click: Student Appointment Confirmation
  4. Click the Edit HTML Version button
  5. In HTML Email Content:
  • In HTML Body, add Your Zoom URL (example: https://us02web.zom.us/)
  • Under Available Merge Fields:
  • Field Type = Organization Event Fields
  • Field = Zoom PMI
  • Copy the Merge Field Value and add it to the end of the Zoom URL.

Example: https://us02web.zoom.us/j/{!TargetX_Eventsb__OrgEvent__c.Zoom_Org_Event_PMI__c}

  • Copy what you wrote in the HTML Version for later use.
  • Click Save
  1. Click Edit Text Version
  • Under Email Template, paste the previous Zoom URL from the above example into the document in HTML Preview.
  • Click Save
Student Appointment Reminder Email Template Edit section
  1. Navigate to Setup and search for Classic Email Templates.
  2. Under the Folder dropdown, select: Appointment Email Templates.
  3. Click: Student Appointment Reminder.
  4. Click the Edit HTML Version button.
  • In HTML Email Content:
    • In HTML Body, add your Zoom URL (example: https://us02web.zom.us/)
  • Under Available Merge Fields
  • Select Field Type = Organization Event Fields
  • Select Field = Zoom PMI
  • Copy Merge Field Value and add to end of Zoom URL.

Example: https://us02web.zoom.us/j/{!TargetX_Eventsb__OrgEvent__c.Zoom_Org_Event_PMI__c}

  • Copy what you wrote in the HTML Version for later use.
  • Click Save.
  1. Click Edit Text Version.
  • Under Email Template, paste the previous Zoom URL from the above example into the document in HTML Preview.
  • Click Save.
F. Instant Meetings 

If you are utilizing the Start Zoom meeting from Salesforce, each user must enable the use of Instant Meetings to utilize the Zoom Personal Meeting ID (PMI). The Zoom Admin or individual users can do this.

  1. Log in to your Zoom account.
  2. Click Profile.
  3. Under Personal Meeting ID, click Edit.
  4. Check Use Personal Meeting ID for instant meetings.
  5. Save Changes.

Next step: Using Zoom with TargetX Appointment Scheduler 

  • Was this article helpful?