Zoom General (Skills Multi-Produits)

Référence contextuelle pour les questions Zoom multi-produits. Privilégiez d'abord les skills de workflow, puis utilisez ce fichier pour les conseils de plateforme partagée et les détails de routage.

Comment zoom-general Route une Requête Développeur Complexe

Utilisez zoom-general comme couche de classification et de chaînage :

1. détecter les signaux produit dans la requête
2. choisir une skill primaire
3. joindre des skills secondaires pour l'authentification, les événements ou les limites de déploiement
4. poser une seule question de clarification courte seulement si deux routes correspondent avec une confiance similaire

Implémentation minimale :

type SkillId =
  | 'zoom-general'
  | 'zoom-rest-api'
  | 'zoom-webhooks'
  | 'zoom-oauth'
  | 'zoom-meeting-sdk-web-component-view'
  | 'zoom-video-sdk'
  | 'zoom-mcp';

const hasAny = (q: string, words: string[]) => words.some((w) => q.includes(w));

function detectSignals(rawQuery: string) {
  const q = rawQuery.toLowerCase();
  return {
    meetingCustomUi: hasAny(q, ['zoom meeting', 'custom ui', 'component view', 'embed meeting']),
    customVideo: hasAny(q, ['video sdk', 'custom video session', 'peer-video-state-change']),
    restApi: hasAny(q, ['rest api', '/v2/', 'create meeting', 'list users', 's2s oauth']),
    webhooks: hasAny(q, ['webhook', 'x-zm-signature', 'event subscription', 'crc']),
    oauth: hasAny(q, ['oauth', 'pkce', 'token refresh', 'account_credentials']),
    mcp: hasAny(q, ['zoom mcp', 'agentic retrieval', 'tools/list', 'semantic meeting search']),
  };
}

function pickPrimarySkill(s: ReturnType<typeof detectSignals>): SkillId {
  if (s.meetingCustomUi) return 'zoom-meeting-sdk-web-component-view';
  if (s.mcp) return 'zoom-mcp';
  if (s.restApi) return 'zoom-rest-api';
  if (s.customVideo) return 'zoom-video-sdk';
  return 'zoom-general';
}

function buildChain(primary: SkillId, s: ReturnType<typeof detectSignals>): SkillId[] {
  const chain = [primary];
  if (s.oauth && !chain.includes('zoom-oauth')) chain.push('zoom-oauth');
  if (s.webhooks && !chain.includes('zoom-webhooks')) chain.push('zoom-webhooks');
  return chain;
}

Exemple :

• Create a meeting, configure webhooks, and handle OAuth token refresh -> zoom-rest-api -> zoom-oauth -> zoom-webhooks
• Build a custom video UI for a Zoom meeting on web -> zoom-meeting-sdk-web-component-view

Pour l'implémentation TypeScript complète et le contrat de transfert, consultez references/routing-implementation.md.

Choisissez Votre Parcours

Point de Contrôle de Planification : Rivet SDK (Optionnel)

Quand un utilisateur commence à planifier une intégration côté serveur qui combine auth + webhooks + appels API, posez d'abord cette question :

• Rivet SDK est un framework Node.js qui regroupe la gestion d'authentification Zoom, les récepteurs de webhook et les wrappers API typés.
• Voulez-vous utiliser Rivet SDK pour un échafaudage plus rapide, ou préférez-vous une implémentation OAuth + REST directe sans Rivet ?

Routage après la réponse :

• Si l'utilisateur choisit Rivet : chaîner rivet-sdk + oauth + rest-api.
• Si l'utilisateur refuse Rivet : chaîner oauth + rest-api (+ webhooks ou product skill au besoin).

Matrice de Routage SDK vs REST (Arrêt Dur)

Garde-fous de routage :

• Si l'utilisateur demande un comportement d'intégration/jointure SDK, restez sur le chemin SDK.
• Si l'invite dit réunion plus interface/vidéo/disposition/intégration personnalisée, préférez zoom-meeting-sdk-web-component-view.
• Utilisez uniquement zoom-video-sdk quand l'utilisateur construit un produit de session personnalisé plutôt qu'une réunion Zoom.
• Utilisez uniquement le chemin REST pour la gestion des ressources, les rapports ou la distribution de liens sauf si l'utilisateur demande explicitement une architecture mixte.
• Pour la logique de classification/chaînage exécutable et la gestion des erreurs, consultez references/routing-implementation.md.

Matrice de Routage API vs MCP (Arrêt Dur)

Garde-fous de routage :

• Ne remplacez pas les APIs backend déterministes par un routage MCP uniquement.
• Ne forcez pas un routage REST-d'abord brut quand la tâche est l'orchestration d'outils agent IA.
• Préférez un routage hybride quand l'utilisateur a besoin à la fois d'une automatisation stable et d'interactions pilotées par l'IA.
• Le serveur distant MCP fonctionne sur HTTP/SSE Streamable ; utilisez ce chemin quand le client/agent cible supporte les transports MCP (par exemple Claude ou VS Code).
• Ne concevez pas d'approvisionnement de point de terminaison MCP personnalisé par locataire ; les points de terminaison MCP Zoom sont partagés au niveau instance/cluster.
• Source : https://developers.zoom.us/docs/mcp/library/resources/apis-vs-mcp/

Résolution d'Ambiguïté (Demander Avant le Routage)

Quand une invite correspond aux deux chemins API et MCP avec une confiance similaire, posez une seule question de clarification courte avant l'exécution :

• Voulez-vous une automatisation API REST déterministe, un tooling MCP d'agent IA, ou un hybride des deux ?

Puis routez comme :

• Réponse REST → zoom-rest-api
• Réponse MCP → zoom-mcp
• Réponse hybride → zoom-rest-api + zoom-mcp

Notes sur la Disponibilité et la Topologie de MCP

• L'accès MCP hébergé par Zoom évolue ; la documentation indique un modèle où Zoom expose des serveurs MCP à portée produit (par exemple Meetings, Team Chat, Whiteboard).
• Utilisez zoom-mcp comme point d'entrée MCP parent.
• Routez les requêtes MCP spécifiques à Whiteboard vers zoom-mcp/whiteboard.
• Quand une requête est spécifique au produit et que la couverture MCP existe, routez d'abord vers cette surface produit MCP ; sinon utilisez les skills REST/SDK pour l'implémentation déterministe.

Webhooks vs WebSockets

Les deux reçoivent des notifications d'événements, mais diffèrent dans l'approche :

Cas d'Usage Courants

Index Complet des Cas d'Usage

• Routage APIs vs MCP : choisir routage API uniquement, MCP uniquement ou hybride en utilisant les critères Zoom officiels.
• Intégration AI Companion : connecter les capacités Zoom AI Companion dans le workflow de votre app.
• Intégration IA : ajouter logique de synthèse, transcription ou assistant utilisant les surfaces de données Zoom.
• Automatisation Backend (S2S OAuth) : exécuter les travaux côté serveur avec les credentials OAuth au niveau compte.
• Apps Collaboratives : construire l'état et les interactions d'app partagées en réunion.
• Intégration Contact Center : connecter les signaux Zoom Contact Center dans les systèmes externes.
• Cycle de Vie App Contact Center et Changement de Contexte : implémenter l'état d'engagement piloté par événement et le changement de contexte sûr dans les apps Contact Center.
• Wrapper Web et Mobile Campagne Virtual Agent : déployer le chat Virtual Agent basé sur campagne sur le site web et les wrappers WebView Android/iOS.
• Pipeline de Synchronisation Base de Connaissances Virtual Agent : automatiser l'ingestion de base de connaissances avec stratégie de sync web ou connecteur API personnalisé.
• Intégration CRM Smart Embed Zoom Phone : intégrer les événements Smart Embed, Phone APIs et les workflows CRM avec gestion de données sûre pour la migration.
• Orchestrateur API Événementiel Rivet : construire un backend Node.js qui combine la gestion de webhook et l'orchestration API avec Rivet.
• Portail de Préparation Probe SDK : exécuter les diagnostics navigateur/appareil/réseau avant les workflows de lancement de réunion ou session vidéo.
• Vidéo Personnalisée : choisir entre Video SDK et les composants associés pour l'UX de session personnalisée.
• Interface de Réunion Personnalisée (Web) : utiliser Meeting SDK Component View pour une interface personnalisée autour d'une vraie réunion Zoom.
• Pipeline de Transcription Scribe : utiliser AI Services Scribe pour la transcription de fichier à la demande et le traitement d'archive batch.
• Video SDK Apportez Votre Propre Stockage : configurer les enregistrements cloud Video SDK pour écrire directement vers votre propre bucket S3.
• Navigabilité Collaborative Support Client : implémenter les flux de support de navigabilité collaborative client-agent.
• Intégrer les Réunions : intégrer l'expérience de réunion Zoom dans votre app.
• Assistant de Complétion de Formulaire : construire des flux guidés pour le remplissage et l'assistance de complétion de formulaire.
• Résolution Vidéo HD : activer et dépanner les exigences vidéo haute définition.
• Plateforme de Réunion Haut Volume : construire la création de réunion distribuée et le traitement d'événements avec des modèles de secours concrets.
• Expériences Immersives : utiliser les APIs Zoom Apps Layers pour des visuels en réunion personnalisés.
• Apps en Réunion : construire les Zoom Apps qui s'exécutent directement dans les contextes de réunion et webinaire.
• Publication Marketplace : préparer et livrer une app Zoom via la révision Marketplace.
• Automatisation de Réunion : créer, mettre à jour et gérer les réunions de manière programmatique.
• Bots de Réunion : construire les bots pour la jointure de réunion, la capture et l'analyse en temps réel.
• Livraison Multi-Plateforme SDK de Réunion Natif : normaliser la livraison Android, iOS, macOS et Unreal Meeting SDK avec les contrôles auth et version partagés.
• Livraison Multi-Plateforme SDK Vidéo Natif : normaliser la livraison Android, iOS, macOS et Unity Video SDK avec les contrôles auth et version partagés.
• Détails de Réunion avec Événements : combiner la récupération REST avec les flux d'événements webhook.
• Calcul des Minutes : calculer l'utilisation et les métriques de minutes sur les réunions/sessions.
• Interface Vidéo Pré-construite : utiliser UI Toolkit pour une livraison d'interface plus rapide basée sur Video SDK.
• Surveillance QSS : surveiller les statistiques de qualité Zoom et les indicateurs de performance.
• Enregistrement Brut : capturer les flux bruts pour les pipelines d'enregistrement et de traitement personnalisés.
• Intégration de Réunion Electron : intégrer les réunions dans une application de bureau Electron.
• Sessions Vidéo Flutter : construire les sessions Video SDK dans les apps mobiles Flutter.
• Intégration de Réunion React Native : intégrer Meeting SDK dans les apps React Native.
• Sessions Vidéo React Native : construire les sessions vidéo personnalisées dans React Native.
• Flux Médias Temps Réel : consommer les flux de média/transcription en direct via RTMS.
• Pipeline de Téléchargement d'Enregistrement : automatiser la récupération et les pipelines de stockage d'enregistrement.
• Enregistrement et Transcription : gérer les workflows de transcriptions et enregistrements post-réunion.
• Récupérer Réunion et S'abonner aux Événements : joindre la récupération REST de réunion avec les abonnements d'événement.
• Intégration OAuth App SaaS : implémenter OAuth au niveau utilisateur dans les apps SaaS multi-locataires.
• Optimisation Taille SDK : réduire l'empreinte bundle/runtime pour les apps basées sur SDK.
• Wrappers SDK et GUI : évaluer les modèles de wrapper et les frameworks GUI autour des SDKs.
• Bot Team Chat LLM : construire un bot Team Chat avec réponses alimentées par LLM.
• Test et Développement : modèles de test local, mocks et boucles de développement sûres.
• Dépannage Token et Scope : déboguer les problèmes de scope OAuth et inadéquation de token.
• Bot Transcription (Linux) : exécuter les bots de réunion Linux pour les charges de transcription en direct.
• Rapports d'Utilisation et Analytique : collecter et analyser les données d'utilisation/rapport.
• Création d'Utilisateur et de Réunion : provisionner les utilisateurs et planifier les réunions dans un flux unique.
• Intégration Web SDK : intégrer les expériences de réunion dans les apps web basées sur navigateur.
• OAuth Serveur-à-Serveur avec Webhooks : combiner OAuth account avec le traitement backend piloté par événement.
• Liens de Réunion vs Intégration : choisir entre la distribution join_url et l'intégration SDK.
• Déploiement App Entreprise : déployer, gouverner et opérer les intégrations Zoom à l'échelle entreprise.

Prérequis

1. Compte Zoom (Pro, Business ou Enterprise)
2. App créée dans Zoom App Marketplace
3. Credentials OAuth (Client ID et Secret)

Références

• Limitations et Bizarreries Connues

Démarrage Rapide

1. Allez à marketplace.zoom.us
2. Cliquez sur Develop → Build App
3. Sélectionnez le type d'app (voir references/app-types.md)
4. Configurez OAuth et les scopes
5. Copiez les credentials dans votre application

Références Détaillées

• references/authentication.md - OAuth 2.0, S2S OAuth, modèles JWT
• references/app-types.md - Guide de décision pour les types d'app
• references/scopes.md - Référence des scopes OAuth
• references/marketplace.md - Navigation du portail Marketplace
• references/query-routing-playbook.md - Router les requêtes complexes vers les skills spécialisées appropriées
• references/interview-answer-routing.md - Modèle de réponse prête pour interview pour le routage zoom-general
• references/routing-implementation.md - Classification de requête TypeScript concrète et contrat de transfert de skill
• references/automatic-skill-chaining-rest-webhooks.md - Processus exécutable pour les workflows chaînés REST + webhook
• references/meeting-webhooks-oauth-refresh-orchestration.md - Conception concrète pour la création de réunion + mises à jour webhook + actualisation de token OAuth
• references/distributed-meeting-fallback-architecture.md - Architecture distribuée haut volume avec retries, circuit breakers et fallbacks de réconciliation
• references/community-repos.md - Référentiels d'exemples Zoom officiels curés par produit

Maintenance des SDK

• references/sdk-upgrade-guide.md - Politique de version, étapes de mise à jour
• references/sdk-upgrade-workflow.md - Changelog + RSS, workflow de mise à jour réutilisable version par version
• references/sdk-logs-troubleshooting.md - Collecte des logs SDK

Ressources

• Docs officielles : https://developers.zoom.us/
• Marketplace : https://marketplace.zoom.us/
• Forum développeur : https://devforum.zoom.us/

Variables d'Environnement

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

Opérations

• RUNBOOK.md - Checklist de pré-vol et débogage de 5 minutes.