zoom-virtual-agent-android — скилл для Codex: WebView-интеграция Zoom
Скилл для Codex и ChatGPT, который помогает встроить Zoom Virtual Agent в Android-приложение через WebView и связать JavaScript с нативным кодом.
npx skills add openai/plugins --skill android -a codexЧто делает zoom-virtual-agent-android
Скилл описывает модель интеграции: кампания Zoom открывается в Android WebView, в страницу подставляется объект window.zoomCampaignSdkConfig с контекстом запуска, а нативный код регистрирует JavaScript-мост для exitHandler, commonHandler и support_handoff. Маршрутизацию ссылок задаёт shouldOverrideUrlLoading вместе с колбэками многоконного режима.
Внутри — четыре раздела: жизненный цикл WebView, примеры паттернов JS-моста, карта ссылок по Android и разбор частых проблем. Отдельно прописаны жёсткие правила: обработчики нужно инициализировать до того, как ждать вызовы из JavaScript, а обработку старой команды openURL скилл советует держать только как путь совместимости. Если положиться на неё как на основной способ навигации, переходы начнут разваливаться — вместо этого скилл предлагает DOM-ссылки или window.open с явной нативной маршрутизацией.
Есть ссылки на продуктовый SKILL.md и на мобильный раздел Contact Center, так что скилл стыкуется с более широкой настройкой. Установка идёт через npx skills add openai/plugins --skill android -a codex, после чего файл лежит в .agents/skills/android/SKILL.md.
Какие задачи решает
- встроить кампанию Zoom Virtual Agent в Android WebView
- настроить JS-мост для колбэков
exitHandlerиcommonHandler - передавать контекст запуска в страницу через
window.zoomCampaignSdkConfig - задать политику ссылок в
shouldOverrideUrlLoading - разобраться с жизненным циклом WebView и частыми сбоями
Примеры запросов агенту
- Помоги встроить Zoom Virtual Agent в WebView и зарегистрировать JS-мост для
support_handoff - Проверь мой
shouldOverrideUrlLoading: ссылки должны уходить в нативную маршрутизацию - Почему колбэк из JavaScript не приходит? Разбери по разделу про жизненный цикл WebView
Как установить zoom-virtual-agent-android
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill android -a codex2Вручную: положить файлы
.agents/skills/android/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill android -a claude-code2Вручную: положить файлы
~/.claude/skills/android/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/android/
Вручную: положить файлы
.cursor/skills/android/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins android2Вручную: положить файлы
.github/skills/android/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/zoom/skills/virtual-agent/androidВручную: положить файлы
.devin/skills/android/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о zoom-virtual-agent-android
Как установить zoom-virtual-agent-android в Codex?
Выполните npx skills add openai/plugins --skill android -a codex. После этого файл скилла лежит в .agents/skills/android/SKILL.md.
Что делает zoom-virtual-agent-android?
Описывает интеграцию Zoom Virtual Agent в Android через WebView: контекст запуска, JavaScript-мост для exitHandler, commonHandler и support_handoff, политику ссылок и жизненный цикл.
Что нужно сделать до того, как ждать колбэки из JavaScript?
Инициализировать обработчики. Скилл называет это жёстким правилом: без этого вызовы из страницы не придут.
Исходный текст
SKILL.md · MIT
--- name: zoom-virtual-agent-android description: "Zoom Virtual Agent Android integration via WebView. Use for Java/Kotlin bridge callbacks, native URL handling, support_handoff relay, and lifecycle-safe embedding." --- # Zoom Virtual Agent - Android Official docs: - https://developers.zoom.us/docs/virtual-agent/android/ ## Quick Links 1. [concepts/webview-lifecycle.md](concepts/webview-lifecycle.md) 2. [examples/js-bridge-patterns.md](examples/js-bridge-patterns.md) 3. [references/android-reference-map.md](references/android-reference-map.md) 4. [troubleshooting/common-issues.md](troubleshooting/common-issues.md) ## Integration Model - Host campaign URL in Android WebView. - Inject runtime context (`window.zoomCampaignSdkConfig`). - Register JavaScript bridge for `exitHandler`, `commonHandler`, `support_handoff`. - Apply URL policy via `shouldOverrideUrlLoading` and optional multi-window callbacks. ## Hard Guardrails - Initialize handlers before expecting JS callbacks. - Treat legacy `openURL` command handling as compatibility path only. - Prefer DOM links or `window.open` handling plus explicit native routing. ## Chaining - Product-level patterns: [../SKILL.md](../SKILL.md) - Contact Center mobile scope: [../../contact-center/android/SKILL.md](../../contact-center/android/SKILL.md)
© Zoom · MIT · openai/plugins