---
title: "Trình Kết Nối Zoom"
description: "Hướng dẫn tích hợp Zoom đầy đủ để đồng bộ meetings, webinars, participants và engagement data với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/custom/zoom/
markdown: https://tajo.io/vi/docs/connectors/custom/zoom.md
lang: vi-VN
robots: noindex
---

Đăng ký quyền truy cập sớm

Nhập tên và địa chỉ email công việc của bạn. Chúng tôi sẽ gửi liên kết để xác nhận yêu cầu truy cập Tajo.

# Trình Kết Nối Zoom

Trạng thái trình kết nối: Dự kiến Chưa được xây dựng. Hiện Tajo chưa chạy trình kết nối này.

| Trường nguồn | Trường đích | Giá trị mẫu |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Kết nối Zoom với Brevo qua Tajo để đồng bộ webinar attendees sang danh sách Brevo, theo dõi mức độ tham gia meetings và kích hoạt follow-up campaigns sau webinars.

## Tổng Quan

| Thuộc Tính | Giá Trị |
| --- | --- |
| **Nền Tảng** | Zoom |
| **Danh Mục** | Tùy Chỉnh |
| **Độ Phức Tạp Thiết Lập** | Trung Bình |
| **Tích Hợp Chính Thức** | Không |
| **Dữ Liệu Đồng Bộ** | Meetings, Webinars, Participants, Recordings |
| **Loại API** | REST API v2 |
| **Xác Thực** | Server-to-Server OAuth |

## Tính Năng

- **Đồng bộ webinar attendees** - Nhập người đăng ký và người tham dự webinar vào Brevo
- **Theo dõi tham gia** - Đồng bộ thời gian tham gia meetings sang thuộc tính liên hệ
- **Tự động follow-up** - Kích hoạt campaigns khác nhau cho người tham dự vs. không tham dự
- **Đồng bộ đăng ký** - Thêm người đăng ký webinar vào danh sách Brevo ngay lập tức
- **Số liệu engagement** - Nhập dữ liệu Q&A, polls và thời gian xem

## Yêu Cầu

Trước khi bắt đầu, hãy đảm bảo bạn có:

1. Tài khoản Zoom (Pro, Business, Education, hoặc Enterprise)
2. Zoom Server-to-Server OAuth App
3. Tài khoản Brevo với quyền truy cập API
4. Tài khoản Tajo

## Xác Thực

### Server-to-Server OAuth (Khuyến Nghị)

Zoom khuyến nghị Server-to-Server OAuth cho tích hợp server-side.

```bash
# Lấy access token
curl -X POST "https://zoom.us/oauth/token?grant_type=account_credentials&account_id=YOUR_ACCOUNT_ID" \
  -H "Authorization: Basic BASE64(CLIENT_ID:CLIENT_SECRET)"
```

```bash
# Sử dụng access token
curl "https://api.zoom.us/v2/users/me/webinars" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

### Kết Nối với Tajo

```bash
tajo connectors install zoom \
  --account-id $ZOOM_ACCOUNT_ID \
  --client-id $ZOOM_CLIENT_ID \
  --client-secret $ZOOM_CLIENT_SECRET
```

## Cấu Hình

### Thiết Lập Cơ Bản

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

    sync:
      webinars: true
      meetings: false
      registrants: true
      attendees: true

    # Ánh xạ webinar sang danh sách Brevo
    webinar_list_mapping:
      default: 50  # Danh sách mặc định cho tất cả webinars
      attended: 51  # Danh sách cho người đã tham dự
      no_show: 52   # Danh sách cho người không tham dự
```

### Ánh Xạ Trường

```yaml
field_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Dữ liệu webinar
  status: WEBINAR_STATUS
  join_time: WEBINAR_JOIN_TIME
  leave_time: WEBINAR_LEAVE_TIME
  duration: WEBINAR_DURATION_MINS

  # Câu hỏi đăng ký tùy chỉnh
  custom_questions.company: COMPANY_NAME
  custom_questions.job_title: JOB_TITLE
```

## API Endpoints

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `GET` | `/v2/users/{userId}/webinars` | Liệt kê webinars |
| `GET` | `/v2/webinars/{webinarId}` | Chi tiết webinar |
| `GET` | `/v2/webinars/{webinarId}/registrants` | Danh sách đăng ký |
| `GET` | `/v2/webinars/{webinarId}/attendees` | Danh sách người tham dự |
| `GET` | `/v2/users/{userId}/meetings` | Liệt kê meetings |
| `GET` | `/v2/meetings/{meetingId}/participants` | Participants của meeting |
| `POST` | `/v2/webhooks` | Tạo webhook subscription |

## Ví Dụ Code

### Khởi Tạo Trình Kết Nối

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

### Đồng Bộ Webinar Attendees Sau Sự Kiện

```javascript
// Đồng bộ attendees sau khi webinar kết thúc
await tajo.connectors.sync('zoom', {
  webinarId: '12345678901',
  type: 'post_event',
  resources: ['registrants', 'attendees'],
  segmentByAttendance: true,  // Phân loại thành attended/no-show
  brevoListIds: {
    attended: 51,
    no_show: 52
  }
});
```

Header Giới Hạn Tốc Độ

Zoom API bao gồm headers `X-RateLimit-Limit`, `X-RateLimit-Remaining`, và `X-RateLimit-Reset`. Theo dõi những header này để tránh vượt giới hạn trong quá trình đồng bộ sau webinar lớn.

## Giới Hạn Tốc Độ

| Tài Nguyên | Giới Hạn |
| --- | --- |
| REST API tổng thể | 100 yêu cầu/giây |
| List endpoints | 300 yêu cầu/giờ |
| Report endpoints | 100 yêu cầu/ngày |

## Khắc Phục Sự Cố

| Sự Cố | Nguyên Nhân | Giải Pháp |
| --- | --- | --- |
| 401 Unauthorized | Token hết hạn | Tokens Server-to-Server hết hạn sau 1 giờ; tự động refresh |
| Attendees rỗng | Webinar chưa kết thúc | Dữ liệu attendees chỉ có sau khi webinar kết thúc |
| Registrants thiếu | Đăng ký ở page khác | Kiểm tra các trang webinar riêng biệt |
| Quyền không đủ | Scopes thiếu | Thêm scopes cần thiết vào Server-to-Server App |

## Tài Nguyên Liên Quan

- [Tài Liệu API Zoom](https://developers.zoom.us/docs/api/)
- [Zoom Server-to-Server OAuth](https://developers.zoom.us/docs/internal-apps/)
- [Customer Sync Skill](https://tajo.io/vi/docs/skills/data-sync/customer-sync)