关于 build-zoom-virtual-agent
为 Zoom Virtual Agent 集成提供背景参考,面向实现网站聊天嵌入、移动端 WebView 和知识库同步的开发者。内容涵盖 Web、Android 与 iOS 路径,并提供按场景分流的指南。
主要功能
- 01Web、Android 与 iOS 集成参考
- 02聊天初始化与会话生命周期
- 03原生桥接和支持转接
- 04知识库同步与自定义 API 接入
- 05故障排查与运行手册
适用场景
- 01在网站嵌入带客户属性的聊天入口
- 02在移动应用 WebView 中接入聊天
- 03将机器人会话转接至人工支持
- 04从外部系统同步知识库
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ anthropics/ knowledge-work-plugins --skill build-zoom-virtual-agent安装后在 Claude Code 中输入/build-zoom-virtual-agent确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
RUNBOOK.mdandroid/concepts/webview-lifecycle.mdandroid/examples/js-bridge-patterns.mdandroid/references/android-reference-map.mdandroid/troubleshooting/common-issues.mdconcepts/architecture-and-lifecycle.mdios/concepts/webview-lifecycle.mdios/examples/js-bridge-patterns.mdios/references/ios-reference-map.mdios/troubleshooting/common-issues.mdreferences/environment-variables.mdsamples-validation.mdversioning-and-drift.mdscenarios/high-level-scenarios.mdtroubleshooting/common-drift-and-breaks.mdweb/concepts/lifecycle-and-events.mdweb/examples/campaign-and-entry-patterns.mdweb/references/web-reference-map.mdweb/troubleshooting/common-issues.md详细介绍
/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。
- 如果用户需要为 Web 聊天编写移动端原生封装,请转到 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。
- 在 Web 或 WebView 容器中初始化 SDK。
- 在调用 API 之前,等待就绪(
zoomCampaignSdk:ready或waitForReady())。 - 需要原生编排时,注册桥接处理器(
exitHandler、commonHandler、support_handoff)。 - 处理会话生命周期(
engagement_started、engagement_ended)和 UI 状态。 - 结束聊天(
endChat)并清理监听器。
高级场景
- 带有上下文客户属性的网站活动启动器。
- 移动应用 WebView 聊天,带原生关闭/转接桥接。
- 外部 URL 处理:根据系统浏览器与应用内浏览器策略进行区分。
- 通过自定义 API 连接器从外部系统同步知识库。
- 跨团队支持流程:通过转接载荷,从机器人升级到人工支持。
衔接
- Contact Center 应用/Web/移动端模式:../contact-center/SKILL.md
- OAuth 应用设置与令牌:../oauth/SKILL.md
- 知识库自动化 API 工作流:../rest-api/SKILL.md
- 事件驱动的后端跟进:../webhooks/SKILL.md
运维
- RUNBOOK.md - 5 分钟预检与调试清单。
评论
支持 Markdown