Zoom Connector

เชื่อมต่อ Zoom กับ Brevo ผ่าน Tajo เพื่อซิงค์ผู้เข้าร่วมประชุมและผู้เข้าร่วม webinar เป็นผู้ติดต่อโดยอัตโนมัติ ทริกเกอร์ลำดับการติดตามหลังการประชุม และติดตาม engagement metrics สำหรับระบบอัตโนมัติทางการตลาดของคุณ

ภาพรวม

คุณสมบัติค่า
แพลตฟอร์มZoom
หมวดหมู่Video Conferencing (แบบกำหนดเอง)
ความซับซ้อนในการตั้งค่าปานกลาง
การผสานรวมอย่างเป็นทางการไม่
ข้อมูลที่ซิงค์ผู้เข้าร่วม เหตุการณ์ Webinars ผู้ติดต่อ
วิธีการยืนยันตัวตนOAuth 2.0 / Server-to-Server OAuth

ฟีเจอร์

  • การซิงค์ผู้เข้าร่วม - สร้างผู้ติดต่อ Brevo อัตโนมัติจากผู้เข้าร่วมประชุม
  • การจับผู้เข้าร่วม webinar - ซิงค์ผู้ลงทะเบียนและผู้เข้าร่วม webinar
  • ทริกเกอร์เหตุการณ์ประชุม - เปิดใช้งานระบบอัตโนมัติเมื่อประชุมเริ่ม สิ้นสุด และเหตุการณ์บันทึก
  • การติดตาม engagement - ติดตามระยะเวลาการเข้าร่วมและ participation metrics
  • การติดตาม webinar - ทริกเกอร์ลำดับอีเมลที่กำหนดเป้าหมายตามการเข้าร่วม webinar
  • การแจ้งเตือนการบันทึก - ส่งลิงก์บันทึกผ่านแคมเปญอีเมล Brevo

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

  1. บัญชี Zoom (แผน Pro หรือสูงกว่า)
  2. Zoom Server-to-Server OAuth app หรือ OAuth app ผ่าน Zoom App Marketplace
  3. บัญชี Brevo ที่มีสิทธิ์เข้าถึง API
  4. บัญชี Tajo ที่มีสิทธิ์ connector

การยืนยันตัวตน

Server-to-Server OAuth (แนะนำ)

Terminal window
# Create a Server-to-Server OAuth app at marketplace.zoom.us
export ZOOM_ACCOUNT_ID=your_account_id
export ZOOM_CLIENT_ID=your_client_id
export ZOOM_CLIENT_SECRET=your_client_secret
// Get access token via 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 (ระดับผู้ใช้)

// Authorization URL for user-level OAuth
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'
});
// Exchange code for tokens
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 Endpoints

Endpointเมธอดคำอธิบาย
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แสดงรายการ webinars
https://api.zoom.us/v2/webinars/{webinarId}/registrantsGETแสดงรายการผู้ลงทะเบียน webinar
https://api.zoom.us/v2/webinars/{webinarId}/participantsGETแสดงรายการผู้เข้าร่วม webinar
https://api.zoom.us/v2/meetings/{meetingId}/recordingsGETดูการบันทึกประชุม
https://api.zoom.us/v2/webhooksPOSTสมัครรับ webhooks

ตัวอย่างโค้ด

เริ่มต้น Connector

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

ซิงค์ผู้เข้าร่วมประชุม

// Retrieve past meeting participants
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]
});
}
}

ซิงค์ผู้เข้าร่วม Webinar

// Get webinar attendees and sync to 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 Webhooks

app.post('/webhooks/zoom', async (req, res) => {
// Handle Zoom URL validation challenge
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
});
}
// Verify webhook signature
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');
});

ขีดจำกัดอัตรา

หมวดหมู่ขีดจำกัดหมายเหตุ
Light API calls30 คำขอ/วินาทีGET ข้อมูลผู้ใช้ ประชุม
Medium API calls20 คำขอ/วินาทีแสดงรายการผู้เข้าร่วม webinars
Heavy API calls10 คำขอ/วินาทีReports การบันทึก
ขีดจำกัดรายวัน5,000+ขึ้นอยู่กับระดับแผน

Rate Limit Headers

Zoom ส่งคืน headers X-RateLimit-Limit, X-RateLimit-Remaining และ Retry-After ใช้ backoff logic ตาม headers เหล่านี้เพื่อหลีกเลี่ยงข้อผิดพลาด 429

การแก้ไขปัญหา

ปัญหาสาเหตุวิธีแก้
401 UnauthorizedToken หมดอายุRefresh Server-to-Server OAuth token
ผู้เข้าร่วมหายไปประชุมยังไม่สิ้นสุดรอจนประชุมสิ้นสุดเพื่อข้อมูลที่สมบูรณ์
การตรวจสอบ webhook ล้มเหลวSecret ไม่ถูกต้องตรวจสอบ webhook secret ใน Zoom Marketplace
ไม่มีข้อมูลอีเมลผู้เข้าร่วมเป็น Guestเปิดใช้งาน registration เพื่อจับอีเมล
Rate limit 429คำขอมากเกินไปใช้ exponential backoff

โหมด Debug

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

แนวทางปฏิบัติที่ดีที่สุด

  1. ใช้ Server-to-Server OAuth - การยืนยันตัวตนที่ง่ายกว่าโดยไม่ต้องมีการโต้ตอบกับผู้ใช้
  2. เปิดใช้งาน webinar registration - จำเป็นสำหรับการจับอีเมลของผู้เข้าร่วม
  3. ประมวลผลหลังประชุมสิ้นสุด - ข้อมูลผู้เข้าร่วมสมบูรณ์เฉพาะหลังประชุมสิ้นสุด
  4. แบ่งกลุ่มตามประเภทเหตุการณ์ - กำหนดรายการ Brevo ที่แตกต่างกันสำหรับการประชุม vs webinars
  5. ติดตาม engagement metrics - ใช้ระยะเวลาและเวลาเข้าร่วมสำหรับ lead scoring
  6. ส่งการติดตามการบันทึก - ทำให้การส่งลิงก์บันทึกผ่าน Brevo เป็นอัตโนมัติ

ความปลอดภัย

  • OAuth 2.0 - Server-to-Server หรือ user-level OAuth authentication
  • การตรวจสอบ webhook - การตรวจสอบลายเซ็น HMAC-SHA256
  • การตรวจสอบ URL - การตรวจสอบ challenge-response สำหรับ webhook endpoints
  • สิทธิ์ที่กำหนดขอบเขต - ขอ OAuth scopes ขั้นต่ำที่จำเป็น
  • การหมุนเวียน token - Server-to-Server tokens หมดอายุอัตโนมัติ (1 ชั่วโมง)
  • การส่งข้อมูลที่เข้ารหัส - TLS 1.2+ สำหรับการสื่อสาร API ทั้งหมด

แหล่งข้อมูลที่เกี่ยวข้อง

Subscribe to updates

developer-docs

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

auto-detect
ผู้ช่วย AI

สวัสดี! ถามฉันเกี่ยวกับเอกสารได้เลย