/build-zoom-virtual-agent

Référence de contexte pour Zoom Virtual Agent couvrant :

• Campagnes web et embeds de chat.
• Wrappers WebView Android.
• Wrappers WKWebView iOS.
• Synchronisation de base de connaissances et ingestion d'API personnalisée.

Documentation officielle :

• 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

• Si l'utilisateur implémente des surfaces Contact Center app dans le client Zoom, chaîner avec ../contact-center/SKILL.md.
• Si l'utilisateur a besoin de CRUD de base de connaissances backend ou de scripts d'automatisation, chaîner avec ../rest-api/SKILL.md et ../oauth/SKILL.md.
• Si l'utilisateur demande uniquement un embed bot website et des contrôles de campagne, rester sur web/SKILL.md.
• Si l'utilisateur demande des wrappers natifs mobiles autour du chat web, router vers android/SKILL.md ou ios/SKILL.md.

Liens rapides

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

Skills de plateforme :

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

Pattern Lifecycle Commun

1. Configurer la campagne ou l'ID d'entrée dans l'admin Virtual Agent.
2. Initialiser le SDK dans un conteneur web ou WebView.
3. Attendre la disponibilité (zoomCampaignSdk:ready ou waitForReady()) avant d'appeler les API.
4. Enregistrer les bridge handlers (exitHandler, commonHandler, support_handoff) si l'orchestration native est nécessaire.
5. Gérer le lifecycle de conversation (engagement_started, engagement_ended) et l'état UI.
6. Terminer le chat (endChat) et nettoyer les listeners.

Scénarios Haut Niveau

• Lanceur de campagne website avec attributs client contextuels.
• Chat WebView d'app mobile avec bridge natif de fermeture/handoff.
• Gestion d'URL externe via navigateur système vs politique de navigateur in-app.
• Synchronisation de base de connaissances depuis systèmes externes via connecteur API personnalisé.
• Flux support inter-équipes escaladant du bot au support live avec payload de handoff.

Chaînage

• Patterns Contact Center app/web/mobile : ../contact-center/SKILL.md
• Configuration OAuth app et tokens : ../oauth/SKILL.md
• Workflows API pour automatisation KB : ../rest-api/SKILL.md
• Suivi backend piloté par événement : ../webhooks/SKILL.md

Opérations

• RUNBOOK.md - Checklist preflight et débogage 5 minutes.