ZoomのOBF Token要件の変更：Meeting BaaSユーザーへの影響

Zoomは、Meeting SDKアプリケーションがミーティングに参加する方法に関して重要な変更を発表しました。2026年3月2日より、botが自身で作成していないミーティングに参加する際は、OBF（On Behalf Of）tokenが必要になります。

Meeting BaaSでは、OBFの完全サポートをすでにリリースしました。この記事では、変更内容とインテグレーションの更新方法について説明します。Zoom botの機能の全体像については、Zoom meeting bot APIのページをご覧ください。

要点まとめ

「外部ミーティング」とは、あなたのZoom組織内のアカウントが作成したものではないミーティングを指します。Meeting BaaSのほとんどのお客様にとって、これはほぼすべてのミーティングを意味します。

OBF Tokenとは？

OBFは「On Behalf Of」の略です。特定のZoomユーザーからの認証を表すtokenです。botがOBF tokenを提示することで、「このbotは私の代わりにミーティングに参加できる」という承認を証明します。

これには2つの重要な制約があります。

1. ユーザーはOAuth経由でappを認証する必要があります（一度だけの同意フロー）
2. botが稼働している間、ユーザーはミーティングに参加している必要があります

認証済みユーザーが退出すると、ZoomはSDKセッションを終了し、botは切断されます。これはZoomプラットフォームの要件です。

対応が必要なのは誰ですか？

判断の目安

SDK Credentialの使用

あなたのbotがZoom組織内のミーティングにのみ参加する場合、自身のSDK credentialを使用することでOBFを完全に回避できます。

zoom_sdk_idとzoom_sdk_pwdをMeeting BaaSに渡すと、botはあなたのZoom appで認証されます。この方法で参加するミーティングは、あなたのアカウントの「内部」として扱われます。

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

このアプローチは、自社のミーティングを録画するチームに適しています。OAuthフロー、ユーザー認証、OBF tokenは不要です。

Zoom appの作成とcredentialの取得方法については、Zoom Appセットアップガイドをご覧ください。

OBF Tokenの実装

外部ミーティングにはOBF tokenが必要です。Meeting BaaSはそれを提供する3つの方法をサポートしています。

オプション1：Direct Token

Zoomから自分でOBF tokenを取得し、botを作成する際に渡します。

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

オプション2：Token URL

OBF tokenを返すendpointをホストします。botは参加時にそれを呼び出します。

{
  "meeting_url": "https://zoom.us/j/123456789",
  "bot_name": "Recording Bot",
  "zoom_obf_token_url": "https://your-api.com/zoom/obf-token"
}

オプション3：Managed OAuth（推奨）

OAuth認証コードをMeeting BaaSに送信します。tokenを保存してリフレッシュを自動で処理します。

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

ほとんどのお客様はオプション3の使用を推奨します。「Zoomを連携する」ボタンを実装し、ユーザーが一度認証すれば、あとはMeeting BaaSが処理します。

v2 API：Zoom Credential管理の改善

Meeting BaaS v2を使用している場合、Zoom credentialを管理するための追加機能が利用できます。

requestごとにcredentialを渡す代わりに、一度保存してIDで参照できます。

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

詳細については、v2 Zoom統合ガイドをご覧ください。

認証済みユーザーの参加要件

よく引っかかるのがこの部分です。あなたのappを認証したZoomユーザーは、botが録画している間、ミーティングに参加している必要があります。

自分たちのミーティングを録画するチームにとって、これは通常自然に機能します。インテグレーションを設定した人がミーティングを進行していることが多いためです。

顧客が録画をリクエストするプラットフォームでは、この点を伝える必要があります。Zoom アカウントを連携した人が、bot が入室する前にミーティングに参加している必要があります。

その人がいない場合はどうなりますか？

bot は待機します。ユーザーが現れるか、タイムアウトが切れるまで（waiting_room_timeout で設定可能）、数秒ごとに再接続を試みます。

ミーティング途中でその人が退出した場合はどうなりますか？

bot は切断されます。Zoom は SDK セッションを終了します。それまでの録画は保存・処理されます。

継続録画について

OBF token はユーザーが参加しているミーティングを対象として設計されています。参加者に関係なく録画を継続する必要がある場合、Zoom はリアルタイムメディアストリーム（RTMS）を開発中です。

RTMS のサポートに向けて取り組んでいます。ただし、RTMS にはトレードオフがあります。ミーティング内でアプリとして動作し（可視の bot 参加者ではありません）、双方向の音声ストリーミングはまだサポートされていません。

ほとんどのユースケースでは、プレゼンス要件を伴う OBF で問題なく機能します。

タイムライン

約3週間あります。今すぐ開始することをお勧めします。

はじめに

リソース

Meeting BaaS ドキュメント:

• Zoom OBF Token ドキュメント (v1)
• Zoom インテグレーションガイド (v2)
• Zoom 認証情報 API (v2)
• Zoom App セットアップガイド

Zoom 公式リソース:

• Zoom 公式ブログ記事
• Zoom OBF FAQ

ご質問はありますか？

適切なアプローチの選択についてお困りの場合や、移行に関するご質問があれば、お気軽にお問い合わせください。お客様とともにこの移行に取り組んでいます。

お問い合わせまたはコミュニティサポートチャンネルをご確認ください。