Zoom コネクタ
Tajo を介して Zoom を Brevo に接続し、ミーティング参加者とウェビナー参加者を自動的に連絡先として同期し、ミーティング後のフォローアップシーケンスをトリガーし、マーケティング自動化のエンゲージメントメトリクスをトラッキングします。
概要
| プロパティ | 値 |
|---|---|
| プラットフォーム | Zoom |
| カテゴリ | ビデオ会議(カスタム) |
| セットアップの複雑さ | 中 |
| 公式統合 | いいえ |
| 同期データ | 参加者、イベント、ウェビナー、連絡先 |
| 認証方式 | OAuth 2.0 / Server-to-Server OAuth |
機能
- 参加者同期 - ミーティング参加者から Brevo 連絡先を自動作成
- ウェビナー参加者のキャプチャ - ウェビナー登録者と参加者を同期
- ミーティングイベントトリガー - ミーティング開始、終了、録画イベント時に自動化を発火
- エンゲージメントトラッキング - 出席時間と参加メトリクスをトラッキング
- ウェビナーフォローアップ - ウェビナー参加状況に基づくターゲットメールシーケンスをトリガー
- 録画通知 - Brevo メールキャンペーン経由で録画リンクを送信
前提条件
開始する前に、以下を準備してください。
- Zoom アカウント(Pro プラン以上)
- Zoom App Marketplace 経由の Zoom Server-to-Server OAuth アプリまたは OAuth アプリ
- API アクセス可能な Brevo アカウント
- コネクタ権限を持つ Tajo アカウント
認証
Server-to-Server OAuth(推奨)
# marketplace.zoom.us で Server-to-Server OAuth アプリを作成export ZOOM_ACCOUNT_ID=your_account_idexport ZOOM_CLIENT_ID=your_client_idexport 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 の認可 URLconst 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_SOURCEAPI エンドポイント
| エンドポイント | メソッド | 説明 |
|---|---|---|
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 を購読 |
コード例
コネクタの初期化
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-Limit、X-RateLimit-Remaining、Retry-After ヘッダーを返します。429 エラーを回避するため、これらのヘッダーに基づいたバックオフロジックを実装してください。
トラブルシューティング
| 問題 | 原因 | 解決策 |
|---|---|---|
| 401 Unauthorized | トークンの期限切れ | Server-to-Server OAuth トークンをリフレッシュ |
| 参加者の欠落 | ミーティングが終了していない | 完全なデータが得られるまでミーティング終了を待つ |
| Webhook 検証が失敗 | シークレットが間違っている | Zoom Marketplace で Webhook シークレットを確認 |
| メールデータなし | ゲスト参加者 | メールをキャプチャするため登録を有効化 |
| レート制限 429 | リクエスト過多 | 指数バックオフを実装 |
デバッグモード
connectors: zoom: debug: true log_level: verbose log_webhooks: trueベストプラクティス
- Server-to-Server OAuth を使用する - ユーザー操作なしのシンプルな認証
- ウェビナー登録を有効化する - 参加者のメールアドレスをキャプチャするために必要
- ミーティング終了後に処理する - 参加者データはミーティング終了後にのみ完全になる
- イベントタイプでセグメント化する - ミーティングとウェビナーに異なる Brevo リストを割り当て
- エンゲージメントメトリクスをトラッキングする - リードスコアリングに duration と join time を使用
- 録画フォローアップを送信する - Brevo 経由で録画リンク配信を自動化
セキュリティ
- OAuth 2.0 - Server-to-Server またはユーザーレベル OAuth 認証
- Webhook 検証 - HMAC-SHA256 署名検証
- URL 検証 - Webhook エンドポイントのチャレンジレスポンス検証
- スコープ付き権限 - 必要最小限の OAuth スコープをリクエスト
- トークンローテーション - Server-to-Server トークンは自動的に期限切れ(1 時間)
- 暗号化された通信 - すべての API 通信に TLS 1.2 以上