build-zoom-virtual-agent
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.
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o build-zoom-virtual-agent.zip https://jpskill.com/download/22719.zip && unzip -o build-zoom-virtual-agent.zip && rm build-zoom-virtual-agent.zip
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/22719.zip -OutFile "$d\build-zoom-virtual-agent.zip"; Expand-Archive "$d\build-zoom-virtual-agent.zip" -DestinationPath $d -Force; ri "$d\build-zoom-virtual-agent.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
build-zoom-virtual-agent.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
build-zoom-virtual-agentフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 4
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
/build-zoom-virtual-agent
Zoom Virtual Agentに関する背景情報です。対象は以下の通りです。
- Webキャンペーン/チャット埋め込み
- Android WebViewラッパー
- iOS WKWebViewラッパー
- ナレッジベース同期とカスタムAPI取り込み
公式ドキュメント:
- 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/
ルーティングのガードレール
- ユーザーがZoomクライアント内でContact Centerアプリのサーフェスを実装している場合は、../contact-center/SKILL.mdと連携してください。
- ユーザーがバックエンドのナレッジベースCRUDまたは自動化スクリプトを必要とする場合は、../rest-api/SKILL.mdおよび../oauth/SKILL.mdと連携してください。
- ユーザーがウェブサイトのボット埋め込みとキャンペーンコントロールのみを要求する場合は、web/SKILL.mdに留まってください。
- ユーザーがウェブチャットを囲むモバイルネイティブラッパーを要求する場合は、android/SKILL.mdまたはios/SKILL.mdにルーティングしてください。
クイックリンク
- 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
プラットフォームスキル:
共通のライフサイクルパターン
- Virtual Agent管理画面でキャンペーンまたはエントリーIDを設定します。
- ウェブまたはWebViewコンテナでSDKを初期化します。
- APIを呼び出す前に、準備完了(
zoomCampaignSdk:readyまたはwaitForReady())を待ちます。 - ネイティブオーケストレーションが必要な場合は、ブリッジハンドラー(
exitHandler、commonHandler、support_handoff)を登録します。 - 会話のライフサイクル(
engagement_started、engagement_ended)とUIの状態を処理します。 - チャットを終了し(
endChat)、リスナーをクリーンアップします。
高レベルのシナリオ
- コンテキストに応じた顧客属性を持つウェブサイトキャンペーンランチャー。
- ネイティブのクローズ/ハンドオフブリッジを備えたモバイルアプリのWebViewチャット。
- システムブラウザとアプリ内ブラウザポリシーによる外部URL処理。
- カスタムAPIコネクタを使用した外部システムからのナレッジベース同期。
- ボットからライブサポートへのエスカレーションとハンドオフペイロードを伴うチーム間のサポートフロー。
チェイニング
- Contact Centerアプリ/ウェブ/モバイルパターン: ../contact-center/SKILL.md
- OAuthアプリのセットアップとトークン: ../oauth/SKILL.md
- KB自動化のためのAPIワークフロー: ../rest-api/SKILL.md
- イベント駆動型バックエンドのフォローアップ: ../webhooks/SKILL.md
オペレーション
- RUNBOOK.md - 5分間の事前チェックとデバッグチェックリストです。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
/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:
Common Lifecycle Pattern
- Configure campaign or entry ID in Virtual Agent admin.
- Initialize SDK in web or WebView container.
- Wait for readiness (
zoomCampaignSdk:readyorwaitForReady()) 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.
同梱ファイル
※ ZIPに含まれるファイル一覧。`SKILL.md` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。
- 📄 SKILL.md (3,321 bytes)
- 📎 references/environment-variables.md (844 bytes)
- 📎 references/samples-validation.md (1,026 bytes)
- 📎 references/versioning-and-drift.md (823 bytes)