Contents
前提条件と準備チェックリスト
| 必要項目 | 確認ポイント | 補足 |
|---|---|---|
| JamRoll アカウント | 企業アカウントが作成済みか （ jam-roll.jp/setting/user-system-integration） |
無料トライアルでも OK。ただし、API 利用は有料プランが必須 |
| Zoom 管理者権限 | 自身のロールが Administrator であること | 「ユーザー管理」→「ロールと権限」で確認 |
| Zoom プラン | Pro 以上かつ クラウドレコーディング と API アクセス が有効 | 管理画面 > レポート > 録画 でステータスを確認 |
| 外部ストレージ（任意） | AWS S3 / Azure Blob などのバケットが用意できるか | ローカル保存でも可だが、外部ストレージは長期保管に便利 |
チェックリスト形式で社内共有
markdown
- [ ] JamRoll アカウント作成済み
- [ ] Zoom 管理者権限取得
- [ ] Zoom Pro 以上（クラウドレコーディング・API 有効）
- [ ] 必要に応じて外部ストレージを用意
JamRoll 側の OAuth 接続設定
手順概要
- JamRoll ダッシュボード にログイン → 左メニュー「連携」→「Zoom」を選択。
- 「Zoom アカウントと接続」ボタンをクリックすると Zoom の認可画面が表示される。
- 管理者アカウントで ログイン → 要求された権限（スコープ）を 許可。
- 認証が成功すると JamRoll 側に「接続完了」ステータスが緑色で表示される。
UI スクリーンショット
| 手順 | 画面イメージ |
|---|---|
| 1. ダッシュボードの連携メニュー |  |
| 2. Zoom 接続ボタン |  |
| 3. OAuth 許可画面（スコープ一覧） |  |
| 4. 接続完了ステータス |  |
ポイント
- 許可画面で表示される スコープ は次節で設定したものと一致するか必ず確認。
- 接続後、JamRoll の「接続情報」タブに アクセストークンの有効期限（30日） が記載されている。
Zoom Marketplace に必須スコープを登録する手順
必要なスコープ
| スコープ | 説明 |
|---|---|
recording:read |
クラウド録画ファイルの取得権限 |
meeting:read |
会議情報（参加者、開始時刻等）の取得権限 |
手順詳細
- Zoom Marketplace (https://marketplace.zoom.us) に管理者アカウントでログイン。
- 上部メニュー Develop → Build App をクリックし、OAuth アプリを作成。
- 「情報」タブに以下を入力
- アプリ名（例:
JamRoll Integration) - リダイレクト URL：
https://app.jamroll.jp/oauth/callback（JamRoll が自動生成） - 「権限」タブで
recording:readとmeeting:readをチェックし、保存。 - 有効化 ボタンを押すと、アプリがステータス 「有効」 に変わる。
スクリーンショット例
| 手順 | 画像 |
|---|---|
| アプリ作成画面 |  |
| 権限設定画面 |  |
| 有効化完了画面 |  |
注意
- リダイレクト URL が一致しないと認証が失敗するので、JamRoll の指示通りに入力。
- 変更後は必ず 再認証（JamRoll ダッシュボードの「再接続」）を行う。
クラウドレコーディングと保存先の構成
有効化手順
- Zoom ウェブポータルに管理者としてログイン。
- 左メニュー 録画 → クラウドレコーディング を選択。
- 「クラウドレコーディングを有効化」スイッチをオン。
保存先設定（ローカル vs 外部ストレージ）
| 項目 | 推奨設定 |
|---|---|
| デフォルト保存先 | Zoom クラウド（最も手軽） |
| 外部ストレージ | AWS S3 バケットまたは Azure Blob （長期保管・コスト削減） |
| 自動処理 | 「会議終了時に自動で録画開始」＋「録音後すぐに処理を開始」 |
UI 例
| 手順 | スクリーンショット |
|---|---|
| クラウドレコーディング設定ページ |  |
| 外部ストレージ選択画面 |  |
ベストプラクティス
- 1 か月以上保存する場合は、外部ストレージの ライフサイクルポリシー を利用して自動削除を設定。
- 録画完了メール通知は必ずオンにし、エラー時の検知を容易にする。
テストミーティングでの動作確認フロー
- テスト会議作成（Zoom で 5 分程度） → 「録画開始」ボタンを手動または自動で有効化。
- 会議終了後、Zoom の 録画タブ にステータス “完了” が表示されるまで待機（最大 10 分）。
- JamRoll ダッシュボードの 文字起こし一覧 を開く。数分以内に会議名がエントリとして追加されているか確認。
| 確認項目 | 合格基準 |
|---|---|
| 録画ファイル取得 | ファイル名・サイズが JamRoll に表示される |
| 文字起こし開始ラグ | 10 分以内にテキストが生成される |
| 感情スコア付与 | 各発話に ポジティブ / ネガティブ タグと数値（0‑100）が表示される |
検証結果の記録
markdown
- [ ] 録画ファイル取得 ✅
- [ ] 文字起こし開始ラグ ≤10分 ✅
- [ ] 感情スコア付与 ✅
OAuth トークン有効期限・再認証フローの詳細
| 項目 | 内容 |
|---|---|
| アクセストークン有効期間 | 30 日（Zoom のデフォルト） |
| リフレッシュトークン有効期間 | 90 日。ただし、30 日ごとに新しいリフレッシュトークンが発行される |
| 自動更新の有無 | JamRoll は内部でリフレッシュトークンを使用して自動的にアクセストークンを更新（ユーザー操作不要） |
| 手動再認証が必要になるケース | - リフレッシュトークンが失効したとき - Zoom 側でアプリのスコープ変更やポリシー違反が発覚したとき - アカウントのパスワードリセット等でセキュリティロックが掛かったとき |
再認証手順（JamRoll ダッシュボード）
- 左メニュー 連携 → Zoom を開く。
- 「接続情報」欄に赤い警告アイコンが表示されている場合は 「再認証」 ボタンをクリック。
- 再度 Zoom の許可画面が表示されるので、先ほどと同じスコープを 許可。
スクリーンショット例
| 手順 | 画像 |
|---|---|
| 接続情報の警告表示 |  |
| 再認証ボタン |  |
運用上のヒント
- トークン期限が近づくと JamRoll がメールで通知する機能（設定 > 通知）を有効化。
- 大規模導入時は、トークン失効によるバッチ処理停止リスクを回避するために 定期的なモニタリングスクリプト を走らせることを推奨。
Whisper‑2 の性能指標と感情解析の数値根拠
| 項目 | 数値（公式ベンチマーク） | 出典 |
|---|---|---|
| 日本語認識精度 (Word Error Rate) | 4.8 %（＝95.2 % 正確率） | JamRoll 技術ブログ「Whisper‑2 日本語評価」2025年12月 |
| 平均文字起こし遅延 | 録画完了から 6 分以内 | 社内実測データ（2026年 Q1、500 件サンプル） |
| 感情解析正確度 (Positive/Negative 判定) | 87 %（マクロ平均 F1 スコア） | 「JamRoll 感情分析エンジン」技術ホワイトペーパー、2025年10月 |
補足
- Whisper‑2 は OpenAI の最新音声モデルをベースに、JamRoll が独自に日本語データで微調整したものです。
- 感情解析は BERT‑based のテキスト分類器を使用し、発話単位で ポジティブスコア と ネガティブスコア（0‑100）を出力します。
典型的なエラーと対処法（FAQ）
| エラーメッセージ | 主な原因 | 推奨対処法 |
|---|---|---|
| 権限不足 (403) | recording:read または meeting:read が未許可 |
Zoom Marketplace のアプリ設定でスコープを追加 → JamRoll で再認証 |
| 録画未保存 | クラウドレコーディングがオフ、または「ローカルのみ」設定 | 管理者画面でクラウドレコーディング有効化 → 必要に応じて自動録画設定をオン |
| OAuth トークン期限切れ | アクセストークン (30日) が失効、リフレッシュトークンも失効 | JamRoll ダッシュボードの「再認証」から手順通りに実施 |
| API 呼び出し回数上限超過 | Zoom の API 使用量がプラン上限を越えた | 利用状況レポートで確認 → 必要ならプランアップグレード、または呼び出し頻度の削減 |
エラー発生時のログ取得方法
- JamRoll ダッシュボード → 設定 > 開発者モード を有効化。
- API ログ タブで最近のリクエスト/レスポンスを JSON 形式でダウンロード可能。
高度活用例：文字起こし＋感情スコアで業務効率化
1️⃣ 営業チーム向けシナリオ
| フロー | 活用ポイント |
|---|---|
| 商談録画 → JamRoll | 録画が自動取得され、Whisper‑2 が文字起こし。 |
| 感情スコア分析 | 発話ごとにポジティブ度合い（例: 85 %）を数値化。 |
| レポート生成 | スクリプトで「ポジティブスコア > 80 %」の箇所だけ抽出し、PowerPoint に自動貼り付け。 |
効果：商談要点抽出にかかる工数が 70 % 削減、顧客の関心度を定量的に把握できる。
2️⃣ カスタマーサポート向けシナリオ
| フロー | 活用ポイント |
|---|---|
| サポート対応録音 → JamRoll | 全通話が自動で文字化。 |
| ネガティブスコア閾値設定 | スコア > 70 % の発話を自動フラグ付け。 |
| エスカレーション自動化 | フラグ付きケースは Slack/Teams に即時通知、マネージャーがフォローアップ。 |
効果：顧客不満の早期検知率が 45 % 向上し、NPS の改善に直結。
実装チェックリスト（最終確認）
| # | チェック項目 | 完了状態 |
|---|---|---|
| 1 | JamRoll アカウント作成・API 利用権限付与 | ☐ |
| 2 | Zoom 管理者権限取得 | ☐ |
| 3 | Zoom Pro 以上＋クラウドレコーディング有効化 | ☐ |
| 4 | JamRoll の OAuth 接続実施（画面確認） | ☐ |
| 5 | Zoom Marketplace に recording:read / meeting:read スコープ登録 |
☐ |
| 6 | リダイレクト URL が正しく設定されているか | ☐ |
| 7 | クラウドレコーディングの保存先（必要なら外部ストレージ）設定 | ☐ |
| 8 | テストミーティングで文字起こし・感情スコアが生成されたこと確認 | ☐ |
| 9 | OAuth トークン期限通知と再認証手順を社内マニュアル化 | ☐ |
| 10 | エラー時のログ取得フローをドキュメントに追記 | ☐ |
完了サイン：全項目がチェックされれば、JamRoll と Zoom の連携は本番運用可能です。
参考リンク
- JamRoll 技術ブログ – Whisper‑2 日本語評価（2025年12月）
- Zoom Marketplace 開発者ガイド – OAuth アプリの作成方法
- JamRoll 感情分析ホワイトペーパー（PDF）
- 【公式】JamRoll 音声文字起こし設定ガイド 2026 年版
本稿は 2026年5月時点の情報に基づき執筆しています。製品アップデートやプラン変更があった場合は、各ベンダーの最新ドキュメントをご参照ください。