Build Zoom Contact Center App
OpenAIOfficialCreated by ZoomDistributed by OpenAI
- Skill
- Tool integration
- Automation and integrations
- MIT
- No issues found
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
Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/openai/build-zoom-contact-center-app/downloadUnzip 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
Identify the channel and client: web, Android, iOS, campaign embed, video engagement, chat engagement, Virtual Agent handoff, or scheduled callback.
Confirm the lifecycle: initialization, engagement start, context retrieval, state changes, transfer or handoff, and cleanup.
Choose the platform reference before coding; Contact Center SDKs differ by event names, lifecycle hooks, and wrapper requirements.
Treat engagement context as shared state and validate how it flows into CRM, ticketing, analytics, or AI workflows.
Debug version drift by checking SDK version, documented event names, app settings, campaign configuration, and browser or mobile lifecycle behavior.
References
Full preserved guide: references/full-guide.md
Web SDK: web/SKILL.md
Android SDK: android/SKILL.md
iOS SDK: ios/SKILL.md
High-level scenarios: scenarios/high-level-scenarios.md
Common drift and breaks: troubleshooting/common-drift-and-breaks.md
Files
- ATTRIBUTION.mdAdded by AutoGineer890 B
- LICENSELicence file added by AutoGineer1.1 KiB
- RUNBOOK.md3.0 KiB
- SKILL.md1.4 KiB
- agents/openai.yaml152 B
- concepts/architecture-and-lifecycle.md1.9 KiB
- references/environment-variables.md1.7 KiB
- references/forum-top-questions.md3.2 KiB
- references/full-guide.md4.5 KiB
- references/samples-validation.md1.7 KiB
- references/versioning-and-compatibility.md1.2 KiB
- scenarios/high-level-scenarios.md1.7 KiB
- troubleshooting/common-drift-and-breaks.md1.6 KiB
scenarios/high-level-scenarios.md
High-Level Scenarios
1. Agent Notes App in Contact Center
Goal:
Agent writes notes that follow engagement context switching.
Flow:
configZoom Apps SDK with engagement capabilities.Load
getEngagementContext+getEngagementStatus.Store notes by
engagementId.On
onEngagementContextChange, swap UI state to selected engagement.On
onEngagementStatusChangeend, finalize or clear engagement draft.
2. Web Chat Campaign Launch
Goal:
Product team controls targeting in admin without code redeploy.
Flow:
Add campaign web tag script.
Wait for
zoomCampaignSdk:ready.Programmatically
open/show/hide/closeas needed.Listen for engagement events for analytics and CRM writes.
3. Mobile Chat and Video with Native SDK
Goal:
Customer mobile app can launch chat/video and recover from interruptions.
Flow:
Initialize SDK context in app startup.
Build
ZoomCCItemfor channel.Initialize service, attach delegates/listeners, and launch UI.
Handle disconnect/rejoin links for video.
End flow and release service resources.
4. Campaign-Mode Channel Router
Goal:
Runtime selection of chat/video/ZVA/scheduled callback per campaign.
Flow:
Fetch campaigns by API key.
Inspect campaign channels.
Build channel-specific item with campaign mode.
Release previous conflicting service before opening new channel.
5. Smart Embed CRM Integration
Goal:
Embed Contact Center softphone in CRM with screen-pop and contact lookup.
Flow:
Load Smart Embed iframe.
Handle postMessage events (
zcc-init-config-request, search, resize, engagement events).Return contact search results and route screen-pop in CRM.
Keep feature flags aligned with Smart Embed version path.
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