Introduction

BlueJeans is the meeting platform for the modern workplace. It brings video, audio and web conferencing together with the collaboration tools people use every day. It helps you schedule, join and host one-touch meetings in just a few seconds from anywhere, on any device or room system.


BlueJeans helps drive meeting productivity within the digital workplace through seamless integration with your favorite scheduling, messaging, productivity, and content management tools. Where Bluejeans does wonders in resolving the business pain of allowing teams to collaborate in real-time, VIDIZMO empowers such meeting solutions with its out-of-the-box content hosting, storage, and management capabilities to make the valuable discussions and ideas live forever and their integration can do wonders for your organization. 


Concept

How we at VIDIZMO, integrate with BlueJeans revolves around four technical concepts that need to be understood. 

1. How to get the App and Secret key.

2. How BlueJeans Users will be treated in VIDIZMO Portal;

3. How BlueJeans meeting recordings will be fetched from BlueJeans Cloud and uploaded into VIDIZMO Portal.

4. How to track the synchronization between VIDIZMO and BlueJeans at any given time.


Note: For BlueJeans integration with VIDIZMO, you would need Enterprise level access of BlueJeans account. Otherwise App and Secret Keys will not be generated. To learn more about it, read: Authentication Methods for BlueJeans Meetings API Endpoints


App and Secret Keys

The first step to VIDZMO-BlueJeans integration is client authentication. BlueJeans offers 4 methods of authentication, out of which VIDIZMO uses the 3rd one: Client Credentials Grant. Read more about the methods here: BlueJeans Meeting Authentication.

Our preferred solution would have been to authenticate systems via administrative login within BlueJeans Account to give required permissions for the two apps, VIDIZMO and BlueJeans in this case, to securely communicate. Yet, using BlueJeans Password Credential Grant, it did not grant us the rights to access BlueJeans meeting recordings of all users within an enterprise account, but only of the user whose credentials were used for authentication, even if that were the Admin of the account itself. Hence, for a seamless integration to fetch meeting recordings from your BlueJeans Account to your VIDIZMO Enterprise Account, we established an enterprise-level access connection using an authentication method that requires you to provide us a Client ID and a Client Secret for establishing secure communication between the two applications.


This requires two unique strings (App Key and Secret Key) associated with your BlueJeans application and p them in VIDIZMO. Please make sure to treat these strings securely to prevent malicious applications from gaining access to your BlueJeans App.


Note:  If you enter an invalid APP Key or Secret Key that does not exist, then no recordings will be fetched.


BlueJeans Users

In order to fetch and process your BlueJeans Cloud recorded meetings here in VIDIZMO Portal, we let you control how to sync your Bluejeans Users with VIDIZMO identities:


  • BlueJeans app asks you to choose BlueJeans users against which recorded meetings should be fetched and stored in the Portal. This means that when you enter email addresses of 2 of your users, only the meetings recorded by them in their BlueJeans Cloud Account will be processed and imported into the VIDIZMO Portal.


Note: If you leave this section blank, we will sync and process recordings from all Bluejeans users part of the BlueJeans Account into the VIDIZMO Portal. This means that settings such as concatenation or deletion of recordings will apply to all cloud recordings within that BlueJeans Account. Alternatively, if you enter an email address of a user that does not exist in BlueJeans Account, then no recordings will be fetched.


  • Secondly, BlueJeans App inquires further which user would you wish to publish BlueJeans recorded meetings as. Here, you can either choose to publish it as yourself or as a BlueJeans User. Let's expand on what each of these means:
    • If you choose Me, the author of all BlueJeans meetings in Portal will be you - the user who configured the app. Now there's a twist to this, if your Portal has multiple Managers then every time a Manager updates the app, or enables the app after disabling it for a while - he/she will become the author of BlueJeans recordings in the Portal from that point onwards. In simpler words, BlueJeans meetings will be published against the logged-in user who made the latest update to the BlueJeans app.
    • If you choose BlueJeans User, the author of the BlueJeans meetings in Portal will be one of the BlueJeans users against whose account that recording has been fetched. But there are two scenarios to this:
      1. The user already exists in VIDIZMO Portal. This will help streamline system flow and BlueJeans meetings will be published with the respective user as Author. However, if the existing user has been assigned the role of a Viewer, we shall upgrade them to a Contributor role to allow them to upload media to the portal. Learn more about roles by reading: Understanding User Roles.
      2. The user does not exist in VIDIZMO Portal. In this case, we will create a user with the same email address, and assign them the role of Contributor by default. After sign-up, users will receive an email to notify them about the success of their BlueJeans meeting recording uploaded in the Portal along with a sign-up URL using which they can reset their passwords.


BlueJeans Meetings

VIDIZMO's powerful integration lets you control how you want to import your BlueJeans recorded meetings into your VIDIZMO Portal. Following is a guide to help you understand what each option while configuring your BlueJeans App, has in store for you:

  • We will only process and fetch the recordings on your BlueJeans Cloud which are associated with those BlueJeans users whose Email Addresses you will provide to us.
  • You can choose to concatenate your BlueJeans recorded meetings into a single video for ease of context and access. We concatenate your meetings based on their GUID in your BlueJeans Portal. This means that:
    If you hold a meeting with several panelists on board with multiple topics to be addressed where some are confidential while others ought to be recorded and shared with the rest of the team, you will record the session in planned intervals. Now where BlueJeans creates 4 different recordings for you as per the start-pause-resume-pause-resume-pause-resume-stop sequence. VIDIZMO allows you to concatenate these recordings into one for a smoother user experience using the unique identifier of the meeting of interest.
  • Next, you can delete recordings from your BlueJeans Cloud account to help you save your storage costs. However, be very careful while enabling this check since there is no way to retrieve back your recordings in the BlueJeans Account. You can always download them thenceforth from your VIDIZMO Portal.
  • Next, you can choose how to publish your BlueJeans meetings in VIDIZMO Portal, either as drafts or as published media in the library. However, the following are some considerations to these settings:
    • Whichever Publish Status you choose, the portal will honor the default Portal library settings while publishing your media in the Portal. This means that if Content Moderationhas been enabled in the Portal, then your BlueJeans meetings will be published differently than the status chosen, this is how:
      • If you choose your BlueJeans meetings' status as Published, they will be sent for content moderation for approval before they are published in the portal for shared access.
      • Similarly, if you choose Drafts, your BlueJeans meetings will go to Drafts. However, as soon you log into your Portal and publish the draft, media will be sent for moderation before being published in the library.
    • If you choose to publish your BlueJeans Meetings directly on the Portal, this means that default publish settings will be applied on every media being uploaded via BlueJeans App. You can always go and edit the media settings later on if you need them.

Sync Process

Now, VIDIZMO also allows you to keep track of the sync process so you can always stay up-to-date with the meetings you need from your BlueJeans Account.


As soon as you enable the toggle button of your BlueJeans App, once VIDIZMO is authorized by BlueJeans using the App Key and Secret you provided, we shall indicate the success of establishing a secure communication channel between your BlueJeans account and VIDIZMO portal by showcasing Authorized against your BlueJeans app in the Portal.


Here are some details about how the synchronization works:
After authorization, a workflow shall be initiated to fetch recordings from your BlueJeans Account(s), this workflow will be re-initiated upon any changes made to the app's configuration settings or its state (on/off). You can track the sync process of your application using the below metrics displayed against your BlueJeans App when activated:

  • Sync Status: This will display values such as Running, Finished to indicate the status of the sync workflow running behind. In case of a failure, it will also show an error log for further debugging purposes.
  • Last Synced At: This will return the latest instance in a local date-time format at which our processor fetched videos from BlueJeans Cloud. This helps you keep informed on the sync status of your files in the VIDIZMO Portal.
  • Last Recording Fetched Till: This value shall return the local timestamp based on the instance till which your recordings have been transferred into the VIDIZMO Portal. VIDIZMO starts fetching your meetings from the most previous to the latest one recorded using BlueJeans. This entails that if the latest recording fetched successfully from BlueJeans to VIDIZMO was recorded on 14/09/2019 11:10 AM, we will use this timestamp to help you determine the last recording fetched. 

Integration

This integration will allow you to seamlessly fetch your BlueJeans meeting recordings here in VIDIZMO Portal, with a few clicks of app configuration. Below is a detailed user flow to help you understand what you can ideally achieve when you sync your BlueJeans videos to VIDIZMO Portal: