Серверная часть на Zoom Rivet SDK
Справочник по Zoom Rivet SDK: готовый серверный каркас на Node.js с авторизацией Zoom, приёмом вебхуков и обёртками над API.
- Что делает
- Справочник по Zoom Rivet SDK: готовый серверный каркас на Node.js с авторизацией Zoom, приёмом вебхуков и обёртками над API.
- Когда брать
- Когда нужен сервер на Node.js, который объединяет авторизацию Zoom, события вебхуков и вызовы API с минимумом кода.
- Когда не брать
- Если нужны только прямые вызовы REST API из существующего бэкенда или встраивание Meeting SDK и Video SDK в клиент.
- Пример запроса
- Сделай сервер на Node.js, который принимает события вебхуков Zoom и отвечает в Team Chat.
- Нужно подключить
- терминал, Node.js
Входит в плагин zoom-plugin. В Cowork и Claude Code можно поставить плагин целиком.
Как включить
- Скачайте архив и распакуйте его.
- Положите папку
rivet-sdkв~/.claude/skills/. - Откройте Claude Code и опишите задачу своими словами: Claude подхватит скилл по описанию.
Текст
---
name: rivet-sdk
description: "Справочный скилл по Zoom Rivet SDK. Используй после выбора серверного процесса на базе Rivet при реализации обработки авторизации, потребителей вебхуков, обёрток над API, композиции из нескольких модулей и шаблонов приёмника для Lambda."
user-invocable: false
triggers:
- "rivet"
- "zoom rivet"
- "@zoom/rivet"
- "rivet javascript"
- "rivet sdk"
- "rivet webhook"
- "rivet oauth"
- "rivet lambda"
- "rivet team chat"
- "rivet chatbot"
---
Zoom Rivet SDK
Справочный материал по Zoom Rivet как серверному фреймворку на JavaScript и TypeScript для интеграций с Zoom.
Рекомендации по реализации с Zoom Rivet (JavaScript/TypeScript) как серверным фреймворком для:
- OAuth и работы с токенами
- Приёма событий вебхуков
- Типизированных обёрток над конечными точками REST API
- Композиции серверных модулей
Официальная документация:
- https://developers.zoom.us/docs/rivet/
- https://developers.zoom.us/docs/rivet/javascript/
- https://zoom.github.io/rivet-javascript/
Примеры-образцы:
- https://github.com/zoom/rivet-javascript-sample
- https://github.com/zoom/isv-rivet-starter
- https://github.com/zoom/Rivet-Server-Sample
- https://github.com/zoom/rivet-javascript
Ограничитель маршрутизации
- Rivet SDK — фреймворк на Node.js, который объединяет обработку авторизации Zoom, приёмники вебхуков и типизированные обёртки над API.
- Rivet рекомендуется для быстрого создания каркаса сервера, но не обязателен.
- В начале планирования уточни предпочтение:
Нужен ли вам Rivet SDK или прямой OAuth + REST без Rivet?- Используй Rivet, когда пользователю нужен сервер на Node.js, который объединяет авторизацию Zoom, вебхуки и вызовы API с минимумом связующего кода.
- Если пользователю нужны только прямые вызовы API из уже существующего бэкенда, соединяй с [../rest-api/SKILL.md](../rest-api/SKILL.md).
- Если пользователь занят поведением карточек и команд приложения Zoom Team Chat, соединяй с [../team-chat/SKILL.md](../team-chat/SKILL.md).
- Если пользователю нужно встраивание SDK (клиентская среда выполнения Meeting SDK или Video SDK), направляй в [../meeting-sdk/SKILL.md](../meeting-sdk/SKILL.md) или [../video-sdk/SKILL.md](../video-sdk/SKILL.md).
Быстрые ссылки
Начни здесь:
- [concepts/architecture-and-lifecycle.md](concepts/architecture-and-lifecycle.md)
- [scenarios/high-level-scenarios.md](scenarios/high-level-scenarios.md)
- [examples/getting-started-pattern.md](examples/getting-started-pattern.md)
- [examples/multi-client-pattern.md](examples/multi-client-pattern.md)
- [references/rivet-reference-map.md](references/rivet-reference-map.md)
- [references/versioning-and-compatibility.md](references/versioning-and-compatibility.md)
- [references/samples-validation.md](references/samples-validation.md)
- [references/source-map.md](references/source-map.md)
- [references/environment-variables.md](references/environment-variables.md)
- [troubleshooting/common-issues.md](troubleshooting/common-issues.md)
- [RUNBOOK.md](RUNBOOK.md)
- [rivet-sdk.md](rivet-sdk.md)
Типовой жизненный цикл
- Выбери модули и модель авторизации для каждого модуля (Client Credentials, User OAuth, S2S OAuth, Video SDK JWT).
- Создай экземпляры клиентов с учётными данными, секретом вебхука и портом для каждого модуля.
- Зарегистрируй обработчики событий (
webEventConsumer.event(...)или сокращённые варианты). - Реализуй вызовы API через
client.endpoints.*. - Запусти приёмники и открой для Zoom конечные точки вебхуков (
/zoom/events). - Сохраняй токены и состояние для рабочих нагрузок с OAuth и обязательно проверяй подпись.
- Следи за сбоями отдельных модулей и меняй секреты и версию в соответствии с журналом изменений.
Сценарии верхнего уровня
- Бот со слэш-командами для Team Chat плюс обогащение данными из API данных Team Chat.
- Бэкенд из нескольких модулей (Users + Meetings + Team Chat + Phone) в одном процессе.
- Бэкенд телеметрии Video SDK на потоке событий модуля
videosdkи поверхностях API. - Слой оркестрации для независимого поставщика ПО (ISV) с хранением токенов с учётом клиентских организаций и вебхуками для каждого модуля.
- Обработчик вебхуков в AWS Lambda на
AwsLambdaReceiverиз Rivet.
Подробности — в [scenarios/high-level-scenarios.md](scenarios/high-level-scenarios.md).
Связки с другими скиллами
- Архитектура OAuth и выбор типа доступа (grant): [../oauth/SKILL.md](../oauth/SKILL.md)
- Семантика конечных точек API и детали полезной нагрузки запросов: [../rest-api/SKILL.md](../rest-api/SKILL.md)
- Карточки приложений Team Chat, команды и интерфейс бота: [../team-chat/SKILL.md](../team-chat/SKILL.md)
- Особенности API Video SDK и контекст BYOS: [../video-sdk/SKILL.md](../video-sdk/SKILL.md)
Переменные окружения
- Стандартные ключи
.envи то, где найти каждое значение, — в [references/environment-variables.md](references/environment-variables.md).
Эксплуатация
- [RUNBOOK.md](RUNBOOK.md) — пятиминутный чек-лист предварительной проверки и отладки.
Перевод: iiuniversitet. Оригинал: https://github.com/anthropics/knowledge-work-plugins/tree/main/partner-built/zoom-plugin/skills/rivet-sdk, лицензия MIT. Изменения: перевод на русский язык.
Оригинал на английском
--- name: rivet-sdk description: "Reference skill for Zoom Rivet SDK. Use after routing to a Rivet-based server workflow when implementing auth handling, webhook consumers, API wrappers, multi-module composition, or Lambda receiver patterns." user-invocable: false triggers: - "rivet" - "zoom rivet" - "@zoom/rivet" - "rivet javascript" - "rivet sdk" - "rivet webhook" - "rivet oauth" - "rivet lambda" - "rivet team chat" - "rivet chatbot" --- # Zoom Rivet SDK Background reference for Zoom Rivet as a JavaScript and TypeScript server framework for Zoom integrations. Implementation guidance for Zoom Rivet (JavaScript/TypeScript) as a server-side framework for: - OAuth and token handling - Webhook event consumption - Typed REST API endpoint wrappers - Multi-module server composition Official docs: - https://developers.zoom.us/docs/rivet/ - https://developers.zoom.us/docs/rivet/javascript/ - https://zoom.github.io/rivet-javascript/ Reference samples: - https://github.com/zoom/rivet-javascript-sample - https://github.com/zoom/isv-rivet-starter - https://github.com/zoom/Rivet-Server-Sample - https://github.com/zoom/rivet-javascript ## Routing Guardrail - Rivet SDK is a Node.js framework that bundles Zoom auth handling, webhook receivers, and typed API wrappers. - Rivet is recommended for faster server-side scaffolding, but it is not mandatory. - At planning start, confirm preference: - `Do you want Rivet SDK, or direct OAuth + REST without Rivet?` - Use Rivet when the user wants a Node.js server that combines Zoom auth + webhooks + API calls with minimal glue code. - If the user only needs direct API calls from an existing backend, chain with [../rest-api/SKILL.md](../rest-api/SKILL.md). - If the user is focused on Zoom Team Chat app cards/commands behavior, chain with [../team-chat/SKILL.md](../team-chat/SKILL.md). - If the user needs SDK embed (Meeting SDK/Video SDK client runtime), route to [../meeting-sdk/SKILL.md](../meeting-sdk/SKILL.md) or [../video-sdk/SKILL.md](../video-sdk/SKILL.md). ## Quick Links Start here: 1. [concepts/architecture-and-lifecycle.md](concepts/architecture-and-lifecycle.md) 2. [scenarios/high-level-scenarios.md](scenarios/high-level-scenarios.md) 3. [examples/getting-started-pattern.md](examples/getting-started-pattern.md) 4. [examples/multi-client-pattern.md](examples/multi-client-pattern.md) 5. [references/rivet-reference-map.md](references/rivet-reference-map.md) 6. [references/versioning-and-compatibility.md](references/versioning-and-compatibility.md) 7. [references/samples-validation.md](references/samples-validation.md) 8. [references/source-map.md](references/source-map.md) 9. [references/environment-variables.md](references/environment-variables.md) 10. [troubleshooting/common-issues.md](troubleshooting/common-issues.md) 11. [RUNBOOK.md](RUNBOOK.md) 12. [rivet-sdk.md](rivet-sdk.md) ## Common Lifecycle Pattern 1. Choose modules and auth model per module (Client Credentials, User OAuth, S2S OAuth, Video SDK JWT). 2. Instantiate client(s) with credentials, webhook secret, and per-module port. 3. Register event handlers (`webEventConsumer.event(...)` or shortcuts). 4. Implement API calls through `client.endpoints.*`. 5. Start receiver(s) and expose webhook endpoint(s) (`/zoom/events`) to Zoom. 6. Persist tokens/state for OAuth workloads and enforce signature verification. 7. Monitor module-specific failures and rotate secrets/version with changelog cadence. ## High-Level Scenarios - Team Chat slash-command bot + Team Chat data API enrichment. - Multi-module backend (Users + Meetings + Team Chat + Phone) sharing one process. - Video SDK telemetry backend using `videosdk` module event stream + API surfaces. - ISV orchestration layer with tenant-aware token storage and per-module webhooks. - AWS Lambda webhook processor with Rivet `AwsLambdaReceiver`. See [scenarios/high-level-scenarios.md](scenarios/high-level-scenarios.md) for details. ## Chaining - OAuth architecture and grant selection: [../oauth/SKILL.md](../oauth/SKILL.md) - API endpoint semantics and request payload details: [../rest-api/SKILL.md](../rest-api/SKILL.md) - Team Chat app cards, command and bot UX: [../team-chat/SKILL.md](../team-chat/SKILL.md) - Video SDK API-specific behavior and BYOS context: [../video-sdk/SKILL.md](../video-sdk/SKILL.md) ## Environment Variables - See [references/environment-variables.md](references/environment-variables.md) for standardized `.env` keys and where to find each value. ## Operations - [RUNBOOK.md](RUNBOOK.md) - 5-minute preflight and debugging checklist.
Источник: anthropics/knowledge-work-plugins / zoom-plugin / rivet-sdk ↗. Ссылка проверена 2026-10-10.