---
title: "Zoom コネクタ"
description: "Tajo を介して Zoom のミーティング参加者、ウェビナー参加者、エンゲージメントデータを Brevo と同期するための完全な Zoom 統合ガイド。"
url: https://tajo.io/jp/docs/connectors/custom/zoom/
markdown: https://tajo.io/jp/docs/connectors/custom/zoom.md
lang: ja-JP
robots: noindex
---

先行利用を申し込む

お名前と会社のメールアドレスを入力してください。Tajoへのアクセス申請を確認するためのリンクをメールでお送りします。

# Zoom コネクタ

コネクターのステータス: 予定 まだ構築されていません。Tajo は現在このコネクターを実行していません。

| 送信元フィールド | 送信先フィールド | サンプル値 |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Tajo を介して Zoom を Brevo に接続し、ミーティング参加者とウェビナー参加者を自動的に連絡先として同期し、ミーティング後のフォローアップシーケンスをトリガーし、マーケティング自動化のエンゲージメントメトリクスをトラッキングします。

## 概要

| プロパティ | 値 |
| --- | --- |
| **プラットフォーム** | Zoom |
| **カテゴリ** | ビデオ会議(カスタム) |
| **セットアップの複雑さ** | 中 |
| **公式統合** | いいえ |
| **同期データ** | 参加者、イベント、ウェビナー、連絡先 |
| **認証方式** | OAuth 2.0 / Server-to-Server OAuth |

## 機能

- **参加者同期** - ミーティング参加者から Brevo 連絡先を自動作成
- **ウェビナー参加者のキャプチャ** - ウェビナー登録者と参加者を同期
- **ミーティングイベントトリガー** - ミーティング開始、終了、録画イベント時に自動化を発火
- **エンゲージメントトラッキング** - 出席時間と参加メトリクスをトラッキング
- **ウェビナーフォローアップ** - ウェビナー参加状況に基づくターゲットメールシーケンスをトリガー
- **録画通知** - Brevo メールキャンペーン経由で録画リンクを送信

## 前提条件

開始する前に、以下を準備してください。

1. Zoom アカウント(Pro プラン以上)
2. [Zoom App Marketplace](https://marketplace.zoom.us/) 経由の Zoom Server-to-Server OAuth アプリまたは OAuth アプリ
3. API アクセス可能な Brevo アカウント
4. コネクタ権限を持つ Tajo アカウント

## 認証

### Server-to-Server OAuth(推奨)

```bash
# marketplace.zoom.us で Server-to-Server OAuth アプリを作成
export ZOOM_ACCOUNT_ID=your_account_id
export ZOOM_CLIENT_ID=your_client_id
export ZOOM_CLIENT_SECRET=your_client_secret
```

```javascript
// Server-to-Server OAuth 経由でアクセストークンを取得
const tokenResponse = await fetch('https://zoom.us/oauth/token', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${Buffer.from(
      `${process.env.ZOOM_CLIENT_ID}:${process.env.ZOOM_CLIENT_SECRET}`
    ).toString('base64')}`,
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams({
    grant_type: 'account_credentials',
    account_id: process.env.ZOOM_ACCOUNT_ID
  })
});

const { access_token } = await tokenResponse.json();
```

### OAuth 2.0(ユーザーレベル)

```javascript
// ユーザーレベル OAuth の認可 URL
const authUrl = 'https://zoom.us/oauth/authorize?' +
  new URLSearchParams({
    client_id: process.env.ZOOM_CLIENT_ID,
    redirect_uri: 'https://your-app.com/callback',
    response_type: 'code'
  });

// コードをトークンと交換
const tokenResponse = await fetch('https://zoom.us/oauth/token', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${Buffer.from(
      `${process.env.ZOOM_CLIENT_ID}:${process.env.ZOOM_CLIENT_SECRET}`
    ).toString('base64')}`,
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams({
    grant_type: 'authorization_code',
    code: authorizationCode,
    redirect_uri: 'https://your-app.com/callback'
  })
});
```

## 設定

### 基本セットアップ

```yaml
connectors:
  zoom:
    enabled: true
    account_id: "${ZOOM_ACCOUNT_ID}"
    client_id: "${ZOOM_CLIENT_ID}"
    client_secret: "${ZOOM_CLIENT_SECRET}"

    sync:
      participants: true
      webinars: true
      recordings: true

    webhook:
      secret_token: "${ZOOM_WEBHOOK_SECRET}"
      verification_token: "${ZOOM_VERIFICATION_TOKEN}"

    lists:
      meeting_participants: 15
      webinar_attendees: 16
      webinar_registrants: 17
```

### フィールドマッピング

```yaml
field_mapping:
  email: email
  name: FIRSTNAME
  join_time: MEETING_JOIN_DATE
  duration: MEETING_DURATION
  webinar_title: WEBINAR_NAME
  attendance_status: ATTENDANCE_STATUS
  registration_source: UTM_SOURCE
```

## API エンドポイント

| エンドポイント | メソッド | 説明 |
| --- | --- | --- |
| `https://api.zoom.us/v2/users` | GET | ユーザーを一覧取得 |
| `https://api.zoom.us/v2/users/{userId}/meetings` | GET | ミーティングを一覧取得 |
| `https://api.zoom.us/v2/meetings/{meetingId}` | GET | ミーティング詳細を取得 |
| `https://api.zoom.us/v2/past_meetings/{meetingId}/participants` | GET | 過去のミーティング参加者を一覧取得 |
| `https://api.zoom.us/v2/users/{userId}/webinars` | GET | ウェビナーを一覧取得 |
| `https://api.zoom.us/v2/webinars/{webinarId}/registrants` | GET | ウェビナー登録者を一覧取得 |
| `https://api.zoom.us/v2/webinars/{webinarId}/participants` | GET | ウェビナー参加者を一覧取得 |
| `https://api.zoom.us/v2/meetings/{meetingId}/recordings` | GET | ミーティング録画を取得 |
| `https://api.zoom.us/v2/webhooks` | POST | Webhook を購読 |

## コード例

### コネクタの初期化

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

await tajo.connectors.connect('zoom', {
  accountId: process.env.ZOOM_ACCOUNT_ID,
  clientId: process.env.ZOOM_CLIENT_ID,
  clientSecret: process.env.ZOOM_CLIENT_SECRET
});
```

### ミーティング参加者を同期

```javascript
// 過去のミーティング参加者を取得
const response = await fetch(
  `https://api.zoom.us/v2/past_meetings/${meetingId}/participants`,
  {
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'Content-Type': 'application/json'
    }
  }
);

const { participants } = await response.json();

for (const participant of participants) {
  if (participant.user_email) {
    await tajo.contacts.sync({
      email: participant.user_email,
      attributes: {
        FIRSTNAME: participant.name,
        MEETING_DURATION: participant.duration,
        MEETING_JOIN_DATE: participant.join_time,
        ATTENDANCE_STATUS: 'attended'
      },
      listIds: [15]
    });
  }
}
```

### ウェビナー参加者を同期

```javascript
// ウェビナー参加者を取得して Brevo に同期
const attendeesResponse = await fetch(
  `https://api.zoom.us/v2/past_webinars/${webinarId}/participants`,
  {
    headers: { 'Authorization': `Bearer ${accessToken}` }
  }
);

const { participants: attendees } = await attendeesResponse.json();

for (const attendee of attendees) {
  await tajo.contacts.sync({
    email: attendee.user_email,
    attributes: {
      FIRSTNAME: attendee.name,
      WEBINAR_NAME: webinarTitle,
      ATTENDANCE_STATUS: 'attended',
      MEETING_DURATION: attendee.duration
    },
    listIds: [16]
  });
}
```

### Zoom Webhook の処理

```javascript
app.post('/webhooks/zoom', async (req, res) => {
  // Zoom URL 検証チャレンジを処理
  if (req.body.event === 'endpoint.url_validation') {
    const hashForValidation = crypto
      .createHmac('sha256', process.env.ZOOM_WEBHOOK_SECRET)
      .update(req.body.payload.plainToken)
      .digest('hex');

    return res.json({
      plainToken: req.body.payload.plainToken,
      encryptedToken: hashForValidation
    });
  }

  // Webhook 署名を検証
  const message = `v0:${req.headers['x-zm-request-timestamp']}:${JSON.stringify(req.body)}`;
  const hash = crypto
    .createHmac('sha256', process.env.ZOOM_WEBHOOK_SECRET)
    .update(message)
    .digest('hex');
  const signature = `v0=${hash}`;

  if (req.headers['x-zm-signature'] !== signature) {
    return res.status(401).send('Unauthorized');
  }

  const { event, payload } = req.body;

  await tajo.connectors.handleWebhook('zoom', {
    topic: event,
    payload: payload
  });

  res.status(200).send('OK');
});
```

## レート制限

| カテゴリ | 制限 | 備考 |
| --- | --- | --- |
| 軽量 API 呼び出し | 30 req/秒 | GET ユーザー、ミーティング情報 |
| 中量 API 呼び出し | 20 req/秒 | 参加者、ウェビナー一覧 |
| 重量 API 呼び出し | 10 req/秒 | レポート、録画 |
| 日次制限 | 5,000 以上 | プランレベルに依存 |

レート制限ヘッダー

Zoom は `X-RateLimit-Limit`、`X-RateLimit-Remaining`、`Retry-After` ヘッダーを返します。429 エラーを回避するため、これらのヘッダーに基づいたバックオフロジックを実装してください。

## トラブルシューティング

| 問題 | 原因 | 解決策 |
| --- | --- | --- |
| 401 Unauthorized | トークンの期限切れ | Server-to-Server OAuth トークンをリフレッシュ |
| 参加者の欠落 | ミーティングが終了していない | 完全なデータが得られるまでミーティング終了を待つ |
| Webhook 検証が失敗 | シークレットが間違っている | Zoom Marketplace で Webhook シークレットを確認 |
| メールデータなし | ゲスト参加者 | メールをキャプチャするため登録を有効化 |
| レート制限 429 | リクエスト過多 | 指数バックオフを実装 |

### デバッグモード

```yaml
connectors:
  zoom:
    debug: true
    log_level: verbose
    log_webhooks: true
```

## ベストプラクティス

1. **Server-to-Server OAuth を使用する** - ユーザー操作なしのシンプルな認証
2. **ウェビナー登録を有効化する** - 参加者のメールアドレスをキャプチャするために必要
3. **ミーティング終了後に処理する** - 参加者データはミーティング終了後にのみ完全になる
4. **イベントタイプでセグメント化する** - ミーティングとウェビナーに異なる Brevo リストを割り当て
5. **エンゲージメントメトリクスをトラッキングする** - リードスコアリングに duration と join time を使用
6. **録画フォローアップを送信する** - Brevo 経由で録画リンク配信を自動化

## セキュリティ

- **OAuth 2.0** - Server-to-Server またはユーザーレベル OAuth 認証
- **Webhook 検証** - HMAC-SHA256 署名検証
- **URL 検証** - Webhook エンドポイントのチャレンジレスポンス検証
- **スコープ付き権限** - 必要最小限の OAuth スコープをリクエスト
- **トークンローテーション** - Server-to-Server トークンは自動的に期限切れ(1 時間)
- **暗号化された通信** - すべての API 通信に TLS 1.2 以上

## 関連リソース

- [Calendly コネクタ](https://tajo.io/jp/docs/connectors/custom/calendly)
- [Zapier コネクタ](https://tajo.io/jp/docs/connectors/custom/zapier)
- [顧客同期スキル](https://tajo.io/jp/docs/skills/data-sync/customer-sync)
- [Zoom API ドキュメント](https://developers.zoom.us/docs/api/)