From c551ec89db2491ddc25c93c67abb6fab556883ab Mon Sep 17 00:00:00 2001 From: Pranav Katariya Date: Wed, 28 Jan 2026 02:49:39 -0800 Subject: [PATCH] docs: use production URLs as default in Zoom examples Change all Zoom config examples to show production URLs by default: - Use @xmpp.zoom.us instead of @xmppdev.zoom.us - Remove explicit apiHost/oauthHost (defaults to production) - Add separate development config examples - Reorder sections to show production first Matches code defaults: apiHost defaults to https://api.zoom.us and oauthHost defaults to https://zoom.us --- docs/channels/zoom.md | 63 ++++++++++++++++++++++++++++--------------- 1 file changed, 42 insertions(+), 21 deletions(-) diff --git a/docs/channels/zoom.md b/docs/channels/zoom.md index 7dcc5b699..3777aa423 100644 --- a/docs/channels/zoom.md +++ b/docs/channels/zoom.md @@ -23,7 +23,7 @@ Status: production-ready plugin for Zoom Team Chat direct messages via Team Chat enabled: true, clientId: "YOUR_CLIENT_ID", clientSecret: "YOUR_CLIENT_SECRET", - botJid: "YOUR_BOT_JID@xmppdev.zoom.us", + botJid: "YOUR_BOT_JID@xmpp.zoom.us", secretToken: "YOUR_SECRET_TOKEN", redirectUri: "https://yourdomain.com/api/zoomapp/auth", dm: { policy: "open" } @@ -98,6 +98,26 @@ Examples: Add to `~/.clawdbot/moltbot.json`: +**Production (default):** +```json5 +{ + channels: { + zoom: { + enabled: true, + clientId: "YOUR_CLIENT_ID", + clientSecret: "YOUR_CLIENT_SECRET", + botJid: "YOUR_BOT_JID@xmpp.zoom.us", + secretToken: "YOUR_SECRET_TOKEN", + redirectUri: "https://yourdomain.com/api/zoomapp/auth", // Must match Zoom app OAuth Redirect URL + dm: { + policy: "open" // open | allowlist | pairing + } + } + } +} +``` + +**Development (optional explicit config):** ```json5 { channels: { @@ -107,11 +127,11 @@ Add to `~/.clawdbot/moltbot.json`: clientSecret: "YOUR_CLIENT_SECRET", botJid: "YOUR_BOT_JID@xmppdev.zoom.us", secretToken: "YOUR_SECRET_TOKEN", - redirectUri: "https://yourdomain.com/api/zoomapp/auth", // Must match Zoom app OAuth Redirect URL - apiHost: "https://zoomdev.us", // Use https://api.zoom.us for production - oauthHost: "https://zoomdev.us", // Use https://zoom.us for production + redirectUri: "https://abc123.ngrok.io/api/zoomapp/auth", + apiHost: "https://zoomdev.us", + oauthHost: "https://zoomdev.us", dm: { - policy: "open" // open | allowlist | pairing + policy: "open" } } } @@ -170,8 +190,8 @@ Bot rejects all DMs. dm: { policy: "allowlist", allowFrom: [ - "user1@xmppdev.zoom.us", - "user2@xmppdev.zoom.us" + "user1@xmpp.zoom.us", + "user2@xmpp.zoom.us" ] } } @@ -182,7 +202,21 @@ Only specified users can message the bot. ### Development vs Production -**Development (zoomdev.us):** +**Production (default):** +```json5 +{ + channels: { + zoom: { + botJid: "bot@xmpp.zoom.us" + // apiHost and oauthHost default to production URLs + // apiHost: "https://api.zoom.us" + // oauthHost: "https://zoom.us" + } + } +} +``` + +**Development:** ```json5 { channels: { @@ -195,19 +229,6 @@ Only specified users can message the bot. } ``` -**Production (zoom.us):** -```json5 -{ - channels: { - zoom: { - apiHost: "https://api.zoom.us", - oauthHost: "https://zoom.us", - botJid: "bot@xmpp.zoom.us" - } - } -} -``` - ## Features - **Direct Messages**: One-on-one conversations