Nouvelle Exigence de Token OBF Zoom : Ce Qui Change pour les Utilisateurs Meeting BaaS

Zoom a annoncé un changement important concernant la façon dont les applications Meeting SDK rejoignent les réunions. À partir du 2 mars 2026, les bots rejoignant des réunions qu'ils n'ont pas créées auront besoin d'un token On Behalf Of (OBF).

Nous avons déjà livré le support complet des OBF dans Meeting BaaS. Cet article explique ce que ce changement signifie et comment mettre à jour votre intégration.

La Version Courte

Une "réunion externe" est toute réunion non créée par des comptes au sein de votre organisation Zoom. Pour la plupart des clients Meeting BaaS, cela représente la majorité des réunions.

Qu'est-ce qu'un Token OBF ?

OBF signifie "On Behalf Of" (au nom de). C'est un token qui représente l'autorisation d'un utilisateur Zoom spécifique. Quand votre bot présente un token OBF, il prouve que quelqu'un a dit "ce bot peut rejoindre des réunions en mon nom."

Deux contraintes importantes accompagnent ceci :

1. L'utilisateur doit autoriser votre app via OAuth (flux de consentement unique)
2. L'utilisateur doit être présent dans la réunion pendant que le bot est actif

Si l'utilisateur autorisé quitte la réunion, Zoom met fin à la session SDK et le bot se déconnecte. C'est une exigence de la plateforme Zoom.

Qui Doit Agir ?

Guide de Décision Rapide

Utiliser les Identifiants SDK

Si vos bots rejoignent uniquement des réunions au sein de votre organisation Zoom, vous pouvez éviter complètement l'OBF en utilisant vos propres identifiants SDK.

Quand vous passez zoom_sdk_id et zoom_sdk_pwd à Meeting BaaS, le bot s'authentifie avec votre app Zoom. Les réunions rejointes de cette façon sont considérées comme "internes" à votre compte.

{
  "meeting_url": "https://zoom.us/j/123456789",
  "bot_name": "Enregistreur Équipe",
  "zoom_sdk_id": "VOTRE_SDK_KEY",
  "zoom_sdk_pwd": "VOTRE_SDK_SECRET"
}

Cette approche fonctionne bien pour les équipes qui enregistrent leurs propres réunions. Pas de flux OAuth, pas d'autorisation utilisateur, pas de tokens OBF.

Consultez le guide de Configuration d'App Zoom pour savoir comment créer votre app Zoom et obtenir ces identifiants.

Implémenter les Tokens OBF

Pour les réunions externes, vous avez besoin de tokens OBF. Meeting BaaS supporte trois façons de les fournir :

Option 1 : Token Direct

Récupérez le token OBF depuis Zoom vous-même et passez-le lors de la création du bot :

{
  "meeting_url": "https://zoom.us/j/123456789",
  "bot_name": "Bot d'Enregistrement",
  "zoom_obf_token": "eyJ0eXAiOiJKV1Qi..."
}

Option 2 : URL de Token

Hébergez un endpoint qui retourne les tokens OBF. Le bot l'appelle au moment de rejoindre :

{
  "meeting_url": "https://zoom.us/j/123456789",
  "bot_name": "Bot d'Enregistrement",
  "zoom_obf_token_url": "https://votre-api.com/zoom/obf-token"
}

Option 3 : OAuth Géré (Recommandé)

Envoyez-nous le code d'autorisation OAuth. Nous stockons les tokens et gérons le rafraîchissement automatiquement :

{
  "meeting_url": "https://zoom.us/j/123456789",
  "bot_name": "Bot d'Enregistrement",
  "zoom_obf_token_user_id": "SeJwoMGwTCu52501SbDC0Q"
}

La plupart des clients devraient utiliser l'Option 3. Vous construisez un bouton "Connecter Zoom", votre utilisateur autorise une fois, et Meeting BaaS gère le reste.

API v2 : Gestion Améliorée des Identifiants Zoom

Si vous utilisez Meeting BaaS v2, vous bénéficiez de fonctionnalités supplémentaires pour gérer les identifiants Zoom :

Au lieu de passer les identifiants à chaque requête, stockez-les une fois et référencez-les par ID :

{
  "meeting_url": "https://zoom.us/j/123456789",
  "bot_name": "Bot d'Enregistrement",
  "zoom_config": {
    "credential_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Consultez le Guide d'Intégration Zoom v2 pour les détails.

La Contrainte de l'Utilisateur Autorisé

C'est la partie qui pose problème : l'utilisateur Zoom qui a autorisé votre app doit être dans la réunion pendant que le bot enregistre.

Pour les équipes qui enregistrent leurs propres réunions, cela fonctionne généralement naturellement. La personne qui a configuré l'intégration dirige probablement la réunion.

Pour les plateformes où les clients demandent des enregistrements, vous devez communiquer cela. La personne qui a connecté son compte Zoom doit rejoindre avant que le bot puisse entrer.

Que se passe-t-il s'ils ne sont pas là ?

Le bot attend. Il réessaie de rejoindre toutes les quelques secondes jusqu'à ce que l'utilisateur arrive ou qu'un timeout expire (configurable via waiting_room_timeout).

Que se passe-t-il s'ils partent en cours de réunion ?

Le bot se déconnecte. Zoom met fin à la session SDK. Tout enregistrement jusqu'à ce point est quand même sauvegardé et traité.

Et l'Enregistrement Continu ?

Les tokens OBF sont conçus pour les réunions avec présence utilisateur. Si vous avez besoin d'un enregistrement qui continue peu importe qui est présent, Zoom développe Real-Time Media Streams (RTMS).

Nous travaillons sur le support RTMS. Cependant, RTMS a des compromis différents : il s'exécute comme une app à l'intérieur de la réunion (pas un bot participant visible) et ne supporte pas encore le streaming audio bidirectionnel.

Pour la plupart des cas d'utilisation, l'OBF avec l'exigence de présence fonctionne bien.

Calendrier

Vous avez environ trois semaines. Nous recommandons de commencer maintenant.

Pour Commencer

Ressources

Documentation Meeting BaaS :

• Documentation des Tokens OBF Zoom (v1)
• Guide d'Intégration Zoom (v2)
• API Credentials Zoom (v2)
• Guide de Configuration d'App Zoom

Ressources Officielles Zoom :

• Article Officiel de Zoom
• FAQ OBF de Zoom

Des Questions ?

Contactez-nous si vous avez besoin d'aide pour choisir la bonne approche ou si vous avez des questions sur la migration. Nous accompagnons nos clients dans cette transition.

Contactez-nous ou consultez les canaux de support communautaire.