Zoom integration setup guide


About

The Zoom integration uploads your Zoom meeting and webinar recordings to Kaltura automatically, so all your recordings are stored and organized in one place.

Recordings are added to categories in the Rich Media CMS, and to My Media in Content Hubs and the legacy Video Portal for the matching user.

The Zoom meeting host owns the recording in Kaltura, and you can add co-hosts to collaborate. Transcripts and chat transcripts are saved with your recordings in Kaltura automatically.

This article walks administrators through setting up the Zoom integration in Kaltura, configuring default behavior, and assigning recording categories and ownership.

With the Zoom integration, you can:

  • Delete recordings from Zoom after they're imported
  • Combine multiple recordings from the same session into a multi-stream video
  • Choose whether to upload Zoom transcripts
  • Publish imported content to Kaltura categories or LMS course categories automatically. For LMS publishing, see Zoom Integration - Publish Zoom recordings to LMS courses.
  • Set the recording owner based on the Zoom user ID or CMS user ID
  • Connect multiple Zoom accounts to one Kaltura account

The Zoom integration is available in the Zoom Marketplace.

If Zoom transcription is turned on, REACH captions and transcripts aren't generated, because transcripts are imported from Zoom. To use REACH captions, turn off Zoom transcription in the integration settings.

Before you start

Zoom prerequisites

  • A paid Zoom account
  • Access to Zoom Cloud Recording
  • Zoom admin permissions to add apps from the Zoom Marketplace

Kaltura prerequisites

  • For the administrator who sets up the integration: a Rich Media CMS user ID, Partner ID, and administrator secret
  • For end users: a Kaltura user ID in their Zoom profile, to set ownership of their recordings

Each Zoom account is linked to a specific Kaltura account for recording transfers.

Set up Zoom integration

The following video shows how to install the Kaltura app in Zoom.

 

If you use the legacy Zoom Kaltura Integration, remove the legacy integration settings before you add the Kaltura app from the Zoom Marketplace.

  1. Go to the Zoom Marketplace, and log in with your Zoom admin credentials.
  2. Zoom marketplace user interface

  3. Search for and select Kaltura.
  4. marketplace page showing Kaltura icon

  5. Click Allow to add the Kaltura app to your Zoom account.
  6. Window showing Allow and Decline buttons

    A Kaltura page opens and asks for an integration code.
  7. In a new browser tab, get the integration code from the Rich Media CMS. For more information, see Get integration code.
  8. Go back to the Kaltura page in Zoom, and enter the integration code you copied. Leave the URL as it is, unless your account is on a regional cloud.
  9. integration code field in Kaltura interface

  10. Click Submit.

After Zoom accepts the code, configure the integration in the Rich Media CMS. For more information, see Configure Zoom integration settings.

Get integration code

  1. Log in to the Rich Media CMS.
  2. Click the settings icon at the far right.
  3. Rich Media CMS navbar showing settings icon

    The settings page opens.
  4. Click the Integration tab.
  5. Rich Media CMS menu showing integration tab

  6. Scroll down to Zoom integration, and click Generate integration code.
  7. Generate integration code button in Rich Media CMS

    The Integration code window opens.
  8. Click Copy and close.
  9. The code is copied to your clipboard, and the message Copied to the clipboard. appears. (For security, the code is blurred in this article.)

The integration code is valid for 24 hours and works only once. It's generated per Partner ID. If the code expires, generate a new one.

Configure Zoom integration settings

In the Rich Media CMS, the Zoom integration section on the Integration tab lists all your integrated Zoom accounts.

 list of Zoom integrated accounts in Rich Media CMS

  1. Click the Zoom account you want to configure.
  2. The Zoom account window opens.

  3. Configure the settings. For a description of each setting, see Integration settings, User permissions for uploaded recordings, and Recording owner settings.
  4. Click Save.

For the first phase of the Kaltura integration with Zoom, you need to:

  1. Disable the integration and then re-enable it.
  2. Review and update the integration settings, and click Save.

To enable, disable, or edit an integration, click the three dots next to it.

three dot menu next to a Zoom account in list

Integration settings

  • Enable integration: Select Yes to enable the Zoom integration.
  • Zoom account ID: Shows the Zoom account linked to this integration.
  • Zoom account description: Enter a description to help you identify this Zoom account.
  • Upload meeting recordings: Select Yes to upload Zoom meeting recordings to Kaltura automatically.
  • Category: Enter one or more categories for Zoom meeting recordings. Start typing, and then select categories from the list.

    If you are using the LMS automatic publishing workflow, you can leave the Category field empty. Recordings are published to LMS course categories based on the KalturaCategory and KalturaCategoryPath tracking fields configured in Zoom. To publish recordings to a Kaltura category and an LMS course category, enter the Kaltura category here.

  • Upload webinar recordings: Select Yes to upload Zoom webinar recordings to Kaltura automatically.
  • Webinar category: Enter one or more categories for Zoom webinar recordings. Start typing, and then select categories from the list.
  • Upload recordings management: Select whose recordings are uploaded:
    • Upload all recordings: Upload recordings for all users.
    • Opt-in groups: Upload recordings only for users in the groups you select.
    • Opt-out groups: Upload recordings for all users except those in the groups you select.

    If you select Opt-in groups or Opt-out groups, a field appears where you enter at least one group.

    Options shown in the Upload recordings management field

  • An integrated Zoom account can use opt-in groups or opt-out groups, but not both.
  • If a user doesn't exist and you select Use default user, change @defaultUserID@ to assign the user to a group.

To create groups and add users to them, see Manage groups in the Configuration Management console. After you create a group, start typing its name in the Rich Media CMS to find it.

  • Delete content from Zoom after upload: Select whether to delete recordings from Zoom automatically after they're uploaded to Kaltura. Recordings are deleted one day after upload. To change the delay, edit the Zoom drop folder configuration in the Admin Console.
  • Zoom transcription: Select whether to import Zoom transcripts with recordings. If you select this option, REACH captions and transcripts aren't generated.

User permissions for uploaded recordings

These settings apply to all meeting recordings. They're available only when Zoom user is selected under Set user based on.

  • Alternative hosts: Select how alternative hosts are handled for uploaded recordings.
  • Co-hosts: Select how co-hosts are handled for uploaded recordings.
  • Participants: Select whether meeting participants are:
    • Added as co-publishers
    • Added as co-viewers
    • Ignored

Recording owner settings

  • Set user based on: Select how Kaltura finds the recording owner:
    • Zoom user: Match Zoom users to Kaltura users by Zoom user ID.
    • CMS user: Match users by the cms_user_id value from SAML mapping.

When Zoom user is selected, Kaltura matches the Zoom user ID to a Kaltura user ID. If there's no match, Kaltura searches by email address or external ID, based on the Find user by setting.

Use a postfix option when Zoom and Kaltura use different user ID formats. For example, Zoom provides first.last@company.com, but Kaltura stores first.last.

  • Select how Zoom user IDs are processed: Do not modify, Remove postfix, or Add postfix.
  • Postfix: Enter the postfix when Add postfix is selected.
  • Find user by: Select another way to find the user if there's no match by user ID:
    • Email
    • External ID (use with SSO)
  • In case the user doesn't exist: Select what happens when no matching user is found:
    • Create new user based on Zoom user
    • Use default user
  • Default user: Select the user who owns uploaded recordings when Use default user is selected and no matching user is found.

Handle audio-only recordings

If your Zoom account records an audio-only file, Kaltura makes that recording the parent video in the multi-stream recording from Zoom.

To prevent this, turn off audio-only recordings in Zoom. Clear the Record an audio only file checkbox, and then click Save.

audio settings panel in Zoom

Create Zoom recordings

When users in the configured account record a Zoom session, the recording uploads to Kaltura.

After the meeting ends, the recording is processed and synced to Kaltura automatically. Its name is "Zoom" followed by the Zoom meeting ID.

recording synced to Kaltura showing in My Recordings tab in Zoom interface

Recording layouts

Zoom lets admins choose the recording layout for each session. If more than one layout is selected, Zoom creates a separate recording for each layout.

In Kaltura, these recordings are grouped automatically and play as a multi-stream recording in the player. For more information, see Dual screen plugin.

To learn how the recordings are linked, see Understanding parent-child entries.

To manage your Zoom recordings, see Manage and view Zoom recordings in Kaltura.

Was this article helpful?
Thank you for your feedback!
User Icon

Thank you! Your comment has been submitted.

In this article
Related articles
Back to top