zoom-contact-center-web

Integrate Zoom Contact Center web SDKs for chat, video, campaign embeds, and Smart Embed workflows.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill zoom-contact-center-web
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zoom-contact-center-web
Source: https://github.com/openai/plugins/tree/main/plugins/zoom/skills/contact-center/web
Command: npx skills add https://github.com/openai/plugins --skill zoom-contact-center-web

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Integrating Zoom Contact Center into web applications involves multiple distinct runtimes (in-client Zoom Apps, external campaign embeds, video clients, and Smart Embed iframes), each with different lifecycle rules, event models, and credential requirements that are easy to get wrong.

Core Features & Use Cases

  • Integration Mode Guidance: Covers Contact Center apps in the Zoom client, external website campaign embeds via zoomCampaignSdk, video client initialization, and Smart Embed iframe postMessage contracts.
  • Engagement-Aware State Management: Provides patterns for keying application state by engagementId and handling context/status change events without losing draft or chat state.
  • Troubleshooting & Preflight Runbook: Diagnoses common failures such as zoomCampaignSdk being undefined, CSP/allow-list blocks, missing app context headers, and lost Smart Embed events.
  • Use Case: You are embedding Zoom Contact Center chat on a marketing website and the widget never opens; use this Skill to verify the zoomCampaignSdk:ready gate, API key configuration, and CSP settings before deeper debugging.

Quick Start

Use the zoom-contact-center-web skill to help me integrate the Zoom campaign SDK chat widget on my website and handle engagement events correctly.

Frequently Asked Questions about zoom-contact-center-web

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate Zoom Contact Center chat into my website?

Load the campaign SDK script with your API key, wait for the `zoomCampaignSdk:ready` event, then call methods like `show()`, `open()`, or `endChat()`. All SDK calls must be gated behind the ready event to avoid undefined errors.

How do I handle Zoom Contact Center engagement events in a web app?

Subscribe to `onEngagementContextChange` and `onEngagementStatusChange` after configuring the Zoom Apps SDK with the required capabilities. Key all session state by `engagementId` and treat the `end` status as the cleanup boundary.

Why is zoomCampaignSdk undefined when I call it?

The SDK object is undefined when methods are called before the readiness event fires. Wrap all SDK calls inside a `zoomCampaignSdk:ready` event listener and verify the script loaded with a valid API key.

Why does the Zoom Contact Center widget not load on my site?

Widget loading failures are usually caused by Content Security Policy headers or missing Marketplace domain allow-list entries blocking the script or network requests. Update CSP headers and allow-list settings before debugging application logic.

How does Smart Embed postMessage communication work with Zoom Contact Center?

Smart Embed runs in an iframe and communicates via `postMessage` events such as `zcc-init-config-request` and contact search requests. Implement strict origin and message-type filtering and respond to required init and search events.

What credentials are required for Zoom Contact Center web integrations?

Chat, video, and ZVA entry points require an `entryId`, while scheduled callback and campaign/tag use cases require an `apiKey`. In-client app behavior additionally requires Zoom App credentials with the appropriate scopes.