Setup Zoom Websockets

From the author

Use when building Zoom WebSockets.

— the description by Zoom

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured approach to integrating Zoom WebSockets for real-time event streaming. It covers the full connection lifecycle, including Server-to-Server OAuth authentication, token management, heartbeat implementation, and reconnection strategies. It is intended for developers who require persistent event delivery rather than standard HTTP webhook callbacks.

What it does

Provides steps for configuring Zoom event subscriptions for WebSockets.
Details the authentication flow using Server-to-Server OAuth tokens.
Outlines implementation patterns for connection heartbeats and keep-alive pings.
Defines strategies for handling disconnections and implementing exponential backoff.
Lists required environment variables for managing Zoom app credentials and subscription IDs.
Offers guidance on observability and debugging common connection issues.

When to use it

When your application requires persistent event delivery from Zoom.
When you need to manage real-time event streams outside of standard HTTP webhook patterns.
When building custom integration logic that requires manual connection state management.

Advantages

Provides a clear lifecycle model for managing persistent WebSocket connections.
Includes code patterns for token refresh and heartbeat maintenance.
Centralizes configuration requirements for Zoom OAuth and subscription IDs.
Offers a structured approach to troubleshooting connection and authentication failures.

Usage examples

“How do I authenticate a Zoom WebSocket connection?”: The skill explains how to generate a Server-to-Server OAuth access token using your account ID, client ID, and client secret to authorize the WebSocket connection.
“How can I keep my Zoom WebSocket connection alive?”: The skill provides a heartbeat implementation pattern using periodic ping/pong messages to maintain the connection state.

Install

Download the skill as a ZIP:
https://autogineer.com/agent-skills/openai/setup-zoom-websockets/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip setup-zoom-websockets.zip -d .agents/skills

Documentation by Zoom

Use this skill when the integration needs persistent Zoom event delivery instead of HTTP webhook callbacks. If normal webhook retries and delivery are enough, prefer setup-zoom-webhooks.

Workflow

Confirm WebSockets are justified by latency, firewall, connection model, or deployment constraints.
Configure the app and event subscriptions for the required event stream.
Implement connection setup, authentication, heartbeat, reconnect, backoff, and shutdown handling.
Normalize events into the same internal contract used by webhook handlers when both are supported.
Add observability for connection state, reconnect count, event lag, and dropped messages.
Debug by isolating token/auth problems, app subscription settings, network proxies, TLS interception, and reconnect loops.

References

Full preserved guide: references/full-guide.md
Connection: references/connection.md
Events: references/events.md
Common issues: troubleshooting/common-issues.md

Files

ATTRIBUTION.mdAdded by AutoGineer878 B
LICENSELicence file added by AutoGineer1.1 KiB
RUNBOOK.md2.9 KiB
SKILL.md1.2 KiB
agents/openai.yaml148 B
references/connection.md10.2 KiB
references/environment-variables.md827 B
references/events.md10.5 KiB
references/full-guide.md7.0 KiB
troubleshooting/common-issues.md1.1 KiB

SKILL.md