/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:

• https://developers.zoom.us/docs/virtual-agent/

• https://developers.zoom.us/docs/virtual-agent/web/

• https://developers.zoom.us/docs/virtual-agent/android/

• https://developers.zoom.us/docs/virtual-agent/ios/

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.