build-zoom-team-chat-app · openai — Codex skill: what it does, how to install
Guides development for Zoom Team Chat apps and bots. It outlines API choice, message-card design, OAuth token handling, and webhook verification.
npx skills add openai/plugins --skill team-chat -a codexWhat build-zoom-team-chat-app does
This skill guides you through creating Zoom Team Chat integrations. It starts by separating user-scoped operations via the Team Chat API from dedicated bot identities using the Chatbot API. The skill prompts you to model payloads before writing application code. That covers plain text, rich cards, forms, dropdowns, buttons, and slash commands.
Authentication logic stays separated from message delivery. You handle OAuth handshakes and token refreshes in an isolated storage layer. Incoming webhooks require request signature validation and retry-safe event processing. Without Zoom for Developers enabled on your Zoom account, app creation cannot proceed. Debugging steps cover JID formats, channel memberships, scopes, and card schemas.
What it helps with
- select between Team Chat API and Chatbot API for a project
- structure interactive message cards with buttons and dropdowns
- separate OAuth token refreshes from message delivery code
- verify webhook signatures with retry-safe event handlers
- diagnose errors in JID formatting, channel access, and scopes
Example prompts for the agent
- Help me build an interactive message card with dropdowns for Zoom Team Chat
- Set up a webhook listener with signature verification for Zoom chat events
- Configure OAuth storage and token refresh routines for the Zoom Chatbot API
How to install build-zoom-team-chat-app
1Skills CLI (Vercel)
npx skills add openai/plugins --skill team-chat -a codex2Manually: put the files in place
.agents/skills/team-chat/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill team-chat -a claude-code2Manually: put the files in place
~/.claude/skills/team-chat/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/team-chat/
Manually: put the files in place
.cursor/skills/team-chat/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins team-chat2Manually: put the files in place
.github/skills/team-chat/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/zoom/skills/team-chatManually: put the files in place
.devin/skills/team-chat/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: Codex skills: how to install, where they live, how to call them
Questions about build-zoom-team-chat-app
How to install build-zoom-team-chat-app in Codex?
Run npx skills add openai/plugins --skill team-chat -a codex in your terminal. Codex places the file at .agents/skills/team-chat/SKILL.md.
What does the build-zoom-team-chat-app skill do?
It walks developers through building Zoom Team Chat bots and integrations, covering API surface selection, UI cards, OAuth, and webhooks.
When should I use Chatbot API instead of Team Chat API?
Use the Chatbot API when your integration needs its own bot identity and standalone chatbot workflows. The Team Chat API handles actions scoped to regular users.
Source text
SKILL.md · MIT
--- name: build-zoom-team-chat-app description: Use when building Team Chat. --- # Build Zoom Team Chat App Use this skill when the target surface is Zoom Team Chat. First decide whether the integration is user-scoped messaging, a chatbot, an interactive message-card workflow, or a webhook-driven automation. ## Workflow 1. Choose the API surface: Team Chat API for user-scoped actions, Chatbot API for bot identity and chatbot workflows. 2. Confirm app type, scopes, role enablement, and whether the account has Zoom for Developers enabled. 3. Model message structure before coding: plain messages, rich cards, buttons, dropdowns, forms, slash commands, and threaded replies. 4. Implement OAuth and token refresh separately from message sending, with clear storage boundaries. 5. Add webhook handlers for interactivity and lifecycle events with signature verification and retry-safe processing. 6. Debug by checking JID formats, channel membership, bot installation, scopes, role settings, and message-card payload shape. ## References - Full preserved guide: [references/full-guide.md](references/full-guide.md) - API selection: [concepts/api-selection.md](concepts/api-selection.md) - Message structure: [concepts/message-structure.md](concepts/message-structure.md) - Message cards: [references/message-cards.md](references/message-cards.md) - Scopes: [references/scopes.md](references/scopes.md) - Chatbot setup: [examples/chatbot-setup.md](examples/chatbot-setup.md) - Common issues: [troubleshooting/common-issues.md](troubleshooting/common-issues.md)
© Zoom · MIT · openai/plugins
Similar skills
All skills for Backend and APIs →build-zoom-team-chat-app by other authors comes first.
