Zoom Spoke

  • Release version: Washingtondc
  • Updated August 1, 2024
  • 5 minutes to read
  • Create and manage Zoom meetings with the Zoom spoke from your ServiceNow instance. With this spoke, you can add participants, retrieve details, end or delete a meeting, or fetch the participant details of a conference.

    Request apps on the Store

    Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.

    Integration Hub subscription

    This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview.

    Spoke version

    Zoom spoke v4.2.0 is the latest version.

    Supported versions

    Zoom API version v2.0.

    Spoke dependencies

    If you’re having trouble installing the app, make sure that these dependent plugins are installed:
    • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
    • ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
    • Key Management Framework (com.glide.kmf.global)
    • ServiceNow AI Platform Encryption (com.glide.now.platform.encryption)
    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    • Complex Object (com.glide.cobject)

    Spoke flows

    This spoke has no sample flows.

    Spoke subflows

    The Zoom spoke provides sample subflows for processing inbound events that are related to meetings, recordings, webinars, and users. Available sample subflows are described in the following table.

    Table 1. Spoke subflows
    Subflow Description
    Zoom Process Meeting Events Handles Zoom meeting webhook events.
    Zoom Process Recording Events Handles Zoom recording webhook events.
    Zoom Process User Events Handles Zoom user webhook events.
    Zoom Process Webinar Event Handles Zoom webinar webhook events.

    Spoke modules

    The Zoom spoke adds the Zoom application to your instance and includes the modules in the following table.
    Table 2. Spoke modules
    Module Description
    Phone Numbers Displays a list of Zoom Phone numbers.
    Zoom Webhook Registries Displays a list of webhook registries that are associated to Zoom.

    Spoke actions

    The Zoom spoke provides you with actions so that you can automate Zoom tasks when events occur in the ServiceNow AI Platform. Th available actions are described in the following table.

    Table 3. Spoke actions
    Category Action Description Granular scope needed
    Cloud Recording Management Look up meeting recording settings Retrieves the settings of the meeting’s cloud recordings.
    Note:
    The meeting password is retrieved and displayed as plain text.

    cloud_recording:read:recording_settings:admin

    Look up meeting recordings Retrieves all the recorded meetings for the specified meeting ID.

    cloud_recording:read:list_recording_files:admin

    Look up recordings stream Lists all the recorded meetings of the specified user.

    cloud_recording:read:list_user_recordings:admin

    Phone Management Assign calling plan To User Assigns a calling plan to a user.

    phone:write:calling_plan:admin

    Assign phone number to user Assigns a phone number to a user who has already enabled Zoom Phone. phone:write:user_number:admin
    Get country codes (metadata) Retrieves the metadata of countries and their ISO codes.
    Look up account call logs stream Retrieves the call logs for an account. phone:read:list_call_logs:admin
    Look up calling plans Retrieves a list of calling plans.

    phone:read:list_calling_plans:admin

    Look up phone number details Retrieves the details of a specified phone number in a Zoom account. phone:read:numbers:admin
    Look up phone numbers stream Retrieves the list of phone numbers. phone:read:list_numbers:admin
    Look up phone users stream Retrieves all the users that are associated to an account with assigned Zoom Phone licenses. phone:read:list_users:admin
    Look up user call logs stream Retrieves the call logs of a user’s Zoom Phone. phone:read:list_call_logs:admin
    Look up user phone profile Retrieves a Zoom Phone user’s profile. phone:read:user:admin
    Look up user recordings stream Retrieves a Zoom Phone user’s recordings.

    phone:read:list_recordings:admin

    Look up user phone settings Retrieve a user's Zoom Phone profile. phone:read:user_setting:admin
    Look up user voicemails Stream Retrieves a Zoom Phone user’s voicemails.

    phone:read:list_voicemails:admin

    Unassign user calling plan Unassigns a calling plan to a user who has enabled Zoom Phone.

    phone:delete:users_calling_plan:admin

    Unassign user phone number Unassigns a phone number to a user who has enabled Zoom Phone.

    phone:delete:user_number:admin

    Update main company number Updates the main company number of an account.
    Update user phone profile Updates a user’s Zoom Phone profile. phone:update:user:admin
    Update user phone settings Updates the settings of a specific Zoom Phone user.

    phone:update:user_setting:admin

    Meeting Management Add meeting registrant Registers a participant for a specific meeting. meeting:write:meeting:admin
    Create meeting Creates a meeting for a user using their Zoom user ID or the email address and other details such as start time, type of meeting, and agenda. The action can also include in the meeting details one or more alternative hosts' email ID. meeting:write:meeting:admin
    Delete meeting Deletes a specific meeting by using its meeting ID. meeting:delete:meeting:admin
    End meeting Ends an ongoing meeting. meeting:delete:meeting:admin
    Look up meeting Details Gets details of a specific meeting by its meeting ID. meeting:read:meeting:admin
    Update Meeting Identifies a meeting by its ID and then updates its details such as start time, duration, and topic. meeting:update:meeting:admin
    Look up ended meeting instances Lists all the meeting instances that were ended. meeting:read:list_meetings:admin
    Look up live meetings by user stream Lists all the live or ongoing meetings for a specific user. meeting:read:list_meetings:admin
    Look up Meetings Stream Lists the given user's meetings. meeting:read:list_meetings:admin
    User Management Create user Creates a user in your account.
    Note:
    A Zoom pro plan or later is required for this action. You must enable pre-provisioning for SSO users in your Zoom account.
    user:write:user:admin
    Delete user Deletes a specific user from your account. user:delete:user:admin
    Disassociate user Unlinks a specific user from your account. user:delete:user:admin
    Look up user details Gets the details of a specific user on your account by using their user ID. user:read:user:admin
    Look up users stream Retrieves all the users that are associated to your account.

    user:read:list_users:admin

    Update user settings Updates the settings of a specific user. user:update:user:admin
    Chat Management Add members to channel Adds members to a Zoom channel. team_chat:write:members:admin
    Create channel Creates a Zoom channel. team_chat:write:user_channel:admin
    Look up channel Retrieves the details of a Zoom channel. team_chat:read:user_channel:admin
    Look up channel members stream Retrieves the details of the members in a Zoom channel. team_chat:read:list_members:admin
    Look up user chat message stream Retrieves the details of a member's chats in a Zoom channel. team_chat:read:list_user_messages:admin
    Look up user channels stream Retrieves the names of theZoom channels. team_chat:read:list_user_channels:admin
    Remove member from channel Removes a member from a Zoom channel. team_chat:delete:member:admin
    Send chat message Sends a chat message to a Zoom channel. team_chat:write:user_message:admin
    Update channel Updates a Zoom channel's details. team_chat:update:user_channel:admin
    Utility Actions Copy chat message attachment to record Copies the attachment that contains the chat message to the incident record. team_chat:read:user_message:admin

    Zoom account requirements

    The Zoom spoke requires that you configure your Zoom account to generate an OAuth 2.0 token.

    Zoom spoke requirements

    These actions use REST calls, which can run on an instance or Zoom spoke See Building flows for more information. Use the connection record that is associated with the Zoom alias to configure where actions run and set Zoom spoke selection attributes. For more information about the alias, see Connection and credential alias.

    Connection and credential alias requirements

    Integration Hub uses aliases to manage connection and credential information. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection. For more information, see Connections and Credentials.

    This spoke uses the Zoom Connection & Credential Alias record to authorize actions. For information about setting up the spoke, see Set up the Zoom spoke.