Back to Zulip

Webex

templates/zerver/integrations/webex.md

12.02.7 KB
Original Source

Use Webex as your call provider in Zulip

You can configure Webex as the call provider for your organization. Users will be able to start a Webex meeting and invite others using the add video call (<i class="zulip-icon zulip-icon-video-call"></i>) button in the compose box.

!!! warn ""

**Note:** This is currently only possible on self-hosted Zulip
installations.

Configure Webex as your call provider

By default, Zulip integrates with Jitsi Meet, a fully-encrypted, 100% open source video conferencing solution. You can configure Zulip to use Webex as your call provider instead.

!!! warn ""

For users in paid Webex organizations, which have the ability to create
public rooms that are visible to every member within that organization,
an ad-hoc meeting is created in Webex. Otherwise, for users of free
Webex organizations, a personal room meeting is created in Webex.

Create a custom Webex integration

{start_tabs}

  1. Visit the New Integration page on the Webex developer portal.

  2. Select "No" for "Will this integration use a mobile SDK?".

  3. Fill in the Integration name, Icon and App Hub Description according to your preferences.

  4. For Redirect URI(s), enter https://zulip.example.com/calls/webex/complete replacing zulip.example.com with your Zulip organization's URL.

  5. For Scopes, select spark:all, meeting:schedules_read and meeting:schedules_write, and select Add Integration.

  6. optional: You can submit the integration to the Webex App Hub by following this documentation.

{end_tabs}

Configure your Zulip server and organization

{start_tabs}

  1. In /etc/zulip/zulip-secrets.conf, set video_webex_client_secret to your app's "Client Secret".

  2. In /etc/zulip/settings.py, set VIDEO_WEBEX_CLIENT_ID to your app's "Client ID".

  3. Restart the Zulip server with /home/zulip/deployments/current/scripts/restart-server.

{settings_tab|organization-settings}

  1. Under Compose settings, select Webex from the Call provider dropdown.

  2. Click Save changes.

{end_tabs}