Zoom RA トラブルシューティング

概要

Zoom Revenue Acceleratorの問題は、ほぼ次の3つのいずれかです。ZRAライセンスが無い、文字起こしが無効、通話が録音されていない。当てはまる症状を探してください。

接続エラー

「Zoom Revenue Acceleratorに接続できません。もう一度お試しください。」

包括的なエラーです。実際には、ZoomアカウントにRevenue Acceleratorの有効なサブスクリプションが無いケースがほとんどです。

• アカウントが有償Zoomプラン かつ ZRAライセンスを持っているか確認してください — 要件 を参照。
• Settings → Call Recording → Zoom RA からやり直してください。古い認可リンクを再利用しないでください。
• ブラウザが zoom.us へのリダイレクトをブロックしていないか確認してください。

「無効なZoomトークンです。もう一度お試しください。」

Zoomは認可を受け付けたものの、Steveがプロフィールを読み取れませんでした。

• 再認可し、プロフィールへのアクセスを含む すべて の要求権限を承認してください。
• Zoom管理者がMarketplaceアプリを制限している場合は、アカウントでSteveアプリを承認してもらってください。

「無効なOAuthステートです。再度接続をお試しください。」

Zoomからの応答を組織に紐づけられませんでした。

• 最も多い原因：Zoom App Marketplaceから開始した。 Marketplaceのリスティングで Add をクリックすると、Steveの組織情報が付かないまま認可が始まります。Steveの Settings → Call Recording → Zoom RA から 接続 をクリックしてやり直してください。
• それ以外の場合は、設定ページを再読み込みし、正しいSteve組織にいることを確認して 接続 をクリックし直してください。

「認証コードが見つかりません。」

認可が完了していません。多くは同意画面をキャンセルまたは閉じた場合です。

• Zoomの同意画面から離脱せずに、最後まで進めてください。

「このZoomアカウントは既に別の組織に接続されています。」

• Zoomアカウントは1つのSteve組織にのみ接続できます。先にその組織で切断するか、tech@hiresteve.ai までご連絡ください。

Zoom RAタブがグレーアウトしている

• プランにCall Recordingが含まれていません。カードの代わりにアップグレード案内が表示されます。管理者にご相談ください。

接続済みなのに新しい通話が届かなくなった

• Steveが保持している認可が使えなくなっている可能性があります（Zoom側でアプリが削除された、認可が取り消されたなど）。Steveは接続を削除したときにしか接続を外さないため、カードには 接続済み（メールアドレス） が表示され続けます。Delete Account をクリックして確定し、続けて 接続 をクリックして再認可してください。

Zoomでアプリを削除したのに、Steveでは「接続済み」のままになっている

• Zoom App Marketplaceでアプリを削除するとZoom側のトークンは無効化されますが、Steveは次の呼び出しが失敗するまでそれを検知しないため、カードには古い接続が表示され続けることがあります。Settings → Call Recording → Zoom RA で Delete Account をクリックし、保存されている認証情報を削除してください。アプリを削除する を参照。

Steveで切断したのに、Zoomアカウントにアプリが残っている

• 仕様どおりです。両者は独立して削除します。Zoom App Marketplace → Manage → Added Apps → Steve Call Insights → Remove から削除してください。

接続済みなのに通話が出てこない

上から順に確認してください。

1. ZRAライセンスを確認。 Revenue Acceleratorのサブスクリプションが無いアカウントでも認可自体は成功し（OAuthはアカウント全体に及ぶため）、その後何も返ってきません。最も多い原因です。
2. 通話が録音されているか確認。 ZRAは録音された会話のみを分析します。録音されていないミーティングは、この連携にとって存在しません。
3. ZRAの処理完了を確認。 終わったばかりの通話はまだ利用できないことがあります。時間を置いてください。
4. 初回インポートの時間を見込む。 初回同期は3か月分をバックフィルするため、履歴が多いと時間がかかります。
5. 対象期間を確認。 初回以降、Steveは直近1日分しか見ません。取り込まれなかった古い通話が後から拾われることはありません。

通話は入るがトランスクリプトが空

• Zoomアカウントで 音声文字起こしが無効 です。有効にしてください。ただしトランスクリプトが付くのは、それ以降に録音された通話のみです。
• 通話がごく短かったか、Steveが取り込んだ時点でZRAがまだ処理中だった 場合、ZRAにはトランスクリプトがありません。

既に取り込まれた通話は再取得されないため、設定を直しても過去のトランスクリプトは埋まりません。

トランスクリプトはあるがブリーフやキーポイントが無い

その通話のAI要約が失敗しました。Steveは通話を破棄せず、あえて取り込みます — トランスクリプトは検索可能で、競合検出にも使われます。一部ではなく全体で発生している場合は サポート までご連絡ください。

Zoom通話から競合インサイトが出てこない

• トランスクリプトが空でないか確認。 トランスクリプトが無ければ検出対象もありません。
• 競合がプロジェクトで追跡されているか確認。 Steveはプロジェクトが追跡している競合のみを検出します。
• インサイトレビュー の Zoom Revenue Accelerator タブを確認してください。インサイトは存在し、判断待ちかもしれません。
• 組織の承認設定を確認。 通話インサイトの Enable Automatic Approval がオンでない限り、Triageで人が承認するまでナレッジベースに入りません。

通話は表示されるが一覧の内容がおかしい

それでも解決しない場合

1. Settings → Call Recording → Zoom RA に緑のドットと {email}として接続済み が表示されているか確認します。
2. 接続を削除（Delete Account）してから再接続します。可能であれば Zoomアカウント管理者 で行ってください。
3. Zoom側のZRAライセンス、クラウドレコーディング、音声文字起こしを確認します。
4. サポートに連絡 — お気軽にどうぞ。

次のステップ

• 要件 — ライセンスのチェックリスト。
• FAQ — よくある質問。
• サポート — 担当者に相談する。