Zoom 連携の使い方

Maira と Zoom を連携すると、エージェント担当者は 1on1 キャリア面談の予約・録画取り込み (文字起こし → 履歴書 AI ドラフト)を 1 つの画面で 完結できます。 本ページでは 接続から 解除までの 操作手順を 順番に 説明します。

概要 — Maira × Zoom で できること

  • Maira から クライアント(求職者)と の 1on1 面談を Zoom 会議として 1 クリックで予約
  • 会議終了後、Cloud Recording の 自動取り込み + 文字起こし
  • 文字起こしから AI(Anthropic Claude)が 履歴書 / 職務経歴書の 下書きを 自動生成
  • クライアントの ダッシュボードに 「会議に参加」ボタンが 常時表示
  • 再スケジュール / キャンセルも Maira から実行 → Zoom と 自動同期、クライアントにも 通知

連携は ユーザー単位(User-managed) です。エージェント 担当者 一人ひとりが ご自身の Zoom アカウントを 接続する形 になります。

Step 1 — Zoom を Maira に接続する

  1. Maira にエージェント担当者として ログインします。
  2. 画面右上のメニュー → 設定 → 連携・アドオン を 開きます。 (直接 URL は /agency/settings/integrations )
  3. 「Zoom 連携」カードの 「Zoom に接続する」ボタンを クリック します。
  4. Zoom の OAuth 同意画面が 開きます。要求された スコープを 確認し 「Allow」を 押します。
  5. 自動的に Maira の 設定 → 連携・アドオン ページに 戻り、 「接続中」バッジが 表示されれば 完了です。

※ Maira 側に 保存される Zoom OAuth アクセス / リフレッシュトークンは AES-256-GCM 方式で 暗号化されます。詳細は プライバシーポリシー 第 7-1 条 を ご覧ください。

Step 2 — Maira から Zoom 面談を 予約する

  1. クライアント詳細画面 を 開きます。
  2. 「面談を予約」ボタンを クリック → ダイアログが 開きます。
  3. サービスとして「Zoom」を 選択します。
  4. タイトル(求職者にも 見える)/ 議題メモ(エージェント側のみ) / 開始日時 / 長さ を 入力します。
  5. 「予約を作成」を 押すと、Zoom 上に 会議が 自動作成され、参加 URL が 表示されます。

予約と同時に、求職者には メール + Maira 内通知が 送信され、求職者の ダッシュボードに 「会議に参加」ボタンが 表示されます。

Step 3 — 会議実施 → 録画の自動取り込み

  1. 予約された 時間に なったら、エージェント・求職者 双方が それぞれの 「参加」ボタンから Zoom 会議に 入ります。
  2. Maira から 作成した 会議は デフォルトで Cloud Recording(クラウド録画)が ON になっています。
  3. 会議終了後、Zoom 側で 録画処理が 完了するまで 数分〜数十分 かかります。
  4. 処理完了後、Maira が Webhook 通知を 受け取って 録画ファイルを 自動取り込み → OpenAI Whisper で 文字起こし → Anthropic Claude で 構造化 → 履歴書 / 職務経歴書の ドラフトを 生成します。
  5. クライアント詳細画面の「面談履歴」セクションに 取り込み結果が 表示されます。

※ Cloud Recording が ON で 録画されている 必要が あります。ローカル 録画は 取り込めません。
※ 自動取り込み は 「会議録音 自動連携」アドオン契約が 必要です。アドオン契約は 連携 / アドオンページから 申し込めます。

Step 4 — 再スケジュール / キャンセル

クライアント詳細画面の 面談履歴の 行末「⋯」メニューから 操作できます。

  • 再スケジュール:Zoom 側の 会議も 更新され、求職者には 更新通知が 送られます。 新しい .ics ファイルが 添付されます。
  • キャンセル:Zoom 側の 会議も 削除され、求職者には キャンセル通知が 送られます。

Step 5 — Zoom 連携を 解除する

  1. Maira → 設定 → 連携・アドオン ページを 開きます。
  2. 「Zoom 連携」カードの 「Zoom 連携を解除」 を 押します。
  3. Maira 側に 保管されている アクセストークン / リフレッシュトークンが即座に 破棄 されます。
  4. さらに Zoom 側でも アプリの 認可を 取り消したい場合は Zoom Marketplace の Installed Apps ページ で 「Maira」を Remove してください。

要求する スコープ と その理由

Scope用途
user:read:user接続ユーザの Zoom アカウントを Maira と 紐づける
meeting:read:meeting予約済み会議の詳細(時刻 / 参加 URL)表示
meeting:read:list_meetings予定一覧の表示 / 重複予約の検知
meeting:write:meetingMaira から 1on1 面談を 新規予約
meeting:update:meeting面談の再スケジュール
meeting:delete:meeting面談のキャンセル
cloud_recording:read:list_user_recordings終了直後の 録画存在検知(自動取り込み)
cloud_recording:read:recording録画ファイルの ダウンロード → 文字起こし

個々のスコープの 詳細な 用途と データ取り扱い 方針は プライバシーポリシー 第 7-1 条 を ご覧ください。

トラブルシューティング

「Zoom に接続する」を 押すと エラー画面に 飛ぶ

多くは 以下のいずれかが 原因です:

  • Zoom にログインしていない / 別アカウントに ログイン中
  • Zoom 側で アプリ「Maira」の 認可を 取り消している
  • ブラウザの拡張機能(広告ブロッカー等)が OAuth フローを 妨害している

解決策: シークレットウィンドウで Zoom にログインし直してから 再試行してください。それでも 解決しない場合は サポート までご連絡ください。

会議は 作成されたが、録画が 取り込まれない
  • 会議が Cloud Recording で 録画されたか 確認 → ローカル録画は 対象外です
  • Zoom 側で 録画処理が 完了しているか(終了直後は 数分〜数十分 かかる)
  • 「会議録音 自動連携」アドオン契約が 有効か
  • 連携時に cloud_recording:read:* 2 つの スコープが 承認 済みか
予約した 面談が 求職者の 画面に 表示されない

求職者が 招待を 受諾して Maira アカウントを 作成し終わっているか 確認してください。 招待状態(invited)では まだ 表示されません(linked 状態に なる必要が あります)。

エラーコード が 表示された(例:4700 / 4702)
  • 4700 / Invalid Redirect: Maira 側設定の問題。 画面の URL と エラー内容を 添えて サポートまでご連絡ください。
  • 4702 / Invalid Client ID: Maira 側設定の問題。同上。

サポート

上記で 解決しない場合は サポートページ から お問い合わせください(メール:support@maira.pro)。

画面の スクリーンショット と 「Zoom に接続する」を 押した直後の URL を 添付すると 原因特定が 早くなります。