build-zoom-team-chat-app

Build Zoom Team Chat App is a large reference skill (38 files) for building Zoom Team Chat integrations, from user-scoped messaging to interactive chatbots with rich cards, buttons, dropdowns, slash commands, and webhooks. Its central problem is that Team Chat has two non-interchangeable integration types, and choosing the wrong one early causes cascading auth, scope, and endpoint mismatches. The skill makes that decision explicit up front and then guides the full build.

It clearly distinguishes the Team Chat API (user type, User OAuth authorization_code flow, `/v2/chat/users/...` endpoints, messages as a real user) from the Chatbot API (bot type, Client Credentials grant, `/v2/im/chat/messages`, messages as the bot with rich cards). Bundled material covers environment setup, credential and scope configuration, OAuth flows, sending messages, message-card components, webhook events and verification, rate limits, error codes, JID formats, database integration, LLM integration, and troubleshooting guides for OAuth, webhooks, messages, and deployment. Setup docs walk through creating a General App (explicitly not Server-to-Server OAuth), configuring redirect URLs, obtaining Client ID/Secret/Account ID/Bot JID, and populating a `.env` file, which is standard, security-conscious credential setup.

It targets developers building Zoom notifications, user-automation, or interactive chatbots. Use cases range from CI/CD notifications via the Team Chat API to fully interactive bots handling button clicks, form submissions, and slash commands. Prerequisites include a Zoom account with an appropriate developer role and a marketplace app. This is documentation and code-pattern guidance grounded in official Zoom docs.