Skip to main content
Plan requirement: Every plan can create IM applications for AI SRE conversations. Using an application for On-call notifications requires an active On-call Professional subscription. Learn more

Overview and architecture comparison

Flashduty offers two distinct Zoom integrations: the Zoom Team Chat app (channel identifier zoom_app, covered on this page) and the legacy Zoom Incoming Webhook bot (channel identifier zoom, documented under Notification). Existing Incoming Webhook bots continue to work unchanged, so you can run both side by side or migrate at your own pace. The Zoom Team Chat integration uses a self-built General App + one-click flashduty-zoom-manifest.json import + automated lifecycle management architecture. It supports both Zoom Global (zoom.us) and Zoom Mainland China (zoom.com.cn), and internal General Apps take effect immediately inside your Zoom organization with no public Marketplace review.
If you only need one-way text messages pushed to a channel, you can still configure the legacy Zoom Incoming Webhook bot under Notification. Choose the Zoom Team Chat app on this page whenever you need interactive incident cards, 1:1 personal DM alerts, automated private war rooms, or conversational AI SRE.

Two-step setup: one-click manifest import and auto-management

When you add a Zoom integration, Flashduty pre-generates a dedicated integration_key and builds a ready-to-import Zoom App Manifest JSON file, so you never have to configure callback URLs, slash commands, or event subscriptions by hand.
1

Create the app

In the Flashduty Console, go to Integration Center → Instant Messaging → Zoom, and click Add:
  1. Click Download Manifest (or Copy JSON). The manifest JSON works across all Zoom regions; switch the toggle to Mainland China (zoom.com.cn) if your organization uses Mainland China Zoom (or click Custom Host for dedicated endpoints).
  2. Click Open Zoom Console, navigate to Develop → Build App → General App, choose Manifest file, and upload flashduty-zoom-manifest.json.
2

Enter credentials and save to authorize

Copy the fields in order from your Zoom app console into Step 2 in Flashduty (for internal self-built apps, copy the matching Development tab credentials throughout — there is no need to switch to Production or submit for public listing):
  • Client ID and Client Secret: Found on Basic Information (Development tab).
  • App ID: Found in your browser URL bar (/develop/applications/{id} — pasting the full URL also works).
  • Secret Token: Found under Features → Access.
  • Bot JID: Found under Features → Surface → Team Chat (formatted like v1...@xmpp.zoom.us, matching the Development tab).
Configure optional features such as Enable War Room or Allow AI to reply proactively, then click Save at the bottom of the page:
  1. Flashduty encrypts and saves your credentials first so the webhook endpoint is immediately ready for Zoom URL validation.
  2. Your browser redirects to the Zoom OAuth consent screen. Sign in with an admin or app-owner account and click Allow to activate the integration.

Automated lifecycle management and drift repair

After initial OAuth completes, the Zoom App & Auto-Management panel on the integration detail page checks your app’s state via the Zoom App Manifest API:
  • Drift detection and one-click self-healing: If someone removes the /fd slash command, edits a webhook URL, or drops a required scope in the Zoom console, the detail page lists the drifted items with a Sync & Repair Configuration button. Clicking it merges the expected Flashduty callbacks, commands, and scopes back into your Zoom app while preserving your custom app name, description, and icon.
  • Zero-console feature upgrades: Enabling features that require extra scopes or event subscriptions (such as proactive replies) updates your Zoom app manifest directly from Flashduty without reopening the Zoom developer console.

Member matching

The Zoom Team Chat integration has no manual Linked Users tab and needs no zoom_jid mapping table. Flashduty matches members automatically by corporate email (case-insensitive):
  • When dispatching a 1:1 personal DM alert or inviting responders into a war room, Flashduty looks up the corresponding Zoom user in your organization using the member’s Flashduty email address.
  • When a responder clicks an action button on a Zoom incident card or messages AI SRE, Flashduty reads the operator’s Zoom email and matches it against members in the current Flashduty account. Make sure each responder’s Zoom email matches their Flashduty email; if no member matches, the bot replies in Zoom explaining the mismatch.

Required and optional permissions

Following least-privilege principles, Flashduty splits Zoom OAuth permissions into required scopes included in the default manifest and optional scopes injected on demand when you enable proactive replies.

Required scopes

The default flashduty-zoom-manifest.json includes the 13 scopes below, covering incident cards, private war rooms, AI SRE conversations, and automated manifest management:

Optional scopes for proactive replies

The two message-reading scopes below are treated as sensitive permissions and excluded from active baseline permissions until you choose to enable Allow AI to reply proactively:
Zero-friction on-demand authorization:
  • Left off on creation (default): OAuth requests only baseline required permissions and excludes channel message-read access.
  • Turned on during creation: Whether you toggle Allow AI to reply proactively before or after downloading the manifest, clicking Save requests the permission in the same single OAuth step and automatically syncs chat_message.sent and chat_message.replied into your Zoom app—no manifest re-upload needed.
  • Turned on later when editing: Toggling Allow AI to reply proactively on and clicking Save automatically updates your Zoom app’s event subscriptions and redirects to Zoom to confirm permission once.

Notifications and automated war rooms

Channel incident App Cards

Navigate to Channel → Escalation Rules, choose Zoom App under group chat notification methods, and select your integration instance. The channel dropdown automatically lists all public channels in your Zoom workspace plus private channels joined by the authorizing admin or by you (no need to manually add a bot member to the channel beforehand). When an incident triggers, Flashduty posts an interactive App Card to the configured channels:
  • In-card actions: Responders can click Acknowledge, Resolve, Snooze, Create War Room, or configured Custom Actions directly on the card, and Flashduty updates the card status in place.
  • Custom templates: Customize the Zoom app card layout in Templates using Go text/template syntax (up to 15,000 bytes per rendered card).

Personal DM alerts and on-call reminders

  • Personal 1:1 incident alerts: Each responder can enable the Zoom app under Personal Settings → Notification Preferences to receive 1:1 interactive incident cards via Zoom direct message.
  • On-call handover reminders: Under Schedule notification settings, select Zoom App to post shift handover summaries to a Zoom channel or send 1:1 shift reminders to incoming on-call responders.

Automated private war rooms and AI root-cause analysis

Under Advanced Features on the Zoom integration page, Enable War Room (war_room_enabled) is off by default until you turn it on manually (only one IM integration per account can have War Room enabled at a time). Automatically start AI incident analysis is a separate toggle (enabled by default, taking effect once War Room is enabled and an active war-room-created automation rule matches):
  • Private channel isolation: Starting a war room from an incident detail page, an alert card button, or an escalation policy creates a Private Zoom Channel by default, invites incident responders in batches by email, and posts the incident summary card.
  • Automated root-cause diagnosis: When both Enable War Room and Automatically start AI incident analysis are on and an active war-room-created automation rule matches the incident, AI SRE immediately investigates the incident context, timeline, and recent changes and posts its initial root-cause findings into the war room. See War room for details.

Conversational AI SRE

With Allow AI SRE conversations in IM enabled (on by default), responders can investigate incidents with AI SRE directly inside Zoom Team Chat. For platform-wide session concepts, see IM platform.

Entry points and streaming cards

  • Channel @Flashduty mentions: Mention @Flashduty with your question in any connected Zoom channel. To include an earlier error message or screenshot from the channel, reply to that message when mentioning @Flashduty.
  • 1:1 direct messages: Open a direct chat with your self-built Flashduty app in Zoom Team Chat for private troubleshooting sessions.
  • Streaming card updates and wide-table rendering: Because Zoom Team Chat bot APIs do not support message reaction receipts, AI SRE immediately posts an analyzing placeholder App Card and updates it in place at throttled intervals until the final answer arrives. When an analysis involves wide tables (more than 4 columns) or a long report, AI SRE prompts guide the model to summarize key rows inline and publish the full report as a clickable artifact link; if a wide table is still emitted inline, the Zoom card renderer falls back to an aligned monospace block while surfacing any links outside the block.

/fd_<suffix> slash commands

Importing the manifest pre-fills a suggested slash command prefix derived from your integration_key (formatted as /fd_<6chars>, for example /fd_1a2b3c; if it collides with an existing Zoom command, you can customize it in the Zoom console). Use it in Zoom channels or 1:1 bot DMs to ask AI SRE questions or manage your session: In channels where proactive replies are enabled on the integration, you can also send /ambient on, /ambient off, /ambient inherit, or /ambient status to control proactive replies for that specific channel.

Thread reply isolation vs. channel replies

  • AI SRE uses thread replies in regular group chats (on by default): When enabled, AI SRE populates both outbound threading fields (reply_to and reply_main_message_id) when posting replies so messages stay inside the thread, and resolves inbound thread replies from Zoom’s parent_msg_id / reply_main_message_id webhook fields to bind each thread to its own isolated session (group_thread). Turning this switch off posts replies to the main channel stream using a shared channel session (group_chat). War room channels always reply directly in the channel.
  • Allow AI to reply proactively (off by default): Plain (unmentioned) channel messages are buffered only when this toggle is enabled and the optional scopes for proactive replies have been granted. While enabled, Flashduty maintains a rolling buffer of up to 30 messages within 24 hours per channel and replies only when the triage judge determines AI assistance is warranted; when turned off, plain channel messages are neither buffered nor replied to proactively.

Self-hosted deployment notes

Self-hosted Flashduty deployments use the exact same one-click manifest import and auto-management workflow as SaaS:
  1. Ensure your Flashduty console domain (for example, https://console.example.com) and event gateway domain (for example, https://api.example.com) are reachable by Zoom over HTTPS for webhook delivery and signature validation, and configure the Zoom plugin’s event_url (in t_data_source_plugin.settings) or your deployment’s event gateway setting to point to your private event gateway rather than the SaaS default.
  2. When you add a Zoom integration in the console and download flashduty-zoom-manifest.json, Flashduty resolves the webhook URL (.../event/push/zoom_app/data?integration_key=<key>) in priority order from the Zoom plugin event_url setting and your deployment event gateway setting (falling back to the default template), and resolves the OAuth redirect URL (https://console.example.com/settings/source/im/add/zoom_app) from the console/integration redirect URI, deploy.zoomRedirectURI, and deployment host. Verify both URLs point to your private domains before importing the manifest.
If you want to configure optional deployment-wide fallback credentials (used only when an integration omits per-datasource credentials), you can set the fields below under deploy in fc-datasource and fc-event YAML files (etc/*.yaml) or via ZOOM_CLIENT_ID, ZOOM_CLIENT_SECRET, ZOOM_SECRET_TOKEN, ZOOM_BOT_JID, and ZOOM_REDIRECT_URI:

FAQ

Select the region that matches where your organization signs in to Zoom. If your Zoom tenant runs on zoom.com.cn, choose Zoom Mainland China (zoom.com.cn) in Step 1 so Flashduty sets the API endpoint to https://api.zoom.com.cn, sets OAuth to https://zoom.com.cn, and links you to marketplace.zoom.com.cn to import the manifest.
  • Confirm that the Zoom integration has completed OAuth authorization and is enabled
  • All public channels appear automatically; for a private channel, make sure either you (with matching Zoom and Flashduty email) or the authorizing Zoom admin is a member of that private channel
  • Return to the escalation rule or schedule form in Flashduty and click the refresh icon next to the channel selector (server-side channel lists are cached for 5 minutes and refresh immediately when requested)
The Zoom Team Chat integration identifies responders by email address. Verify that the email address on your Zoom account matches your email in Flashduty Member Management (case-insensitive). Once they match, card actions work immediately with no manual account linking.
The baseline manifest omits sensitive channel message-reading scopes (team_chat:read:user_message:admin and team_chat:read:list_user_messages:admin). When you enable the toggle and click Save, Flashduty automatically writes those scopes and message event subscriptions to your internal Zoom app and redirects to Zoom to confirm incremental authorization—with no manual manifest edits.
  • Only one IM integration in an account can have War Room enabled at a time; turn War Room off in the other IM integration first. See War room
  • If configuration drift or missing scopes are detected, click Sync & Repair Configuration on the integration detail page and re-authorize if prompted