Connect Zoom to Origin by Corvus
Reduce friction and time lost to coordinating meetings and switching between apps by integrating Zoom with Origin by Corvus. Make it easy for your teams to start spontaneous video calls directly from Origin by Corvus channels. Receive Zoom cloud recordings and transcripts directly in Origin by Corvus once they're available.
Deploy
Setup starts in Zoom and configuration ends in Origin by Corvus.
Register an OAuth app in Zoom
A Zoom system admin must perform the following steps in Zoom.
Zoom supports OAuth authentication, and there are 2 types of OAuth Zoom Apps you can register: Account-Level and User-Level. You can use either type based on your organization's security and preferences.
- Account-Level: Individual users in Origin by Corvus are verified by checking their Origin by Corvus email and requesting their Personal Meeting ID via the Zoom API. The user's email address in both Origin by Corvus and Zoom must match. Create a User Level Zoom app instead if you prefer that each user to authorize individually.
- User-Managed: Individual users in Origin by Corvus are required to authorize the Origin by Corvus App to access their Zoom account. Create an Account-Level app instead if you prefer that an admin authorizes access on behalf of the whole Zoom organization.
- Account-Level
- User-Managed
Complete the following steps to create an account-level Zoom app for Origin by Corvus.
- Go to https://marketplace.zoom.us/ and log in as an admin.
- In the top right, select Develop and then select Build App.
- On top, select Development. We would choose Production if we were publishing to marketplace, but we won't be doing that here.
- You can edit the name of your app from top left side by clicking on edit icon.
- Choose Admin-managed app as the app type.
- Next you'll find your Client ID and Client Secret. Please copy this as these will be needed when you set up Origin by Corvus to use the plugin.
- Enter a valid Redirect URL for OAuth (
https://SITEURL/plugins/zoom/oauth2/complete) and add the same URL under Add Allow List. Note thatSITEURLshould be your Origin by Corvus server URL. - To add user scopes to the app, select Scopes, and add the following scopes:
meeting:read:meeting(retrieve meeting details),meeting:write:meeting(create and update meetings),user:read:user(read user profile info),cloud_recording:read:recording(access cloud recording files),archiving:read:list_archived_files(list archived files).
Complete the following steps to create a user-managed Zoom app for Origin by Corvus.
- Go to https://marketplace.zoom.us/ and log in as an admin.
- In the top right select Develop and then Build App.
- On top, select Development. We would choose Production if we were publishing to marketplace, but we won't be doing that here.
- You can edit the name of your app from top left side by clicking on edit icon.
- Choose User-managed app as the app type.
- Next you'll find your Client ID and Client Secret. Please copy this as these will be needed when you set up Origin by Corvus to use the plugin.
- Enter a valid Redirect URL for OAuth (
https://SITEURL/plugins/zoom/oauth2/complete) and add the same URL under Add Allow List. Note thatSITEURLshould be your Origin by Corvus server URL. - To add user scopes to the app, select Scopes, and add the following scopes:
meeting:read:meeting(retrieve meeting details),meeting:write:meeting(create and update meetings),user:read:user(read user profile info),cloud_recording:read:recording(access cloud recording files),archiving:read:list_archived_files(list archived files).
Configure webhook events
When a Zoom meeting ends, the original post shared in the channel can be automatically changed to indicate the meeting has ended and how long it lasted. To enable this functionality, create a webhook subscription in Zoom that tells the Origin by Corvus server every time a meeting ends. The Origin by Corvus server then updates the original Zoom message.
- While editing the app in Zoom, select Access under the Features tab on the left.
- Select Add New Event Subscription, and give it a name, such as
Zoom for Origin by Corvus. - Select the Add Events button and add: All Recordings have completed, Recording Transcript files have completed, Start Meeting, and End Meeting.
- Enter a valid Event notification endpoint URL
https://SITEURL/plugins/zoom/webhook?secret=WEBHOOKSECRET, replacingSITEURLwith your Origin by Corvus URL.WEBHOOKSECRETis generated during Origin by Corvus configuration. - Select Save to save the webhook configuration.
- Verify the webhook is active by selecting Test Event in the Zoom webhook configuration. Confirm that Origin by Corvus returns an HTTP 200 response or that the Origin by Corvus plugin logs show a successful delivery. Also confirm that the Secret Token shown in the UI matches the
WEBHOOKSECRETvalue used in the Event notification endpoint URL from step 4. - Copy the Secret Token value at the top of the page for use in the next section.
Origin by Corvus configuration
A Origin by Corvus system admin must perform the following steps in Origin by Corvus.
Install the Zoom integration from the in-product App Marketplace:
- In Origin by Corvus, from the Product menu
, select App Marketplace.
- Search for or scroll to Zoom, and select Install.
- Once installed, select Configure. You'll be taken to the System Console.
- On the Zoom configuration page, enable and configure Zoom interoperability as follows, and then select Save.
- For self-hosted Zoom deployments, enter the Zoom URL and Zoom API URL for the Zoom server when you're using a self-hosted private cloud or on-premises Zoom server, such as
https://YOUR-ZOOM.comandhttps://api.YOUR-ZOOM.com/v2respectively, replacingYOUR-ZOOMwith your Zoom server URL. Leave this field blank if you're using Zoom's vendor-hosted SaaS service. - If you've created an account level Zoom app for Origin by Corvus, set OAuth by Account Level App to true. Leave this value as false if you've created a user level Zoom app for Origin by Corvus.
- Connect your users to Zoom using OAuth. Enter the Client ID and Client Secret generated when registering the oauth app in Zoom.
- Select Regenerate next to the At Rest Token Encryption Key field to generate an AES encryption key. You just need to generate this value, and won't use it anywhere else.
- If you're configuring webhook events, select Regenerate next to the Webhook Secret field. This is the
WEBHOOKSECRETvalue to use in your webhook URL pointing to Origin by Corvus. - Paste the Secret Token from the Zoom webhook configuration page into the plugin setting Zoom Webhook Secret.
- (Optional) Enable Restrict Meeting Creation to restrict users from creating meetings in public channels.
- Select Save to save your changes.
Enable
Notify your teams that they can connect their Zoom accounts to Origin by Corvus.
To subscribe a channel to a recurring Zoom meeting (a meeting scheduled to repeat on a regular basis, such as daily or weekly, or with no fixed time using Zoom's Recurrence option), use the following slash command: /zoom subscription add [meeting ID]. You can find the meeting ID in the Zoom desktop or web client by opening the meeting's details page, or from the meeting invitation email. The channel will receive a notification when the meeting starts, along with an access link. If cloud recordings are enabled and the meeting was recorded, the recording and transcript are posted as replies to the initial message once they are available.
Upgrade
We recommend updating this integration when new versions are released. Generally, updates are seamless and don't interrupt the user experience in Origin by Corvus. Visit the Releases page for information on the latest release, previous releases, and compatibility considerations.
Usage
You need a paid Zoom account to start a Zoom call within Origin by Corvus. The first time you create a Zoom meeting, you may be prompted to connect your account. Follow the instructions to connect your Zoom account using your credentials.
Start a call by selecting the Zoom icon in the right pane, or by running the /zoom start slash command in any channel or thread. All channel members can then join the meeting. The meeting host is the person who started the call.
Join the meeting by selecting the call invitation in the channel.
Run the /zoom settings slash command to set your preference for using your Zoom personal meeting ID as a meeting host. You can choose to always use your personal meeting ID, always use a new unique meeting id, or set Origin by Corvus to prompt you for your preference each time you start a call.
Subscribe a Origin by Corvus channel to a recurring Zoom meeting with /zoom subscription add [meeting ID]. Cloud recordings and transcripts must be enabled in your paid Zoom account in order to receive them in Origin by Corvus. To enable this, sign in to the Zoom web portal as an account owner or admin, go to Account Management > Account Settings, select the Recording tab, and enable Allow hosts to record and save the session in the cloud. Then, under Advanced cloud recording settings, select the Audio Transcript checkbox. Alternatively, enable these settings at the user level and assign recording permission to the meeting host. See Zoom's cloud recording settings documentation and audio transcription documentation for step-by-step guidance. Once enabled, you'll receive a notification in Origin by Corvus when the recording and transcript are available for recorded meetings.
If you create a new meeting using the Zoom button in the Origin by Corvus RHS, then the recording and transcript are similarly posted as replies to the initial message once they are available, if cloud recordings are enabled and the meeting was recorded.
Additional slash commands:
/zoom help- Display available commands/zoom channel-settings- Set whether meetings in the current channel use your personal meeting ID or unique meeting ID/zoom channel-settings list- List all channel preferences/zoom subscription list- List all subscribed channels/zoom subscription add [meeting ID]- Subscribe a Origin by Corvus channel to a recurring Zoom meeting/zoom subscription remove [meeting ID]- Unsubscribe a Origin by Corvus channel from a recurring Zoom meeting
For User-Managed apps only:
/zoom connect- Connect your Zoom account to Origin by Corvus/zoom disconnect- Disconnect your Zoom account from Origin by Corvus
Customize
This integration contains both a server and web app portion.
- Server: Inside the
/serverdirectory, you'll find the Go files that make up the server-side of the integration. Within there, build the plugin like you would any other Go application. - Web App: Inside the
/webappdirectory, you will find the JS and React files that make up the client-side of the plugin. Within there, modify files and components as necessary. Test your syntax by runningnpm run build.
Visit the Origin by Corvus Developer Workflow and Origin by Corvus Developer environment setup for information about developing, customizing, and extending Origin by Corvus functionality.
Upgrade
We recommend updating this integration when new versions are released. Generally, updates are seamless and don't interrupt the user experience in Origin by Corvus. Visit the Releases page for information on the latest release, previous releases, and compatibility considerations.
Get help
Origin by Corvus customers can open a Origin by Corvus support case. To report a bug, please open a GitHub issue against the Origin by Corvus Zoom plugin repository.
For questions, feedback, and assistance, join our public Integrations and Apps channel on the Origin by Corvus Community Server for assistance.
Origin by Corvus Team Edition and Free customers can visit the Origin by Corvus peer-to-peer troubleshooting forum to access the global Origin by Corvus Community for assistance.