zoom-virtual-agent-ios — Codex skill and setup
This skill covers Zoom Virtual Agent inside an iOS WKWebView, including injected scripts, message handlers, handoff events, and URL routing.
npx skills add openai/plugins --skill ios -a codexWhat zoom-virtual-agent-ios does
The skill lays out an iOS integration model for loading a Zoom Virtual Agent campaign in WKWebView. It uses WKUserScript to provide window.zoomCampaignSdkConfig, then connects message handlers for exit, common events, and support handoff.
Navigation can send URLs to the app, SFSafariViewController, or the system browser. Download handling needs an iOS 14.5+ path. Register scripts and handlers before the web view is used; keep the deprecated openURL command as a fallback rather than the main route.
What it helps with
- load a Zoom Virtual Agent campaign in
WKWebView - inject campaign configuration with
WKUserScript - relay exit and
support_handoffmessages - route links to the app or a browser
Example prompts for the agent
- Set up the Zoom Virtual Agent campaign in
WKWebViewand injectwindow.zoomCampaignSdkConfigwithWKUserScript. - Add message handlers for exit and
support_handoff, then define URL behavior in the navigation delegate. - Review download handling for iOS 14.5+ and retain
openURLonly as a fallback.
How to install zoom-virtual-agent-ios
1Skills CLI (Vercel)
npx skills add openai/plugins --skill ios -a codex2Manually: put the files in place
.agents/skills/ios/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill ios -a claude-code2Manually: put the files in place
~/.claude/skills/ios/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ios/
Manually: put the files in place
.cursor/skills/ios/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins ios2Manually: put the files in place
.github/skills/ios/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/zoom/skills/virtual-agent/iosManually: put the files in place
.devin/skills/ios/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: Codex skills: how to install, where they live, how to call them
Questions about zoom-virtual-agent-ios
How do I install zoom-virtual-agent-ios in Codex?
Run npx skills add openai/plugins --skill ios -a codex, then use the skill at .agents/skills/ios/SKILL.md.
What does zoom-virtual-agent-ios do?
It guides a Zoom Virtual Agent iOS integration built on WKWebView, covering injected configuration, message handlers, handoff relays, and URL policies.
What iOS detail matters for this integration?
Download behavior needs handling for iOS 14.5+. Scripts and handlers must be registered before web interaction, while openURL is kept as a fallback.
Source text
SKILL.md · MIT
--- name: zoom-virtual-agent-ios description: "Zoom Virtual Agent iOS integration via WKWebView. Use for Swift/Objective-C script injection, message handlers, support_handoff relay, and URL routing policies." --- # Zoom Virtual Agent - iOS Official docs: - https://developers.zoom.us/docs/virtual-agent/ios/ ## Quick Links 1. [concepts/webview-lifecycle.md](concepts/webview-lifecycle.md) 2. [examples/js-bridge-patterns.md](examples/js-bridge-patterns.md) 3. [references/ios-reference-map.md](references/ios-reference-map.md) 4. [troubleshooting/common-issues.md](troubleshooting/common-issues.md) ## Integration Model - Load campaign URL in `WKWebView`. - Inject `window.zoomCampaignSdkConfig` using `WKUserScript`. - Register message handlers for exit/common/handoff flows. - Handle URL behavior in navigation delegates (`in-app`, `SFSafariViewController`, or system browser). ## Hard Guardrails - Register scripts and handlers before web interaction. - Handle iOS 14.5+ download behavior where needed. - Keep deprecated `openURL` command support as fallback only. ## Chaining - Product-level patterns: [../SKILL.md](../SKILL.md) - Contact Center mobile scope: [../../contact-center/ios/SKILL.md](../../contact-center/ios/SKILL.md)
© Zoom · MIT · openai/plugins