Some checks failed
Code scanning / CodeQL (push) Failing after 15s
Zulip production suite / Ubuntu 22.04 production build (push) Failing after 26s
Zulip production suite / Debian 12 production install with custom db name and user (push) Has been skipped
Zulip production suite / Ubuntu 22.04 production install and PostgreSQL upgrade with pgroonga (push) Has been skipped
Zulip production suite / Ubuntu 24.04 production install (push) Has been skipped
Zulip production suite / Ubuntu 26.04 production install (push) Has been skipped
Zulip production suite / Debian 13 production install (push) Has been skipped
Zulip production suite / 7.0 Version Upgrade (push) Has been skipped
Zulip production suite / 8.0 Version Upgrade (push) Has been skipped
Zulip production suite / 6.0 Version Upgrade (push) Has been skipped
Zulip production suite / 10.0 Version Upgrade (push) Has been skipped
Zulip production suite / 9.0 Version Upgrade (push) Has been skipped
Zulip production suite / 12.0 Version Upgrade (push) Has been skipped
Zulip production suite / 11.0 Version Upgrade (push) Has been skipped
GitHub Actions Security Analysis with zizmor / zizmor (push) Failing after 3s
Zulip CI / Debian 12 (Python 3.11, backend + documentation) (push) Failing after 26s
Zulip CI / Ubuntu 22.04 (Python 3.10, backend + frontend) (push) Failing after 3s
Zulip CI / Ubuntu 24.04 (Python 3.12, backend) (push) Failing after 25s
Zulip CI / Ubuntu 26.04 (Python 3.14, backend) (push) Failing after 25s
Zulip CI / Debian 13 (Python 3.13, backend) (push) Failing after 28s
Zulip production suite / Required jobs (push) Has been cancelled
Zulip CI / Required jobs (push) Has been cancelled
API Documentation Update Check / check-feature-level-updated (push) Has been cancelled
API Documentation Update Check / notify-if-api-docs-changed (push) Has been cancelled
80 lines
2.7 KiB
Markdown
80 lines
2.7 KiB
Markdown
# 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](/help/start-a-call).
|
|
|
|
!!! 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](https://jitsi.org/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](https://developer.webex.com/my-apps/new/integration)
|
|
page on the Webex developer portal.
|
|
|
|
1. Select "No" for "Will this integration use a mobile SDK?".
|
|
|
|
1. Fill in the **Integration name**, **Icon** and **App Hub Description**
|
|
according to your preferences.
|
|
|
|
1. For **Redirect URI(s)**, enter `https://zulip.example.com/calls/webex/complete`
|
|
replacing `zulip.example.com` with your Zulip organization's URL.
|
|
|
|
1. For **Scopes**, select `spark:all`, `meeting:schedules_read` and
|
|
`meeting:schedules_write`, and select **Add Integration**.
|
|
|
|
1. _optional_: You can submit the integration to the [Webex App Hub](https://apphub.webex.com/)
|
|
by following [this documentation](https://developer.webex.com/create/docs/app-hub-submission-process).
|
|
|
|
{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".
|
|
|
|
1. In `/etc/zulip/settings.py`, set `VIDEO_WEBEX_CLIENT_ID` to your
|
|
app's "Client ID".
|
|
|
|
1. 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.
|
|
|
|
1. Click **Save changes**.
|
|
|
|
{end_tabs}
|
|
|
|
## Related documentation
|
|
|
|
- [How to start a call](/help/start-a-call)
|
|
- [Webex's developer documentation](https://developer.webex.com/create/docs/integrations)
|
|
- [Jitsi Meet integration](/integrations/jitsi)
|
|
- [BigBlueButton integration](/integrations/big-blue-button)
|
|
- [Constructor Groups integration](/integrations/constructor-groups)
|
|
- [Nextcloud Talk integration](/integrations/nextcloud-talk)
|