Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Zoom plugin configuration docs to reflect settings for new functionality #7276

Open
wants to merge 10 commits into
base: master
Choose a base branch
from
29 changes: 29 additions & 0 deletions source/collaborate/chat-with-copilot.rst
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,35 @@ To summarize unread Mattermost channels:
.. image:: ../images/Unread-Channel-Messages-Summarization-Updated-4-3.gif
:alt: Quickly summarize new messages, find action opens, and seek out unanswered questions with your Copilot.

Summarize Zoom meetings in Mattermost
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. include:: ../_static/badges/ent-only.rst
:start-after: :nosearch:

.. note::

The Zoom plugin must be :doc:`enabled and configured </integration/zoom-interoperability>` by a Mattermost system admin and Zoom cloud recordings and transcripts must be enabled before you can summarize Zoom meetings.

If the Zoom plugin is enabled and configured, subscribe a Mattermost channel to a Zoom meeting (``/zoom subscribe [meeting ID]``) and record the meeting. Once the recording and transcription are available, they are automatically shared back to the channel.
azigler marked this conversation as resolved.
Show resolved Hide resolved

Use Mattermost to turn Zoom meeting recordings into actionable AI-generated summaries with any model of your choosing, including your own. By summarizing your Zoom meeting recordings in Mattermost, you can easily share the insights with your team and the broader organization, enhancing communication and productivity without sacrificing data privacy and control.

To summarize a Zoom meeting in Mattermost:

1. Subscribe a Mattermost channel to a recurring Zoom meeting with ``/zoom subscribe [meeting ID]`` or start a meeting using the Zoom button in the Mattermost RHS.
2. Record the Zoom meeting.
3. Once the meeting ends and the transcript file is posted to Mattermost, select the **Create meeting summary** option located directly below the file.

.. image:: ../images/create-meeting-summary-zoom.png
:alt: Select the Create meeting summary option to summarize your Zoom meeting in Mattermost.

4. The meeting summary is generated and shared as a direct message with the person who requested the meeting summary.

.. image:: ../images/copilot-Zoom-Meeting-Summary.png
:alt: Easily share the updates from your Zoom meetings with your team and broader organization by turning recordings into detailed summaries at the click of a button.
:scale: 50

Bring Copilot into any conversation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand Down
Binary file added source/images/copilot-Zoom-Meeting-Summary.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/images/create-meeting-summary-zoom.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
21 changes: 14 additions & 7 deletions source/integrate/zoom-interoperability.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Connect Zoom to Mattermost
:start-after: :nosearch:


Reduce friction and time lost to coordinating meetings and switching between apps by integrating Zoom with Mattermost. Make it easy for your teams to start both spontaneous video calls directly from Mattermost channels.
Reduce friction and time lost to coordinating meetings and switching between apps by integrating Zoom with Mattermost. Make it easy for your teams to start both spontaneous video calls directly from Mattermost channels. Receive Zoom cloud recordings and transcripts directly in Mattermost once they're available.

Setup
------
Expand Down Expand Up @@ -33,7 +33,7 @@ Zoom supports OAuth authentication, and there are 2 types of OAuth Zoom Apps you
5. Choose **Admin-managed app** as the app type.
6. Next you'll find your **Client ID** and **Client Secret**. Please copy this as these will be needed when you set up Mattermost to use the plugin.
7. Enter a valid **Redirect URL for OAuth** \(`https://SITEURL/plugins/zoom/oauth2/complete`\) and add the same URL under **Add Allow List**. Note that `SITEURL` should be your Mattermost server URL.
8. To add user scopes to the app, select **Scopes**, and add the following scopes: ``meeting:read:meeting:admin``, ``meeting:write:meeting:admin``,and ``user:read:user:admin``.
8. To add user scopes to the app, select **Scopes**, and add the following scopes: ``meeting:read:meeting``, ``meeting:write:meeting``, ``user:read:user``, ``cloud_recording:read:recording``, ``archiving:read:list_archived_files``.

.. tab:: User-Managed

Expand All @@ -46,18 +46,19 @@ Zoom supports OAuth authentication, and there are 2 types of OAuth Zoom Apps you
5. Choose **User-managed app** as the app type.
6. Next you'll find your **Client ID** and **Client Secret**. Please copy this as these will be needed when you set up Mattermost to use the plugin.
7. Enter a valid **Redirect URL for OAuth** \(`https://SITEURL/plugins/zoom/oauth2/complete`\) and add the same URL under **Add Allow List**. Note that `SITEURL` should be your Mattermost server URL.
8. To add user scopes to the app, select **Scopes**, and add the following scopes: ``meeting:read:meeting``, ``meeting:write:meeting``,and ``user:read:user``.
8. To add user scopes to the app, select **Scopes**, and add the following scopes: ``meeting:read:meeting``, ``meeting:write:meeting``, ``user:read:user``, ``cloud_recording:read:recording``, ``archiving:read: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 Mattermost server every time a meeting ends. The Mattermost server then updates the original Zoom message.

1. While editing the app in Zoom, select **Access** under the **Features** tab on the left.
2. Select **Add New Event Subscription**, and give it a name, such as ``Meeting Ended``.
3. Enter a valid **Event notification endpoint URL** ``https://SITEURL/plugins/zoom/webhook?secret=WEBHOOKSECRET``, replacing ``SITEURL`` with your Mattermost URL. ``WEBHOOKSECRET`` is generated during `Mattermost configuration <#mattermost-configuration>`__.
4. Select **Save** to save the webhook configuration.
5. Copy the **Secret Token** value at the top of the page for use in the next section.
2. Select **Add New Event Subscription**, and give it a name, such as ``Zoom for Mattermost``.
3. Select the **Add Events** button and add: **All Recordings have completed**, **Recording Transcript files have completed**, **Start Meeting**, and **End Meeting**.
4. Enter a valid **Event notification endpoint URL** ``https://SITEURL/plugins/zoom/webhook?secret=WEBHOOKSECRET``, replacing ``SITEURL`` with your Mattermost URL. ``WEBHOOKSECRET`` is generated during `Mattermost configuration <#mattermost-configuration>`__.
5. Select **Save** to save the webhook configuration.
6. Copy the **Secret Token** value at the top of the page for use in the next section.

Mattermost configuration
~~~~~~~~~~~~~~~~~~~~~~~~
Expand All @@ -83,6 +84,8 @@ Enable

Notify your teams that they can `connect their Zoom accounts to Mattermost <#usage>`__.

To subscribe a channel to a recurring Zoom meeting, use the following slash command: ``/zoom subscribe [meeting ID]``. 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
-------

Expand All @@ -99,6 +102,10 @@ 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 Mattermost to prompt you for your preference each time you start a call.

Subscribe a Mattermost channel to a recurring Zoom meeting with ``/zoom subscribe [meeting ID]``. Cloud recordings and transcripts must be enabled in your paid Zoom account in order to receive them in Mattermost. Once enabled, you'll receive a notification in Mattermost when the recording and transcript are available for recorded meetings.

If you create a new meeting using the Zoom button in the Mattermost 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.

Get help
--------

Expand Down
Loading