| description | Implement or correct a Zoom WebSocket event stream with connection lifecycle, auth handling, and reconnect behavior. |
|---|
Use this command when the integration needs persistent Zoom event delivery instead of standard webhook callbacks.
- Inspect the repository for existing WebSocket clients, event consumers, connection-state handling, and auth configuration.
- Confirm WebSockets are justified by latency, delivery model, firewall constraints, or connection semantics.
- Identify the event types and app configuration required for the stream.
- Confirm the owning backend or service that will manage connect, heartbeat, reconnect, and shutdown behavior.
Before making changes:
- state the WebSocket event stream being implemented
- list the files that will be changed
- state the auth path and connection lifecycle responsibilities
- state how the connection path will be verified
- Add or correct the WebSocket connection setup at the appropriate service layer.
- Implement authentication, heartbeat, reconnect, backoff, and shutdown handling explicitly.
- Normalize streamed events into the repo’s existing internal event contract where possible.
- Add observability for connection state, reconnects, and dropped or delayed events.
- Keep the first pass focused on one working event stream before layering in broader orchestration.
- Avoid claiming the stream works until the connection lifecycle and event handling path are both checked.
- Re-read the connection manager, auth code, and event handler logic after changes.
- Run local build or tests where available.
- Verify the connect path, reconnect strategy, and event normalization path.
- State any remaining blocker such as app subscription setup, token path, or network constraints.
## Result
- Action: implemented or updated a Zoom WebSocket event stream
- Status: success | partial | failed
- Details: connection path, auth model, event handling, verification run
- Test the stream against real events in a controlled environment.
- If the connection path is healthy but event handling fails, narrow the downstream layer next.
- If HTTP callbacks would be simpler and sufficient, switch to
/setup-zoom-webhooks.