La nouvelle exigence de token OBF de Zoom : ce qui change pour les utilisateurs de Meeting BaaS

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

Nous avons déjà intégré la prise en charge complète de l'OBF dans Meeting BaaS. Cet article explique ce que ce changement implique et comment mettre à jour votre intégration.

En résumé

Un « meeting externe » est tout meeting non créé par des comptes au sein de votre organisation Zoom. Pour la plupart des clients de Meeting BaaS, cela représente la majorité des meetings.

Qu'est-ce qu'un token OBF ?

OBF signifie « On Behalf Of » (au nom de). Il s'agit d'un token qui représente l'autorisation d'un utilisateur Zoom spécifique. Lorsque votre bot présente un token OBF, il prouve que quelqu'un a déclaré : « ce bot peut rejoindre des meetings en mon nom ».

Deux contraintes importantes s'appliquent :

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

Si l'utilisateur autorisé quitte le meeting, Zoom met fin à la session SDK et le bot se déconnecte. Il s'agit d'une exigence de la plateforme Zoom.

Qui doit agir ?

Guide de décision rapide

Utilisation des identifiants SDK

Si vos bots rejoignent uniquement des meetings au sein de votre organisation Zoom, vous pouvez éviter entièrement l'OBF en utilisant vos propres identifiants SDK.

Lorsque vous transmettez zoom_sdk_id et zoom_sdk_pwd à Meeting BaaS, le bot s'authentifie avec votre application Zoom. Les meetings rejoints de cette façon sont considérés comme « internes » à votre compte.

{
  "meeting_url": "https://zoom.us/j/123456789",
  "bot_name": "Team Recorder",
  "zoom_sdk_id": "YOUR_SDK_KEY",
  "zoom_sdk_pwd": "YOUR_SDK_SECRET"
}

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

Consultez le guide de configuration de l'application Zoom pour savoir comment créer votre application Zoom et obtenir ces identifiants.

Implémentation des tokens OBF

Pour les meetings externes, vous avez besoin de tokens OBF. Meeting BaaS prend en charge trois façons de les fournir :

Option 1 : Token direct

Récupérez vous-même le token OBF auprès de Zoom et transmettez-le lors de la création du bot :

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

Option 2 : Token URL

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

{
  "meeting_url": "https://zoom.us/j/123456789",
  "bot_name": "Recording Bot",
  "zoom_obf_token_url": "https://your-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 renouvellement automatiquement :

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

La plupart des clients devraient utiliser l'Option 3. Vous créez 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 transmettre les identifiants à chaque requête, stockez-les une seule fois et référencez-les par ID :

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

Consultez le guide d'intégration Zoom v2 pour plus de détails.

La contrainte de l'utilisateur autorisé

Voici ce qui pose souvent problème : l'utilisateur Zoom qui a autorisé votre application doit être présent dans le meeting pendant que le bot enregistre.

Pour les équipes qui enregistrent leurs propres meetings, cela fonctionne généralement naturellement. La personne qui a configuré l'intégration est probablement celle qui anime le meeting.

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

Que se passe-t-il si elle n'est pas présente ?

Le bot attend. Il tente de rejoindre le meeting toutes les quelques secondes jusqu'à ce que l'utilisateur arrive ou qu'un délai d'expiration soit atteint (configurable via waiting_room_timeout).

Que se passe-t-il s'il quitte le meeting en cours de route ?

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

Qu'en est-il de l'enregistrement continu ?

Les tokens OBF sont conçus pour les meetings auxquels les utilisateurs participent. Si vous avez besoin d'un enregistrement qui se poursuit indépendamment des participants présents, Zoom développe les Real-Time Media Streams (RTMS).

Nous travaillons sur la prise en charge des RTMS. Cependant, les RTMS impliquent différents compromis : ils fonctionnent comme une application à l'intérieur du meeting (et non comme un participant bot visible) et ne prennent pas encore en charge le streaming audio bidirectionnel.

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

Calendrier

Il vous reste environ trois semaines. Nous vous recommandons de commencer dès maintenant.

Premiers pas

Ressources

Documentation Meeting BaaS :

• Documentation des tokens OBF Zoom (v1)
• Guide d'intégration Zoom (v2)
• API Credentials Zoom (v2)
• Guide de configuration de l'application Zoom

Ressources officielles Zoom :

• Article de blog officiel de Zoom
• FAQ OBF de Zoom

Des questions ?

N'hésitez pas à nous contacter si vous avez besoin d'aide pour choisir la bonne approche ou si vous avez des questions concernant la migration. Nous accompagnons nos clients tout au long de cette transition.

Contactez-nous ou consultez les canaux de support communautaire.