build-zoom-contact-center-app

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

/build-zoom-contact-center-app

Background reference for Zoom Contact Center integrations across app, web, and native mobile surfaces.

Implementation guidance for Zoom Contact Center across:

Contact Center apps in the Zoom client (Zoom Apps SDK path)
Web channel embeds (chat/video/campaign)
Native mobile SDKs (Android/iOS)

Official docs:

面向应用、网页和原生移动端的 Zoom Contact Center 集成背景参考。

Zoom Contact Center 的实现指南涵盖以下方向：

Zoom 客户端中的联络中心应用（Zoom Apps SDK 路径）
网页渠道嵌入（聊天/视频/营销活动）
原生移动端 SDK（Android/iOS）

官方文档：

Routing Guardrail

路由指引

If the user is building an app inside the Zoom Contact Center desktop client, stay on the Zoom Apps SDK path and use this skill plus
```
zoom-apps-sdk
```
.
If the user is embedding chat/video widgets on a website, route to web/SKILL.md.
If the user is integrating native Android or iOS SDK binaries, route to android/SKILL.md or ios/SKILL.md.
If the user needs Contact Center call-control or queue APIs, chain with ../rest-api/SKILL.md.

如果用户要在 Zoom Contact Center 桌面客户端内构建应用，请使用 Zoom Apps SDK 路径，结合本技能与
```
zoom-apps-sdk
```
使用。
如果用户要在网站中嵌入聊天/视频组件，请跳转至 web/SKILL.md。
如果用户要集成原生 Android 或 iOS SDK 包，请跳转至 android/SKILL.md 或 ios/SKILL.md。
如果用户需要联络中心通话控制或队列 API，请关联 ../rest-api/SKILL.md 使用。

Quick Links

快速链接

Start here:

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

Platform skills:

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

从这里开始：

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

平台技能：

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

Documentation Structure

文档结构

contact-center/
├── SKILL.md
├── RUNBOOK.md
├── concepts/
│   └── architecture-and-lifecycle.md
├── scenarios/
│   └── high-level-scenarios.md
├── references/
│   ├── versioning-and-compatibility.md
│   ├── samples-validation.md
│   └── environment-variables.md
├── troubleshooting/
│   └── common-drift-and-breaks.md
├── android/
│   ├── SKILL.md
│   ├── concepts/sdk-lifecycle.md
│   ├── examples/service-patterns.md
│   ├── references/android-reference-map.md
│   └── troubleshooting/common-issues.md
├── ios/
│   ├── SKILL.md
│   ├── concepts/sdk-lifecycle.md
│   ├── examples/service-patterns.md
│   ├── references/ios-reference-map.md
│   └── troubleshooting/common-issues.md
└── web/
    ├── SKILL.md
    ├── concepts/lifecycle-and-events.md
    ├── examples/app-context-and-state.md
    ├── references/web-reference-map.md
    └── troubleshooting/common-issues.md

contact-center/
├── SKILL.md
├── RUNBOOK.md
├── concepts/
│   └── architecture-and-lifecycle.md
├── scenarios/
│   └── high-level-scenarios.md
├── references/
│   ├── versioning-and-compatibility.md
│   ├── samples-validation.md
│   └── environment-variables.md
├── troubleshooting/
│   └── common-drift-and-breaks.md
├── android/
│   ├── SKILL.md
│   ├── concepts/sdk-lifecycle.md
│   ├── examples/service-patterns.md
│   ├── references/android-reference-map.md
│   └── troubleshooting/common-issues.md
├── ios/
│   ├── SKILL.md
│   ├── concepts/sdk-lifecycle.md
│   ├── examples/service-patterns.md
│   ├── references/ios-reference-map.md
│   └── troubleshooting/common-issues.md
└── web/
    ├── SKILL.md
    ├── concepts/lifecycle-and-events.md
    ├── examples/app-context-and-state.md
    ├── references/web-reference-map.md
    └── troubleshooting/common-issues.md

Common Lifecycle Pattern

通用生命周期模式

Initialize platform context early.
Build a channel item (
```
entryId
```
for chat/video/ZVA,
```
apiKey
```
for scheduled callback and campaign flows).
Get service/client instance.
Register listeners/delegates before user interaction.
Start flow (
```
fetchUI
```
,
```
startVideo
```
, or web SDK open/show path).
Handle engagement state changes (
```
start
```
,
```
hold
```
,
```
resume
```
,
```
end
```
) and context switching.
End flow and release resources (
```
endChat
```
/
```
endVideo
```
,
```
logout/logoff
```
, uninitialize/release).

提前初始化平台上下文。
构建渠道项（聊天/视频/ZVA 对应
```
entryId
```
，预约回调和营销活动流对应
```
apiKey
```
）。
获取服务/客户端实例。
在用户交互前注册监听器/代理。
启动流程（
```
fetchUI
```
、
```
startVideo
```
或网页 SDK 的 open/show 路径）。
处理交互状态变化（
```
start
```
、
```
hold
```
、
```
resume
```
、
```
end
```
）和上下文切换。
结束流程并释放资源（
```
endChat
```
/
```
endVideo
```
、
```
logout/logoff
```
、反初始化/释放）。

High-Level Scenarios

高阶场景

Agent side-panel app that stores notes per
```
engagementId
```
and survives context switching.
Browser chat/video campaigns launched from web tags.
Native mobile customer app for chat/video/scheduled callback.
Campaign-driven channel selection (chat, ZVA, video, scheduled callback).
Rejoin flow for dropped video engagements on mobile.
Smart Embed CRM softphone with postMessage event contracts.

See scenarios/high-level-scenarios.md for details.

按
```
engagementId
```
存储笔记、支持上下文切换的 Agent 侧边栏应用。
通过网页标签触发的浏览器聊天/视频营销活动。
支持聊天/视频/预约回调的原生移动端客户应用。
营销活动驱动的渠道选择（聊天、ZVA、视频、预约回调）。
移动端视频交互中断后的重连流程。
带 postMessage 事件约定的智能嵌入 CRM 软电话。

查看 scenarios/high-level-scenarios.md 获取详情。

Chaining

关联技能

Auth and in-client app identity: ../zoom-apps-sdk/SKILL.md and ../oauth/SKILL.md
Contact Center REST workflows: ../rest-api/SKILL.md
Cobrowse on web voice/chat channels: ../cobrowse-sdk/SKILL.md

鉴权与客户端内应用身份校验：../zoom-apps-sdk/SKILL.md 和 ../oauth/SKILL.md
联络中心 REST 工作流：../rest-api/SKILL.md
网页语音/聊天渠道协同浏览：../cobrowse-sdk/SKILL.md

Environment Variables

环境变量

See references/environment-variables.md for standardized
```
.env
```
keys and where to find each value.

查看 references/environment-variables.md 获取标准化
```
.env
```
键名及各取值的获取路径。