Zoom, GoToWebinar, and Webex Integrations
  • 06 Feb 2024
  • 6 Minutes to read
  • Dark
    Light

Zoom, GoToWebinar, and Webex Integrations

  • Dark
    Light

Article Summary

Events / Zoom Integration Update

The following changes have been made to prevent an Attendee from being added to a Zoom meeting or webinar as a cohost.

If the integration between Events and Zoom fails to automatically register an Attendee with Zoom, the AttendeeLink will revert to a generic “join” link instead of the link used by the host. Zoom may also require the Attendee to enter their name/register when joining the meeting.

We officially support Zoom, GoToWebinar, and Webex natively within our app!

To use this feature...

You will need a paid version of Zoom, GoToWebinar, or Webex.


GoToMeetingGoToWebinarZoom MeetingsZoom WebinarWebex MeetingWebex Events
Webinar AccountUnsupportedSupportedSupportedSupportedSupportedUnsupported
Meeting AccountUnsupportedSupportedSupportedSupportedSupportedUnsupported
Via Meeting URL fieldSupportedSupportedSupportedSupportedSupportedUnsupported
Limitation

Users need at least the Marketplace permissions in Zoom; otherwise, an Admin will need to provide approval.

Create a Webinar Account

  1. Open the App Launcher and navigate to Webinar Accounts.

  2. Click New in the top right corner to create a new account.
    D_07_02 create webinar acct 1

  3. Create a new Webinar Account record with Provider = "Zoom", "GoToWebinar", or "Webex".
    Note: Webinar Name and Provider are the only two fields needed to be filled out. First Name, Last Name, Email, Organizer Key, and Account Key will be populated once you connect the account to your provider
    D_07_02 create webinar acct 2

  4. Click Save.

  5. From the Webinar Account record, click the Authorize button.

Authentication Error

If you receive the following error message when authorizing a Zoom Webinar Account, please follow the steps below.

"It looks like you are already authenticated to use the Zoom Integration. If you are receiving other errors, please contact Blackthorn Support."

  1. Navigate to: https://marketplace.zoom.us/.
  2. Click Manage on the top right.
  3. Click on Added Apps.
  4. Find "Blackthorn Events" and click Remove on the right-hand side.

D_07_02 create webinar acct 3

  1. Complete the OAuth by clicking Connect and enter your webinar account credentials.
    D_07_02 create webinar acct 4

  2. Your Webinar Account should be automatically updated with the First Name, Last Name, Email, Organizer Key, and Account Key.
    D_07_02 create webinar acct 5

Create a Webinar

Zoom Personal Meeting ID

The Zoom Personal Meeting ID Enabled checkbox field was added to the Event and Session objects. If Zoom Personal Meeting ID Enabled = "True" (checked), and a Zoom account has Personal Meeting ID enabled, the Meeting IDs on the Blackthorn record and the AttendeeLink will match. 

LIMITATION: There is a known limitation when using Blackthorn Events with Personal Meeting IDs. The Attendees must enter a name before joining the meeting.

  1. Add the Webinar/Meeting Account and Webinar/Meeting ID fields to your Event OR Session page layout.

    • This will hold the Webinar/Meeting Account and Webinar/Meeting ID for the specific webinar. You can set different accounts on multiple Events, depending on who is hosting the Event!
    • Optional: Add Webinar/Meeting Password if you will be enabling passwords. This field is automatically populated if passwords are required on your Zoom account.
    • Optional: Add Zoom Type if you will be using Zoom to determine between a Webinar and Meeting URL.
    • Here is a video that walks through the steps for adding webinars to Sessions.
  2. Add the Create Webinar button to your Event OR Session page layout. This button will generate the meeting inside of Zoom, GoToWebinar, or Webex and populate the Webinar/Meeting ID field.

  3. Add the Add to Webinar button on the Attendee page layout. This button will add an Attendee to the webinar, if the Attendee is created manually.

  4. Add the Webinar/Meeting Join URL field on the Attendee page layout. This field sends the Attendee the direct URL to join the meeting.

  5. Create a new Event and update the Webinar/Meeting Account field with the Webinar Account you just created.
    D_07_02 new event 1

  6. Save the Event record.

  7. Click the Create Webinar button.
    D_07_02 new event 2

  8. The Webinar ID will be populated automatically on the Event's Webinar/Meeting ID field. This value should not be edited as changing this value will result in Attendees not being able to join your webinar.
    D_07_02 new event 3

What happens if there is an issue?
The user who authorized the Blackthorn Events app will receive email notifications for critical failures related to webinar URL generation.

Register Attendees

Automatically Register Attendees with your Webinar Provider
If you want Attendees to sync in real time, click the Register Attendees for Webinars button in the Blackthorn | Events Admin tab. Your Attendees will then receive a personalized URL to join the webinar. (Batch Job Name: Blackthorn | Events Attendee Webinar Registration)


NOTE: This batch job will only run when there is a Webinar/Meeting ID on the Event, and the Attendee's Registration Status = "Registered".

After Attendees complete the checkout process, they will receive an email from the Webinar Account owner with the webinar details.

Note: These emails will only be sent if using a Webinar Account. For Zoom meetings these emails will not be sent, but an Attendee will receive their AttendeeLink.

For example, GoToWebinar will look similar to this email:
D_07_02 attendee registering 1

If an Attendee registers for a Webex Event, their invite will look similar to this:
D_07_02 attendee registering 2

This email will be sent automatically once the Attendee's Registration Status = "Registered".
D_07_02 attendee registering 3

FAQ

Q: It doesn't look like my Attendees have registered for my webinar. What do I do?

A: Currently, Zoom and GoToWebinar update their rosters with registered Attendees once an hour.

If you want Attendees to sync in real time, use the Register Attendees for Webinars button in the Blackthorn | Events Admin tab. This batch job will only run when there is a Webinar/Meeting ID on the Event, and the Attendee's Registration Status = "Registered".

  1. Click the Blackthorn | Events Admin tab.
  2. Click Batch Jobs in the left hand column.
  3. Click Register Attendees for Webinars.

Q: How do I create webinars through the Blackthorn | Events Admin tab?

A: If you have many Events and do not want to navigate to each and manually create a webinar for each, this section is for you! This will create a webinar for every Event where Webinar/Meeting ID = " ".

  1. In Webinar Accounts, authorize the platform of your choice.
  2. Add the Webinar/Meeting ID field to each Event you want to add a webinar to.
  3. Click on Blackthorn | Events Admin tab.
  4. Click on Batch Jobs in the left hand column.
  5. Click Create Webinars for Events.
    Note: You can also use the Create Webinars for Sessions button for Sessions to have the same effect, but for all Sessions.

Webinars will be auto generated without using the create webinar button.

Q: Required Parameters Missing or Wrong

A: This error occurs for GoToMeeting and Webex based accounts that need to be reauthorized. There are two ways to resolve this:

  1. Navigate to the Webinar Account record receiving the error.
  2. Click the Authorize button.
    D_07_02 faq 1

or

  1. Navigate to the Blackthorn | Events Admin tab.
  2. Click Schedule Recommended Event Jobs.
  3. This will refresh the tokens for GTM and Webex every 29 days and will ensure the error doesn't appear again.
    D_07_02 faq 2

Q: What happens if the webinar account refresh token expires?

A: To make sure the webinar account refresh token doesn’t expire, schedule the Blackthorn | Event Webinar Account Refresh (WebinarAccountAuthRefresh) apex class job. If the job is not included in the list of Apex Classes, follow the steps below to add it. 

  1. Click the Gear icon. 
  2. Click Setup
  3. In the Quick Find box, enter and click “Apex Classes”.
  4. Click Schedule Apex.
  5. Complete the following fields.
    1. Job Name
    2. Apex Class = “WebinarAccountAuthRefresh” (If you don’t know the exact name, click the magnifying glass and search for the name in the pop-up window.)
    3. Set the Frequency to run daily. ("Weekly" + "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", and "Sunday")
    4. Start date
    5. End date
    6. Preferred Start Time
  6. Click Save.

Q: How do I change the Webinar/Meeting URL for an existing Event if the Event already has a Webinar/Meeting URL?

A: To change the Webinar/Meeting URL link for an Event or Session that has an existing Webinar/Meeting URL, complete the steps below.

  1. Go to the Event or Session record.
  2. Delete the URL in the Webinar/Meeting URL field.
  3. Click Save.
  4. Click the Create a Webinar/Meeting button.
  5. Confirm the Zoom Type.
  6. Click Create.

A new URL be added to the Webinar/Meeting URL field.

LIMITATIONS

  • Existing Attendees will only be able to access the original Webinar/Meeting URL via their AttendeeLink.
  • If an existing Attendee clicks the Add To Calendar button, the original Webinar/Meeting URL will be added to the Attendee's calendar.
  • Only Attendees that are registered after the Webinar/Meeting URL was updated will have access to the new Webinar/Meeting URL.

Q: How do I remove Zoom?

A: To remove your Zoom authorization from your Salesforce org, please do the following:

  1. Navigate to https://marketplace.zoom.us/ and log in.
  2. Click Manage in the top right corner.
  3. Click Installed Apps under My Dashboard.
  4. Click Uninstall on Blackthorn Events.
  5. Done! Zoom and Blackthorn Events will no longer be linked.