Zoom コネクタ

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

概要

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

機能

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

前提条件

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

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

認証

Server-to-Server OAuth(推奨)

Terminal window
# 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
// 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(ユーザーレベル)

// ユーザーレベル 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'
})
});

設定

基本セットアップ

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

フィールドマッピング

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/usersGETユーザーを一覧取得
https://api.zoom.us/v2/users/{userId}/meetingsGETミーティングを一覧取得
https://api.zoom.us/v2/meetings/{meetingId}GETミーティング詳細を取得
https://api.zoom.us/v2/past_meetings/{meetingId}/participantsGET過去のミーティング参加者を一覧取得
https://api.zoom.us/v2/users/{userId}/webinarsGETウェビナーを一覧取得
https://api.zoom.us/v2/webinars/{webinarId}/registrantsGETウェビナー登録者を一覧取得
https://api.zoom.us/v2/webinars/{webinarId}/participantsGETウェビナー参加者を一覧取得
https://api.zoom.us/v2/meetings/{meetingId}/recordingsGETミーティング録画を取得
https://api.zoom.us/v2/webhooksPOSTWebhook を購読

コード例

コネクタの初期化

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
});

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

// 過去のミーティング参加者を取得
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]
});
}
}

ウェビナー参加者を同期

// ウェビナー参加者を取得して 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 の処理

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-LimitX-RateLimit-RemainingRetry-After ヘッダーを返します。429 エラーを回避するため、これらのヘッダーに基づいたバックオフロジックを実装してください。

トラブルシューティング

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

デバッグモード

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 以上

関連リソース

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
AIアシスタント

こんにちは!ドキュメントについて何でもお聞きください。