/build-zoom-contact-center-app

Documentation de référence pour les intégrations Zoom Contact Center sur les surfaces d'application, web et mobiles natives.

Conseils de mise en œuvre pour Zoom Contact Center à travers :

• Les applications Contact Center dans le client Zoom (chemin Zoom Apps SDK)
• Les intégrations de canal web (chat/vidéo/campagne)
• Les SDK mobiles natifs (Android/iOS)

Documentation officielle :

• https://developers.zoom.us/docs/contact-center/
• https://developers.zoom.us/docs/contact-center/web/sdk-reference/
• https://marketplacefront.zoom.us/sdk/contact/android/index.html
• https://marketplacefront.zoom.us/sdk/contact/ios/index.html

Routing Guardrail

• Si l'utilisateur construit une application dans le client de bureau Zoom Contact Center, restez sur le chemin Zoom Apps SDK et utilisez cette skill plus zoom-apps-sdk.
• Si l'utilisateur intègre des widgets de chat/vidéo sur un site web, routez vers web/SKILL.md.
• Si l'utilisateur intègre les binaires du SDK Android ou iOS natif, routez vers android/SKILL.md ou ios/SKILL.md.
• Si l'utilisateur a besoin d'API de contrôle d'appels ou de files d'attente Contact Center, chaînez avec ../rest-api/SKILL.md.

Quick Links

Commencez ici :

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

Platform skills :

• 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

Common Lifecycle Pattern

1. Initialisez le contexte de la plateforme au début.
2. Créez un élément de canal (entryId pour chat/vidéo/ZVA, apiKey pour les flux de callback programmé et de campagne).
3. Obtenez l'instance de service/client.
4. Enregistrez les écouteurs/délégués avant l'interaction utilisateur.
5. Démarrez le flux (fetchUI, startVideo, ou chemin web SDK open/show).
6. Gérez les changements d'état d'engagement (start, hold, resume, end) et la commutation de contexte.
7. Terminez le flux et libérez les ressources (endChat/endVideo, logout/logoff, uninitialize/release).

High-Level Scenarios

• Application de panneau latéral Agent qui stocke des notes par engagementId et survit à la commutation de contexte.
• Campagnes de chat/vidéo lancées à partir de balises web.
• Application mobile client natif pour chat/vidéo/callback programmé.
• Sélection de canal pilotée par campagne (chat, ZVA, vidéo, callback programmé).
• Flux de reconnexion pour les engagements vidéo abandonnés sur mobile.
• CRM Smart Embed softphone avec contrats d'événements postMessage.

Consultez scenarios/high-level-scenarios.md pour plus de détails.

Chaining

• Auth et identité d'application en client : ../zoom-apps-sdk/SKILL.md et ../oauth/SKILL.md
• Workflows Contact Center REST : ../rest-api/SKILL.md
• Cobrowse sur les canaux voix/chat web : ../cobrowse-sdk/SKILL.md

Environment Variables

• Consultez references/environment-variables.md pour les clés .env standardisées et où trouver chaque valeur.