Zoom Plugin

Mattermost’s open source Zoom plugin enables users to start and join voice, video and screensharing meetings using either Zoom’s self-hosted private cloud or on-prem solutions, or its vendor-hosted SaaS solution.

The plugin is installed by default and can be quickly activated.

Usage

Once enabled, clicking a video icon in a Mattermost channel invites team members to join a Zoom call, hosted using the credentials of the user who initiated the call.

https://user-images.githubusercontent.com/177788/42196048-af54d2b8-7e30-11e8-80a0-5e160ae06f03.png

Using other voice, video and screensharing services

The open source Zoom plugin can be extended to launch other voice, video and screensharing systems, including custom self-hosted services and vendor-hosted SaaS services such as Skype and Google Hangouts, depending on your needs.

The following outlines the steps for enabling Zoom.

Zoom Setup Guide

  1. Go to System Console > Plugins > Zoom to configure the Zoom Plugin.
../_images/zoom_system_console.png
  1. If you’re using a self-hosted private cloud or on-premise Zoom server, enter the Zoom URL and Zoom API URL for the Zoom server, for example https://yourzoom.com and https://api.yourzoom.com/v2 respectively. Leave blank if you’re using Zoom’s vendor-hosted SaaS service.
  2. Set the API Key and API Secret (see below).

API Key and API Secret

The API Key and API Secret are generated by Zoom and are used to create meetings and pull user data. To generate an API Key and API Secret:

Important

Setting up the account in Zoom requires a Pro, Business, Education, or API Zoom plan.

  1. Go to https://developer.zoom.us/me/ and log in.
  2. Switch to the API tab and click Enable, if not already enabled.
  3. Switch back to the API tab and copy the API Key and API Secret.
  4. Paste the API Key and API Secret into the fields in the System Console.
../_images/zoom_api_key.png

Webhook Secret

This is the Secret used to authenticate the webhook to Mattermost. Use the webhook URL to set up the Zoom webhook. Then hit Save.

../_images/zoom_webhook.png
  1. The settings for overriding usernames and profile picture icons need to be enabled.
  2. Once these steps are done, activate the plugin at System Console > Plugins > Management by clicking Activate.
../_images/zoom_system-console_management.png
  1. Once activated, you will see a video icon in the channel header. Clicking the icon will open a drop-down menu with three actions you can take: Start Zoom Meeting Now, Start Zoom Meeting with Topic, and Share Zoom Meeting.
https://user-images.githubusercontent.com/177788/42196048-af54d2b8-7e30-11e8-80a0-5e160ae06f03.png

Note

Users will need to sign-up for their own Zoom account using the same email address that they use for Mattermost. If the user attempts to start a Zoom meeting without a Zoom account, they will see the following error message: “We could not verify your Mattermost account in Zoom. Please ensure that your Mattermost email address matches your Zoom email address.” In addition, the user must be added to the admin’s Zoom account to quickly start a meeting without having to share a personal meeting ID.