---
title: "Trình Kết Nối Calendly"
description: "Hướng dẫn tích hợp Calendly đầy đủ để đồng bộ sự kiện đặt lịch, invitees và dữ liệu cuộc họp với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/custom/calendly/
markdown: https://tajo.io/vi/docs/connectors/custom/calendly.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 Calendly

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 Calendly với Brevo qua Tajo để đồng bộ người đặt lịch sang liên hệ Brevo, kích hoạt email xác nhận/nhắc nhở và theo dõi tỷ lệ chuyển đổi từ cuộc họp.

## Tổng Quan

| Thuộc Tính | Giá Trị |
| --- | --- |
| **Nền Tảng** | Calendly |
| **Danh Mục** | Tùy Chỉnh |
| **Độ Phức Tạp Thiết Lập** | Dễ |
| **Tích Hợp Chính Thức** | Không |
| **Dữ Liệu Đồng Bộ** | Sự Kiện, Invitees, Loại Sự Kiện |
| **Loại API** | REST API v2 |
| **Xác Thực** | Personal Access Token hoặc OAuth |

## Tính Năng

- **Đồng bộ invitee** - Thêm người đặt lịch Calendly vào danh sách Brevo tự động
- **Kích hoạt sự kiện** - Kích hoạt email theo dõi sau khi đặt lịch hoặc hủy lịch
- **Theo dõi loại sự kiện** - Phân đoạn liên hệ theo loại cuộc hẹn đã đặt
- **Webhook theo thời gian thực** - Nhận thông báo tức thì cho sự kiện đặt lịch
- **Đồng bộ câu hỏi tùy chỉnh** - Ánh xạ câu trả lời câu hỏi invitee sang thuộc tính Brevo

## Yêu Cầu

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

1. Tài khoản Calendly (Free, Standard, Teams, hoặc Enterprise)
2. Personal Access Token hoặc OAuth credentials
3. Tài khoản Brevo với quyền truy cập API
4. Tài khoản Tajo

## Xác Thực

### Personal Access Token

```bash
curl "https://api.calendly.com/scheduled_events" \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```

Tạo tokens trong Calendly Integrations > API & Webhooks.

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

```bash
tajo connectors install calendly \
  --access-token $CALENDLY_ACCESS_TOKEN
```

## Cấu Hình

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

```yaml
connectors:
  calendly:
    enabled: true
    access_token: "${CALENDLY_ACCESS_TOKEN}"

    sync:
      scheduled_events: true
      invitees: true
      event_types: true

    # Ánh xạ loại sự kiện sang danh sách Brevo
    event_type_mapping:
      "Demo Call": 30
      "Onboarding": 31
      "Support Call": 32
```

### Ánh Xạ Trường

```yaml
field_mapping:
  email: email
  name: FULLNAME
  timezone: TIMEZONE
  questions_and_answers.company: COMPANY_NAME
  questions_and_answers.phone: SMS
  event.start_time: MEETING_DATE
  event.event_type: MEETING_TYPE
```

## API Endpoints

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `GET` | `/scheduled_events` | Liệt kê sự kiện đã lên lịch |
| `GET` | `/scheduled_events/{uuid}` | Lấy chi tiết sự kiện |
| `GET` | `/scheduled_events/{uuid}/invitees` | Invitees của sự kiện |
| `GET` | `/event_types` | Liệt kê loại sự kiện |
| `POST` | `/webhook_subscriptions` | Tạo webhook subscription |
| `GET` | `/webhook_subscriptions` | Liệt kê webhooks |

## 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('calendly', {
  accessToken: process.env.CALENDLY_ACCESS_TOKEN
});
```

### Xử Lý Webhook Đặt Lịch

```javascript
// Xử lý webhook Calendly
app.post('/webhooks/calendly', async (req, res) => {
  const { event, payload } = req.body;

  if (event === 'invitee.created') {
    await tajo.connectors.handleWebhook('calendly', {
      type: 'booking_created',
      payload: payload
    });
  }

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

Phân Trang

Calendly API sử dụng phân trang cursor. Tajo tự động xử lý phân trang nhưng hãy đặt `count` tối đa (100) để giảm số lần gọi API cho lịch sử lớn.

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

| Giới Hạn | Giá Trị |
| --- | --- |
| Yêu cầu API | 1.100 yêu cầu/giờ |
| Webhooks | Không giới hạn sự kiện |

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

| Sự Cố | Nguyên Nhân | Giải Pháp |
| --- | --- | --- |
| 401 Unauthorized | Token không hợp lệ | Tạo lại Personal Access Token |
| Invitee không đồng bộ | Webhook chưa đăng ký | Đăng ký webhook trong Calendly |
| Trường tùy chỉnh thiếu | Tên câu hỏi không khớp | Kiểm tra tên câu hỏi trong cấu hình Calendly |

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

- [Tài Liệu API Calendly](https://developer.calendly.com/api-docs)
- [Customer Sync Skill](https://tajo.io/vi/docs/skills/data-sync/customer-sync)
- [Trình Kết Nối Brevo](https://tajo.io/vi/docs/connectors/marketing/brevo)