Generated banner for Build Zoom Contact Center App
Generated logo for Build Zoom Contact Center App

Build Zoom Contact Center App

OpenAIOfficialCreated by ZoomDistributed by OpenAI

  • Skill
  • Tool integration
  • Automation and integrations
  • MIT
  • No issues found

From the author

Use when using Contact Center.
— 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 Contact Center. It emphasizes identifying the correct client surface (web, mobile, or embed) and managing the engagement lifecycle, from initialization to cleanup. It helps developers navigate platform-specific SDKs, handle engagement context, and troubleshoot common integration issues like version drift, authentication errors, and event handling gaps.

What it does

  • Guides the selection of the appropriate SDK based on the target platform.
  • Defines the standard lifecycle stages for Contact Center engagements.
  • Provides a checklist for troubleshooting common integration and authentication failures.
  • Outlines best practices for managing engagement context across CRM and analytics systems.
  • Offers guidance on handling event listeners and state transitions.

When to use it

  • When building custom integrations for Zoom Contact Center.
  • When debugging issues with SDK events or lifecycle hooks.
  • When setting up environment variables for OAuth and campaign-based integrations.
  • When resolving 401 errors or token scope issues in Contact Center APIs.
  • When implementing web embeds or campaign-based chat/video flows.

Advantages

  • Reduces development friction by clarifying platform-specific requirements.
  • Provides a clear path for debugging complex state-change and event-gap issues.
  • Ensures consistent handling of sensitive OAuth and API credentials.
  • Helps align development efforts with documented SDK patterns.

Usage examples

“How do I start building a web-based Zoom Contact Center integration?”
The agent will guide you through identifying your channel, setting up the required environment variables like ZCC_WEB_API_KEY, and selecting the appropriate Web SDK lifecycle hooks.
“My Contact Center API calls are returning 401 errors, what should I check?”
The agent will provide a troubleshooting checklist, including verifying Contact Center scopes on your token, confirming admin permissions, and checking for account context drift.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/openai/build-zoom-contact-center-app/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip build-zoom-contact-center-app.zip -d .agents/skills

Documentation by Zoom

Build Zoom Contact Center App

Use this skill when the integration targets Zoom Contact Center rather than general meetings, chat, or phone. Route to the platform-specific skill once the client surface is clear.

Workflow

  1. Identify the channel and client: web, Android, iOS, campaign embed, video engagement, chat engagement, Virtual Agent handoff, or scheduled callback.

  2. Confirm the lifecycle: initialization, engagement start, context retrieval, state changes, transfer or handoff, and cleanup.

  3. Choose the platform reference before coding; Contact Center SDKs differ by event names, lifecycle hooks, and wrapper requirements.

  4. Treat engagement context as shared state and validate how it flows into CRM, ticketing, analytics, or AI workflows.

  5. Debug version drift by checking SDK version, documented event names, app settings, campaign configuration, and browser or mobile lifecycle behavior.

References

Files

references/full-guide.md

/build-zoom-contact-center-app

Background reference for Zoom Contact Center integrations across app, web, and native mobile surfaces.

Implementation guidance for Zoom Contact Center across:

  • Contact Center apps in the Zoom client (Zoom Apps SDK path)

  • Web channel embeds (chat/video/campaign)

  • Native mobile SDKs (Android/iOS)

Official docs:

Routing Guardrail

  • If the user is building an app inside the Zoom Contact Center desktop client, stay on the Zoom Apps SDK path and use this skill plus zoom-apps-sdk.

  • If the user is embedding chat/video widgets on a website, route to web/SKILL.md.

  • If the user is integrating native Android or iOS SDK binaries, route to android/SKILL.md or ios/SKILL.md.

  • If the user needs Contact Center call-control or queue APIs, chain with ../rest-api/SKILL.md.

Start here:

  1. concepts/architecture-and-lifecycle.md

  2. scenarios/high-level-scenarios.md

  3. references/forum-top-questions.md

  4. references/versioning-and-compatibility.md

  5. references/samples-validation.md

  6. references/environment-variables.md

  7. troubleshooting/common-drift-and-breaks.md

  8. RUNBOOK.md

Platform skills:

Documentation Structure

contact-center/
├── SKILL.md
├── RUNBOOK.md
├── concepts/
│   └── architecture-and-lifecycle.md
├── scenarios/
│   └── high-level-scenarios.md
├── references/
│   ├── versioning-and-compatibility.md
│   ├── samples-validation.md
│   └── environment-variables.md
├── troubleshooting/
│   └── common-drift-and-breaks.md
├── android/
│   ├── SKILL.md
│   ├── concepts/sdk-lifecycle.md
│   ├── examples/service-patterns.md
│   ├── references/android-reference-map.md
│   └── troubleshooting/common-issues.md
├── ios/
│   ├── SKILL.md
│   ├── concepts/sdk-lifecycle.md
│   ├── examples/service-patterns.md
│   ├── references/ios-reference-map.md
│   └── troubleshooting/common-issues.md
└── web/
    ├── SKILL.md
    ├── concepts/lifecycle-and-events.md
    ├── examples/app-context-and-state.md
    ├── references/web-reference-map.md
    └── troubleshooting/common-issues.md

Common Lifecycle Pattern

  1. Initialize platform context early.

  2. Build a channel item (entryId for chat/video/ZVA, apiKey for scheduled callback and campaign flows).

  3. Get service/client instance.

  4. Register listeners/delegates before user interaction.

  5. Start flow (fetchUI, startVideo, or web SDK open/show path).

  6. Handle engagement state changes (start, hold, resume, end) and context switching.

  7. End flow and release resources (endChat/endVideo, logout/logoff, uninitialize/release).

High-Level Scenarios

  • Agent side-panel app that stores notes per engagementId and survives context switching.

  • Browser chat/video campaigns launched from web tags.

  • Native mobile customer app for chat/video/scheduled callback.

  • Campaign-driven channel selection (chat, ZVA, video, scheduled callback).

  • Rejoin flow for dropped video engagements on mobile.

  • Smart Embed CRM softphone with postMessage event contracts.

See scenarios/high-level-scenarios.md for details.

Chaining

  • Auth and in-client app identity: ../zoom-apps-sdk/SKILL.md and ../oauth/SKILL.md

  • Contact Center REST workflows: ../rest-api/SKILL.md

  • Cobrowse on web voice/chat channels: ../cobrowse-sdk/SKILL.md

Environment Variables

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

No issues found by our static scan· No issues found

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

Attribution and licence

Created by
Zoom
Publisher
OpenAI (Official)
Distributed by
OpenAI
Source
openai/plugins · plugins/zoom/skills/contact-center · commit d420d13
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from plugins/zoom/LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Zoom or OpenAI.

Download ZIP

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