Bluescape Zoom Configuration Guide

Bluescape can integrate with Zoom, a cloud-based teleconferencing platform. This integration allows you to schedule a meeting via MS Outlook and designate a workspace using the Bluescape add-in. Meeting attendees can access the Bluescape workspace (a persistent information repository) while communicating via Zoom.

With this integration, you can view documents, slides, videos, and other artifacts that a meeting participant shares; in addition, you can store and access these materials after the meeting concludes.

Administrators must complete tasks to set up or establish the Bluescape-Zoom integration for users:

  • Create a JWT App – This action is required to allow users to join Zoom meetings from Bluescape workspaces.
  • Create a Zoom OAuth App – This action is required for scheduling Zoom meetings in Bluescape workspaces using the Bluescape Outlook add-in.
  • Enable Zoom in the Configuration Center – This action enables Zoom across a Bluescape Organization.

Each of these tasks is described below.

Prerequisites

To configure Zoom integrations, the following conditions must be satisfied:

  • You must be a Zoom admin or a Zoom user with the ability to build marketplace apps.
  • Your role must have permissions that allow integrations to be used by Zoom users. Role settings can be found on the Zoom Admin dashboard at the following location:
    User Management > Role Management > role name > Advanced Features

Creating a Zoom JWT App

Note : Only a single JWT app can be created for each Zoom account.

  1. Navigate to App Marketplace and log in as a Zoom account admin.

  2. Click the Create button for the JWT App type.

    • Note: If no Create button appears, you already might have an existing JWT app that you can use. In this case, click the View here link on the pop-up screen to view the existing app information.
      image
  3. On the Information tab, enter values in the following fields:

    1. App Name
    2. Company Name
    3. Developer Name (can be your own name)
    4. Developer Email Address (can be your own email)
  4. Click to open the App Credentials tab; copy the values that appear in the API Key and API Secret fields before pasting them into a Notepad document. You will need these later when enabling Zoom in Bluescape.

  5. On the Activation tab, confirm that the JWT app has been configured correctly. The screen should display the following message:
    image

Creating a Zoom OAuth App

Note : This step is required for private instances, but optional for public instances. It provides control over tokens.

  1. Navigate to App Marketplace and log in as a Zoom account admin.
  2. Click the Create button for the OAuth App type.
  3. On the pop-up screen, provide the following information and then click the Create button.
  • App Name—Enter Bluescape
  • App type—Select the User-managed app option
  1. Deselect the Would you like to publish this app on Zoom App Marketplace? option.
  2. On the App Credentials tab, copy the values in the Client ID and Client Secret fields. These will be used when configuring Zoom in Bluescape.
  3. In the Redirect URL for OAuth field, enter Bluescape Outlook Plugin
  4. In the Whitelist UR L field, enter Bluescape Outlook Plugin
  5. Click to open the Information tab; complete the following fields in the Basic Information region:
  • App Name (should be pre-populated)
  • Short Description
  • Long Description
  1. Complete the following fields in the Developer Contact Information region:
    • Name (can be your own name)
    • Email Address (Rather than enter a specific user’s email address, it is recommended that you enter a Distribution List that includes your company’s IT group email address and the Zoom administrator’s email address. For example, integrations.support@company.com.
  2. Click to open the Scopes tab before clicking the Add Scopes button.
  3. On the Meeting tab of the Add scopes screen, select the following options:
    • View your meetings
    • View and manage your meetings
  4. On the User tab, select the following option:
    • View your user information
  5. Click the Done button.
  6. To verify that the installation completed successfully, click the Activation tab.
  7. Click the Install button.
  8. An Authorization/Consent screen should appear indicating successful setup.
  9. Close the Authorization/Consent screen.

Enabling Zoom in Bluescape

Zoom is configured in Bluescape via the Integrations tab in the Configuration Center. To enable the Zoom integration:

  1. Navigate to the Integrations section of the Configuration Center by clicking the image icon in the left navigation bar.

  2. Click Enable located below the Zoom logo.

  3. The Enable Zoom Integration pop-up window opens. Enter the following information:

  • API Key
  • API Secret
  1. Upon completion, click OK.

Zoom integration is enabled, and users can now conduct Zoom meetings in a workspace in your Organization.

Deploying the Bluescape Meetings Plugin in Office 365

Ownership : Client’s IT team.

Installing for All Users (Office 365 admin)

  1. Log in to the Office 365 Admin Portal.

  2. Navigate to Settings > Add-ins.
    image

  3. On the Services & add-in screen that appears, click the Deploy Add-in button.
    image

  • The New Add-In screen opens.
    image
  1. Select the I have a URL for the manifest file radio button.
  2. Paste the following link in the text box below the radio button:
    https://outlook.apps.us.bluescape.com/assets/autogen/v1/manifest.xml
  3. Click Next.
  4. Review the add-in details. Click Next.
  5. Select how you want the add-in deployed at your Organization:
  • Optional, enabled: The Bluescape for Outlook add-in will be added for all users, but they can remove it.
  • Optional, disabled: All users will have the option to add Bluescape or Outlook, but it will not be added to Outlook by default.
  • Mandatory, always enabled: The Bluescape for Outlook add-in will be added for all users, and they will not be able to disable it.
  1. Click Next.
  2. Select who has access to this add-in. You can search for groups to add them.
  3. Click Save.
  4. Click Close when the manifest file completes processing.

Users may need to restart their apps to view the new add-in. Depending on the number of users in your account, changes might take a few minutes to propagate to all users.

Post-Configuration Checklist

Ownership: The Client’s IT team using any account that is a member of the configured Organization and using a valid Zoom user account that is part of a configured Zoom company account.

  1. Open the Outlook add-in.
  2. Sign in to Bluescape/Zoom/Customer SSO.
  3. Create a test meeting.
  4. Send the meeting to the participants.
  5. Click the link in the email invitation.
  6. The workspace should open with the Zoom widget loaded.
    If the workspace fails to open or the widget fails to load, contact Bluescape Support for assistance.

Disabling the Bluescape-Zoom Integration

You can disable the integration between Bluescape and Zoom at any time. There are two aspects to this process:

  • Disabling Zoom from Bluescape
  • Disabling Bluescape from Zoom

To disable Zoom from Bluescape, contact Bluescape Support here and explain your request. A Support Agent will disable Zoom from your Bluescape Organization.

To disable Bluescape from Zoom:

  1. Navigate to the Zoom Marketplace at marketplace/zoom.us.
  2. Click Sign in, and log in as a Zoom account admin.
  3. Click Manage.
  4. Click Installed Apps.
  5. Locate Bluescape. Click Uninstall .Clicking Uninstall will display a confirmation to remove the app. You can grant or deny permission for the app developer to retain your data. If consent is granted, the data will not be deleted. If permission is not granted, the developer is required to follow the Marketplace Data Compliance requirements and delete the data within 10 days of app removal.