Build Zoom Team Chat App

From the author

Use when building Team Chat.

— the description by Zoom

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a systematic approach to building applications for Zoom Team Chat. It guides developers through selecting the appropriate API surface, configuring app settings, modeling message structures, and implementing secure authentication and webhook handling. It covers the lifecycle of building both user-scoped messaging integrations and interactive chatbot workflows.

What it does

Helps select between Team Chat API and Chatbot API based on integration requirements.
Outlines the configuration of app types, scopes, and role enablement.
Provides guidance on modeling message structures including rich cards, forms, and slash commands.
Details the implementation of OAuth flows and token management.
Supports the setup of webhook handlers with signature verification.
Assists in debugging common issues related to JID formats, channel membership, and payload shapes.

When to use it

When you need to integrate custom messaging or automation into Zoom Team Chat.
When designing interactive chatbot workflows with buttons, forms, or dropdowns.
When setting up OAuth authentication for Zoom-based applications.
When troubleshooting connectivity or message delivery issues in a Zoom integration.

Advantages

Provides a clear, step-by-step path for Zoom app development.
Ensures security best practices like signature verification are prioritized.
Helps avoid common pitfalls in API selection and message formatting.
Centralizes references for environment variables and API endpoints.

Usage examples

“How do I start building a chatbot for Zoom Team Chat?”: The agent will guide you through choosing the Chatbot API, configuring the bot identity, and setting up the necessary OAuth and webhook infrastructure.
“I am getting an invalid access token error when sending messages.”: The agent will help you verify your app type, check if the required scopes are enabled, and confirm if the user has re-consented after recent scope changes.

Install

Download the skill as a ZIP:
https://autogineer.com/agent-skills/openai/build-zoom-team-chat-app/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip build-zoom-team-chat-app.zip -d .agents/skills

Documentation by Zoom

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

Choose the API surface: Team Chat API for user-scoped actions, Chatbot API for bot identity and chatbot workflows.
Confirm app type, scopes, role enablement, and whether the account has Zoom for Developers enabled.
Model message structure before coding: plain messages, rich cards, buttons, dropdowns, forms, slash commands, and threaded replies.
Implement OAuth and token refresh separately from message sending, with clear storage boundaries.
Add webhook handlers for interactivity and lifecycle events with signature verification and retry-safe processing.
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
API selection: concepts/api-selection.md
Message structure: concepts/message-structure.md
Message cards: references/message-cards.md
Scopes: references/scopes.md
Chatbot setup: examples/chatbot-setup.md
Common issues: troubleshooting/common-issues.md

Files

ATTRIBUTION.mdAdded by AutoGineer880 B
LICENSELicence file added by AutoGineer1.1 KiB
RUNBOOK.md2.7 KiB
SKILL.md1.5 KiB
agents/openai.yaml145 B
concepts/api-selection.md7.3 KiB
concepts/authentication.md1.4 KiB
concepts/deployment.md719 B
concepts/environment-setup.md8.8 KiB
concepts/message-structure.md675 B
concepts/security.md478 B
concepts/webhooks.md11.8 KiB
examples/button-actions.md393 B
examples/channel-management.md320 B
examples/chatbot-setup.md12.2 KiB
examples/database-integration.md312 B
examples/dropdown-selects.md304 B
examples/form-submissions.md385 B
examples/llm-integration.md532 B
examples/multi-step-workflows.md300 B
examples/oauth-setup.md1.6 KiB
examples/scheduled-alerts.md352 B
examples/send-message.md417 B
examples/slash-commands.md509 B
examples/token-management.md442 B
get-started.md1.6 KiB
references/api-reference.md538 B
references/environment-variables.md1006 B
references/error-codes.md448 B
references/full-guide.md22.9 KiB
references/jid-formats.md247 B
references/message-cards.md6.6 KiB
references/rate-limits.md205 B
references/sample-comparison.md1.1 KiB
references/samples.md14.2 KiB
references/scopes.md340 B
references/webhook-events.md564 B
troubleshooting/common-issues.md9.7 KiB
troubleshooting/deployment-issues.md641 B
troubleshooting/message-issues.md317 B
troubleshooting/oauth-issues.md882 B
troubleshooting/webhook-issues.md364 B

concepts/authentication.md

Authentication Flows (Team Chat vs Chatbot)

Zoom Team Chat integrations commonly use one of two auth models:

Team Chat API (user-level)

Use User OAuth (authorization code) when you want messages/actions to appear as a user.

Typical endpoints:
- Send message (as the user): POST /v2/chat/users/me/messages
Typical scopes:
- chat_message:write
- chat_channel:read (for listing channels)

Chatbot API (bot-level)

Use client credentials when you want messages/actions to appear as a bot.

Typical endpoint:
- Send bot message: POST /v2/im/chat/messages
Typical “scope”:
- imchat:bot (added by enabling Chatbot feature on the app)

Decision Checklist

If you need to post to a channel “as a bot” and handle slash command interactions: use Chatbot API.
If you need to post “as the user” (and respect the user’s channel membership): use Team Chat API.

Common Pitfalls

Server-to-Server OAuth is not a fit for Zoom Team Chat chatbot features.
Team Chat API calls require a user token with the right scopes; “invalid access token” errors are almost always missing scopes or wrong app type.
OAuth URL split is easy to mix up:
- authorize step: https://zoom.us/oauth/authorize
- token step (all grant types): https://zoom.us/oauth/token
In browser demos, complete OAuth end-to-end in app (state verify -> callback -> code exchange -> token store) to avoid copy/paste mistakes.

Requirements and compatibility

Written for: OpenAI Codex

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

What our scanner noticed· Medium risk

Possible data-exfiltration endpoints
Instructions that use the network

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Implement Spec
Matt Pocock· Community
A workflow for implementing technical specifications and tickets using concurrent subagents.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
MCP Builder
AnthropicOfficial
A comprehensive guide for building high-quality Model Context Protocol (MCP) servers to integrate external services with LLMs.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0Low riskHas scriptsGitHub stars of the source repository188.6k
Schema
Corey Haines· Community
Expert guidance for implementing and optimizing JSON-LD schema markup to improve search engine content understanding.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository59k
Postgresql Table Design
Seth Hobson· Community
A comprehensive guide for designing, reviewing, and optimizing PostgreSQL database schemas.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
SQL Optimization Patterns
Seth Hobson· Community
A comprehensive guide to optimizing SQL database performance through indexing, query plan analysis, and efficient coding patterns.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
API Scaffolding Fastapi Pro
Seth Hobson· Community
An expert FastAPI developer focused on high-performance, async-first API architecture and production-ready microservices.
Software developmentClaude Code
MITGitHub stars of the source repository42.3k

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download build-zoom-team-chat-app.zip