Виртуальный агент Zoom в чате

Справочник разработчика: как встроить виртуального агента Zoom на сайт и в мобильные приложения, синхронизировать базу знаний и передавать диалог оператору.

СкиллAnthropic (партнёр: Zoom)ClaudeMITНужен терминалПроверка не требуется

Скачать на русскомОригинал на английском (архив)Источник ↗

Что делает: Справочник разработчика: как встроить виртуального агента Zoom на сайт и в мобильные приложения, синхронизировать базу знаний и передавать диалог оператору.
Когда брать: Когда нужно подключить чат-бота Zoom Virtual Agent на сайт или в мобильное приложение либо наладить синхронизацию базы знаний.
Когда не брать: Если нужен только Contact Center внутри клиента Zoom или обычный чат Zoom Team Chat.
Пример запроса: Помоги встроить виртуального агента Zoom на наш сайт и передавать диалог оператору поддержки.
Нужно подключить: терминал

Входит в плагин zoom-plugin. В Cowork и Claude Code можно поставить плагин целиком.

Как включить

Скачайте архив и распакуйте его.
Положите папку build-zoom-virtual-agent в ~/.claude/skills/.
Откройте Claude Code и опишите задачу своими словами: Claude подхватит скилл по описанию.

Текст

---
name: build-zoom-virtual-agent
description: "Справочный скилл по Zoom Virtual Agent. Используй после выбора рабочего процесса виртуального агента, когда реализуешь веб-встраивание, обёртки для Android или iOS, синхронизацию базы знаний, обработку жизненного цикла или устраняешь неполадки."
triggers:
  - "virtual agent"
  - "zva"
  - "virtual assistant sdk"
  - "knowledge base sync"
---

/build-zoom-virtual-agent

Справочный материал по Zoom Virtual Agent для:

Веб-встраивания кампаний и чата.
Обёрток WebView для Android.
Обёрток WKWebView для iOS.
Синхронизации базы знаний и загрузки данных через собственный API.

Официальная документация:

Правило маршрутизации

Если пользователь реализует поверхности приложений Contact Center внутри клиента Zoom, свяжи с [../contact-center/SKILL.md](../contact-center/SKILL.md).
Если пользователю нужны операции над базой знаний на бэкенде (создание, чтение, изменение, удаление) или скрипты автоматизации, свяжи с [../rest-api/SKILL.md](../rest-api/SKILL.md) и [../oauth/SKILL.md](../oauth/SKILL.md).
Если пользователь просит только встраивание бота на сайт и управление кампаниями, оставайся в [web/SKILL.md](web/SKILL.md).
Если пользователь просит нативные мобильные обёртки вокруг веб-чата, направь на [android/SKILL.md](android/SKILL.md) или [ios/SKILL.md](ios/SKILL.md).

Быстрые ссылки

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

Скиллы по платформам:

[web/SKILL.md](web/SKILL.md)
[android/SKILL.md](android/SKILL.md)
[ios/SKILL.md](ios/SKILL.md)

Типовой жизненный цикл

Настрой идентификатор кампании или точки входа в админке Virtual Agent.
Инициализируй SDK в вебе или в контейнере WebView.
Дождись готовности (zoomCampaignSdk:ready или waitForReady()), прежде чем вызывать API.
Зарегистрируй обработчики моста (exitHandler, commonHandler, support_handoff), если нужна нативная оркестрация.
Обработай жизненный цикл беседы (engagement_started, engagement_ended) и состояние интерфейса.
Заверши чат (endChat) и очисти слушатели.

Типовые сценарии

Запуск кампании на сайте с контекстными атрибутами клиента.
Чат во WebView мобильного приложения с нативным мостом закрытия и передачи.
Обработка внешних ссылок: системный браузер или встроенный браузер по выбранной политике.
Синхронизация базы знаний из внешних систем через собственный коннектор API.
Межкомандный процесс поддержки с эскалацией от бота к живому оператору и передачей данных обращения.

Связки с другими скиллами

Шаблоны Contact Center для приложения, веба и мобильных устройств: [../contact-center/SKILL.md](../contact-center/SKILL.md)
Настройка приложения OAuth и токены: [../oauth/SKILL.md](../oauth/SKILL.md)
Рабочие процессы API для автоматизации базы знаний: [../rest-api/SKILL.md](../rest-api/SKILL.md)
Событийные действия бэкенда: [../webhooks/SKILL.md](../webhooks/SKILL.md)

Операции

[RUNBOOK.md](RUNBOOK.md) - пятиминутная предварительная проверка и контрольный список отладки.

Перевод: iiuniversitet. Оригинал: https://github.com/anthropics/knowledge-work-plugins/tree/main/partner-built/zoom-plugin/skills/virtual-agent, лицензия MIT. Изменения: перевод на русский язык.

Оригинал на английском

---
name: build-zoom-virtual-agent
description: "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."
triggers:
  - "virtual agent"
  - "zva"
  - "virtual assistant sdk"
  - "knowledge base sync"
---

# /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](../contact-center/SKILL.md).
- If the user needs backend knowledge-base CRUD or automation scripts, chain with [../rest-api/SKILL.md](../rest-api/SKILL.md) and [../oauth/SKILL.md](../oauth/SKILL.md).
- If the user asks only for website bot embed and campaign controls, stay on [web/SKILL.md](web/SKILL.md).
- If the user asks for mobile native wrappers around web chat, route to [android/SKILL.md](android/SKILL.md) or [ios/SKILL.md](ios/SKILL.md).

## Quick Links

1. [concepts/architecture-and-lifecycle.md](concepts/architecture-and-lifecycle.md)
2. [scenarios/high-level-scenarios.md](scenarios/high-level-scenarios.md)
3. [references/versioning-and-drift.md](references/versioning-and-drift.md)
4. [references/samples-validation.md](references/samples-validation.md)
5. [references/environment-variables.md](references/environment-variables.md)
6. [troubleshooting/common-drift-and-breaks.md](troubleshooting/common-drift-and-breaks.md)
7. [RUNBOOK.md](RUNBOOK.md)

Platform skills:
- [web/SKILL.md](web/SKILL.md)
- [android/SKILL.md](android/SKILL.md)
- [ios/SKILL.md](ios/SKILL.md)

## Common Lifecycle Pattern

1. Configure campaign or entry ID in Virtual Agent admin.
2. Initialize SDK in web or WebView container.
3. Wait for readiness (`zoomCampaignSdk:ready` or `waitForReady()`) before calling APIs.
4. Register bridge handlers (`exitHandler`, `commonHandler`, `support_handoff`) when native orchestration is needed.
5. Handle conversation lifecycle (`engagement_started`, `engagement_ended`) and UI state.
6. 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](../contact-center/SKILL.md)
- OAuth app setup and tokens: [../oauth/SKILL.md](../oauth/SKILL.md)
- API workflows for KB automation: [../rest-api/SKILL.md](../rest-api/SKILL.md)
- Event-driven backend follow-up: [../webhooks/SKILL.md](../webhooks/SKILL.md)

## Operations

- [RUNBOOK.md](RUNBOOK.md) - 5-minute preflight and debugging checklist.

Источник: anthropics/knowledge-work-plugins / zoom-plugin / build-zoom-virtual-agent ↗. Ссылка проверена 2026-10-10.

---
name: build-zoom-virtual-agent
description: "Справочный скилл по Zoom Virtual Agent. Используй после выбора рабочего процесса виртуального агента, когда реализуешь веб-встраивание, обёртки для Android или iOS, синхронизацию базы знаний, обработку жизненного цикла или устраняешь неполадки."
triggers:
  - "virtual agent"
  - "zva"
  - "virtual assistant sdk"
  - "knowledge base sync"
---

# /build-zoom-virtual-agent

Справочный материал по Zoom Virtual Agent для:
- Веб-встраивания кампаний и чата.
- Обёрток WebView для Android.
- Обёрток WKWebView для iOS.
- Синхронизации базы знаний и загрузки данных через собственный 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/

## Правило маршрутизации

- Если пользователь реализует поверхности приложений Contact Center внутри клиента Zoom, свяжи с [../contact-center/SKILL.md](../contact-center/SKILL.md).
- Если пользователю нужны операции над базой знаний на бэкенде (создание, чтение, изменение, удаление) или скрипты автоматизации, свяжи с [../rest-api/SKILL.md](../rest-api/SKILL.md) и [../oauth/SKILL.md](../oauth/SKILL.md).
- Если пользователь просит только встраивание бота на сайт и управление кампаниями, оставайся в [web/SKILL.md](web/SKILL.md).
- Если пользователь просит нативные мобильные обёртки вокруг веб-чата, направь на [android/SKILL.md](android/SKILL.md) или [ios/SKILL.md](ios/SKILL.md).

## Быстрые ссылки

1. [concepts/architecture-and-lifecycle.md](concepts/architecture-and-lifecycle.md)
2. [scenarios/high-level-scenarios.md](scenarios/high-level-scenarios.md)
3. [references/versioning-and-drift.md](references/versioning-and-drift.md)
4. [references/samples-validation.md](references/samples-validation.md)
5. [references/environment-variables.md](references/environment-variables.md)
6. [troubleshooting/common-drift-and-breaks.md](troubleshooting/common-drift-and-breaks.md)
7. [RUNBOOK.md](RUNBOOK.md)

Скиллы по платформам:
- [web/SKILL.md](web/SKILL.md)
- [android/SKILL.md](android/SKILL.md)
- [ios/SKILL.md](ios/SKILL.md)

## Типовой жизненный цикл

1. Настрой идентификатор кампании или точки входа в админке Virtual Agent.
2. Инициализируй SDK в вебе или в контейнере WebView.
3. Дождись готовности (`zoomCampaignSdk:ready` или `waitForReady()`), прежде чем вызывать API.
4. Зарегистрируй обработчики моста (`exitHandler`, `commonHandler`, `support_handoff`), если нужна нативная оркестрация.
5. Обработай жизненный цикл беседы (`engagement_started`, `engagement_ended`) и состояние интерфейса.
6. Заверши чат (`endChat`) и очисти слушатели.

## Типовые сценарии

- Запуск кампании на сайте с контекстными атрибутами клиента.
- Чат во WebView мобильного приложения с нативным мостом закрытия и передачи.
- Обработка внешних ссылок: системный браузер или встроенный браузер по выбранной политике.
- Синхронизация базы знаний из внешних систем через собственный коннектор API.
- Межкомандный процесс поддержки с эскалацией от бота к живому оператору и передачей данных обращения.

## Связки с другими скиллами

- Шаблоны Contact Center для приложения, веба и мобильных устройств: [../contact-center/SKILL.md](../contact-center/SKILL.md)
- Настройка приложения OAuth и токены: [../oauth/SKILL.md](../oauth/SKILL.md)
- Рабочие процессы API для автоматизации базы знаний: [../rest-api/SKILL.md](../rest-api/SKILL.md)
- Событийные действия бэкенда: [../webhooks/SKILL.md](../webhooks/SKILL.md)

## Операции

- [RUNBOOK.md](RUNBOOK.md) - пятиминутная предварительная проверка и контрольный список отладки.

Перевод: iiuniversitet. Оригинал: https://github.com/anthropics/knowledge-work-plugins/tree/main/partner-built/zoom-plugin/skills/virtual-agent, лицензия MIT. Изменения: перевод на русский язык.