build-zoom-virtual-agent

Original：🇺🇸 English

Translated

Reference skill for Zoom Virtual Agent. Use after routing to a virtual-agent workflow when implementing web embeds, Android or iOS wrapper integrations, knowledge-base sync, lifecycle handling, or troubleshooting.

3installs

Sourceanthropics/knowledge-work-plugins

Added on2026-04-10

NPX Install

npx skill4agent add anthropics/knowledge-work-plugins build-zoom-virtual-agent

SKILL.md Content

View Translation Comparison →

/build-zoom-virtual-agent

Background reference for Zoom Virtual Agent across:

Web campaign/chat embeds.
Android WebView wrappers.
iOS WKWebView wrappers.
Knowledge-base sync and custom API ingestion.

Official docs:

Routing Guardrail

If the user is implementing Contact Center app surfaces inside Zoom client, chain with ../contact-center/SKILL.md.
If the user needs backend knowledge-base CRUD or automation scripts, chain with ../rest-api/SKILL.md and ../oauth/SKILL.md.
If the user asks only for website bot embed and campaign controls, stay on web/SKILL.md.
If the user asks for mobile native wrappers around web chat, route to android/SKILL.md or ios/SKILL.md.

Quick Links

concepts/architecture-and-lifecycle.md
scenarios/high-level-scenarios.md
references/versioning-and-drift.md
references/samples-validation.md
references/environment-variables.md
troubleshooting/common-drift-and-breaks.md
RUNBOOK.md

Platform skills:

web/SKILL.md
android/SKILL.md
ios/SKILL.md

Common Lifecycle Pattern

Configure campaign or entry ID in Virtual Agent admin.
Initialize SDK in web or WebView container.
Wait for readiness (
```
zoomCampaignSdk:ready
```
or
```
waitForReady()
```
) before calling APIs.
Register bridge handlers (
```
exitHandler
```
,
```
commonHandler
```
,
```
support_handoff
```
) when native orchestration is needed.
Handle conversation lifecycle (
```
engagement_started
```
,
```
engagement_ended
```
) and UI state.
End chat (
```
endChat
```
) and clean up listeners.

High-Level Scenarios

Website campaign launcher with contextual customer attributes.
Mobile app WebView chat with native close/handoff bridge.
External URL handling via system browser vs in-app browser policy.
Knowledge-base sync from external systems using custom API connector.
Cross-team support flow that escalates from bot to live support with handoff payload.

Chaining

Contact Center app/web/mobile patterns: ../contact-center/SKILL.md
OAuth app setup and tokens: ../oauth/SKILL.md
API workflows for KB automation: ../rest-api/SKILL.md
Event-driven backend follow-up: ../webhooks/SKILL.md

Operations

RUNBOOK.md - 5-minute preflight and debugging checklist.