setup-zoom-websockets — команда для Codex: что делает и как установить
Команда помогает развернуть надёжный приём событий Zoom через постоянное WebSocket-подключение вместо стандартных вебхуков.
~/.codex/prompts/setup-zoom-websockets.mdЧто делает setup-zoom-websockets
Команда формирует чёткий план и направляет агента при создании клиента Zoom WebSocket. Сначала проверяются требования к сетевым задержкам и файрволу, чтобы подтвердить необходимость сокетов. Затем агент фиксирует список файлов и сервис, который будет управлять жизненным циклом соединения.
В коде пошагово реализуются проверка пульса (heartbeat), повторное подключение с задержкой (backoff) и штатное отключение. Входящие события нормализуются под внутренний контракт проекта, а в сервис добавляется логирование разрывов связи и потерянных сообщений.
Если постоянный поток событий не критичен, а входящие порты открыты, лучше остаться на стандартных HTTP-колбэках через команду /setup-zoom-webhooks. Запускать стрим без явной проверки сценариев переподключения нельзя.
Какие задачи решает
- перейти с обычных вебхуков на постоянный стрим событий Zoom
- настроить heartbeat и переподключение для сокет-клиента
- нормализовать входящие события Zoom под внутренние контракты
- добавить метрики сетевых разрывов и задержанных сообщений
Примеры запросов агенту
- Реализуй подключение к Zoom WebSocket для сервиса встреч по шагам setup-zoom-websockets
- Проверь обработку reconnect и backoff в клиенте Zoom WebSocket
- Настрой нормализацию входящих событий Zoom и завершение соединения при shutdown
Как установить setup-zoom-websockets
Вручную: положить файлы
~/.codex/prompts/setup-zoom-websockets.mdВызов — /prompts:setup-zoom-websockets. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.claude/commands/setup-zoom-websockets.mdВызов — /setup-zoom-websockets. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
.github/prompts/setup-zoom-websockets.prompt.mdВручную: положить файлы
.gemini/commands/setup-zoom-websockets.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о setup-zoom-websockets
Как установить setup-zoom-websockets в Codex?
Сохраните файл команды по пути ~/.codex/prompts/setup-zoom-websockets.md. После этого промпт станет доступен в сессиях Codex.
Что делает команда setup-zoom-websockets?
Она ведёт агента через аудит репозитория, планирование и реализацию постоянного соединения с Zoom. Команда контролирует логику авторизации, heartbeat, повторные попытки подключения и парсинг событий.
Когда лучше выбрать вебхуки вместо WebSockets?
Если интеграции не нужны минимальные сетевые задержки и нет строгих ограничений файрвола, стандартные вебхуки проще в поддержке. В такой ситуации автор рекомендует переключиться на команду /setup-zoom-webhooks.
Исходный текст
setup-zoom-websockets.md · MIT
--- description: Implement or correct a Zoom WebSocket event stream with connection lifecycle, auth handling, and reconnect behavior. --- # Setup Zoom WebSockets Use this command when the integration needs persistent Zoom event delivery instead of standard webhook callbacks. ## Preflight 1. Inspect the repository for existing WebSocket clients, event consumers, connection-state handling, and auth configuration. 2. Confirm WebSockets are justified by latency, delivery model, firewall constraints, or connection semantics. 3. Identify the event types and app configuration required for the stream. 4. Confirm the owning backend or service that will manage connect, heartbeat, reconnect, and shutdown behavior. ## Plan 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 ## Commands 1. Add or correct the WebSocket connection setup at the appropriate service layer. 2. Implement authentication, heartbeat, reconnect, backoff, and shutdown handling explicitly. 3. Normalize streamed events into the repo’s existing internal event contract where possible. 4. Add observability for connection state, reconnects, and dropped or delayed events. 5. Keep the first pass focused on one working event stream before layering in broader orchestration. 6. Avoid claiming the stream works until the connection lifecycle and event handling path are both checked. ## Verification 1. Re-read the connection manager, auth code, and event handler logic after changes. 2. Run local build or tests where available. 3. Verify the connect path, reconnect strategy, and event normalization path. 4. State any remaining blocker such as app subscription setup, token path, or network constraints. ## Summary ```text ## Result - Action: implemented or updated a Zoom WebSocket event stream - Status: success | partial | failed - Details: connection path, auth model, event handling, verification run ``` ## Next Steps - 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`.
© Zoom · MIT · openai/plugins