---
title: "Trình Kết Nối Pipedrive"
description: "Hướng dẫn tích hợp Pipedrive đầy đủ để đồng bộ giao dịch, người liên hệ, tổ chức và hoạt động với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/crm/pipedrive/
markdown: https://tajo.io/vi/docs/connectors/crm/pipedrive.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 Pipedrive

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 tài khoản Pipedrive của bạn với Brevo qua Tajo để đồng bộ dữ liệu pipeline bán hàng, liên kết hoạt động giao dịch với chiến dịch marketing và theo dõi khách hàng xuyên suốt hành trình mua hàng.

## Tổng Quan

| Thuộc Tính | Giá Trị |
| --- | --- |
| **Nền Tảng** | Pipedrive |
| **Danh Mục** | CRM |
| **Độ Phức Tạp Thiết Lập** | Dễ |
| **Tích Hợp Chính Thức** | Không |
| **Dữ Liệu Đồng Bộ** | Liên Hệ, Giao Dịch, Tổ Chức, Hoạt Động |
| **URL API Cơ Sở** | `https://api.pipedrive.com/v1` |

## Tính Năng

- **Đồng bộ người liên hệ** - Ánh xạ người liên hệ Pipedrive sang liên hệ Brevo với trường tùy chỉnh
- **Theo dõi giao dịch** - Đồng bộ giai đoạn giao dịch và giá trị sang thuộc tính Brevo
- **Đồng bộ tổ chức** - Liên kết dữ liệu công ty với hồ sơ liên hệ trong Brevo
- **Đồng bộ hoạt động** - Nhập lịch sử cuộc gọi, email và cuộc hẹn
- **Sự kiện giai đoạn Pipeline** - Kích hoạt chiến dịch Brevo khi giao dịch di chuyển qua các giai đoạn
- **Webhook theo thời gian thực** - Nhận cập nhật tức thì cho thay đổi giao dịch và liên hệ

## Yêu Cầu

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

1. Tài khoản Pipedrive (Essential, Advanced, Professional, Power, hoặc Enterprise)
2. Pipedrive API token
3. Tài khoản Brevo với quyền truy cập API
4. Tài khoản Tajo

## Xác Thực

### Xác Thực API Token

Pipedrive sử dụng API token được truyền qua header hoặc tham số query.

```bash
# Xác thực qua header
curl "https://api.pipedrive.com/v1/persons" \
  -H "x-api-token: YOUR_API_TOKEN"

# Xác thực qua tham số query
curl "https://api.pipedrive.com/v1/persons?api_token=YOUR_API_TOKEN"
```

Tìm API token trong Pipedrive Settings > Personal Preferences > API.

### OAuth 2.0

Cho các ứng dụng đa người dùng:

```bash
# Bước 1: Authorization URL
https://oauth.pipedrive.com/oauth/authorize
  ?client_id=YOUR_CLIENT_ID
  &redirect_uri=YOUR_REDIRECT_URI

# Bước 2: Đổi mã lấy token
curl -X POST https://oauth.pipedrive.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code&client_id=CLIENT_ID&client_secret=CLIENT_SECRET&redirect_uri=REDIRECT_URI&code=CODE"
```

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

Pipedrive trả về giới hạn tốc độ qua header: `x-ratelimit-limit`, `x-ratelimit-remaining`, và `x-ratelimit-reset`. Theo dõi các header này để tránh bị chặn.

## Cấu Hình

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

```yaml
connectors:
  pipedrive:
    enabled: true
    api_token: "${PIPEDRIVE_API_TOKEN}"

    # Tùy chọn đồng bộ dữ liệu
    sync:
      persons: true
      deals: true
      organizations: true
      activities: true

    # Ánh xạ pipeline sang Brevo
    pipeline_mapping:
      "Sales Pipeline": "sales_stage"
      "Enterprise Pipeline": "enterprise_stage"
```

### Ánh Xạ Trường

Ánh xạ trường Pipedrive sang thuộc tính liên hệ Brevo:

#### Ánh Xạ Mặc Định

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Địa chỉ email liên hệ (định danh duy nhất) |
| `name` optional | string | Tên đầy đủ của người liên hệ |
| `phone` optional | string | Ánh xạ sang thuộc tính SMS |
| `org_name` optional | string | Tên tổ chức liên quan |
| `owner_name` optional | string | Nhân viên bán hàng được giao |

#### Ánh Xạ Trường Tùy Chỉnh

```yaml
field_mapping:
  # Trường tiêu chuẩn
  email[0].value: email
  name: FULLNAME
  phone[0].value: SMS
  org_name: COMPANY_NAME

  # Trường giao dịch
  deals.value: DEAL_VALUE
  deals.stage_id: DEAL_STAGE
  deals.status: DEAL_STATUS

  # Trường tùy chỉnh
  custom_fields.plan: PLAN_TYPE
  custom_fields.industry: INDUSTRY
```

## API Endpoints

### Người Liên Hệ

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `GET` | `/v1/persons` | Liệt kê tất cả người liên hệ |
| `POST` | `/v1/persons` | Tạo người liên hệ mới |
| `PUT` | `/v1/persons/{id}` | Cập nhật người liên hệ |
| `GET` | `/v1/persons/{id}` | Lấy người liên hệ theo ID |
| `GET` | `/v1/persons/{id}/deals` | Giao dịch của người liên hệ |

### Giao Dịch

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `GET` | `/v1/deals` | Liệt kê tất cả giao dịch |
| `POST` | `/v1/deals` | Tạo giao dịch mới |
| `PUT` | `/v1/deals/{id}` | Cập nhật giao dịch |
| `GET` | `/v1/stages` | Liệt kê tất cả giai đoạn pipeline |

### Tổ Chức

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `GET` | `/v1/organizations` | Liệt kê tất cả tổ chức |
| `POST` | `/v1/organizations` | Tạo tổ chức mới |
| `GET` | `/v1/organizations/{id}/persons` | Người liên hệ trong tổ chức |

### Hoạt Động

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `GET` | `/v1/activities` | Liệt kê tất cả hoạt động |
| `POST` | `/v1/activities` | Tạo hoạt động mới |
| `GET` | `/v1/activityTypes` | Liệt kê các loại hoạt động |

## Sự Kiện

### Sự Kiện Webhook

| Sự Kiện | Kích Hoạt | Trường Hợp Sử Dụng |
| --- | --- | --- |
| `person.added` | Người liên hệ mới được tạo | Kích hoạt email chào mừng |
| `person.updated` | Dữ liệu người liên hệ thay đổi | Đồng bộ thuộc tính Brevo |
| `deal.added` | Giao dịch mới được tạo | Thông báo cho nhóm bán hàng |
| `deal.updated` | Giai đoạn giao dịch thay đổi | Cập nhật trạng thái liên hệ |
| `deal.deleted` | Giao dịch bị xóa | Đánh dấu liên hệ để theo dõi |
| `organization.updated` | Dữ liệu công ty thay đổi | Cập nhật hồ sơ công ty |

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

// Kết nối Pipedrive
await tajo.connectors.connect('pipedrive', {
  apiToken: process.env.PIPEDRIVE_API_TOKEN
});
```

### Đồng Bộ Người Liên Hệ và Giao Dịch

```javascript
// Đồng bộ tăng dần từ Pipedrive sang Brevo
await tajo.connectors.sync('pipedrive', {
  type: 'incremental',
  resources: ['persons', 'deals'],
  since: '2024-01-01',
  batchSize: 100
});

// Kiểm tra trạng thái đồng bộ
const status = await tajo.connectors.status('pipedrive');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   personsSynced: 5400,
//   dealsSynced: 1200,
//   organizationsSynced: 340
// }
```

### Xử Lý Webhook Pipedrive

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

  await tajo.connectors.handleWebhook('pipedrive', {
    type: `${event.meta.object}.${event.meta.action}`,
    payload: event
  });

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

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

| Gói | Giới Hạn | Chi Tiết |
| --- | --- | --- |
| Essential | 80 yêu cầu/2 giây | Mỗi token |
| Advanced | 80 yêu cầu/2 giây | Mỗi token |
| Professional | 80 yêu cầu/2 giây | Mỗi token |
| Enterprise | 80 yêu cầu/2 giây | Mỗi token |

Giới hạn hàng ngày:

- **API requests**: 50,000/ngày cho gói Essential và Advanced
- **API requests**: 150,000/ngày cho gói Professional và Enterprise

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

### Sự Cố Phổ Biến

| Sự Cố | Nguyên Nhân | Giải Pháp |
| --- | --- | --- |
| 401 Unauthorized | API token không hợp lệ | Xác minh token trong Pipedrive Settings > API |
| 403 Forbidden | Quyền không đủ | Kiểm tra quyền tài khoản Pipedrive |
| Người liên hệ trùng lặp | Định danh email không nhất quán | Sử dụng email làm định danh chính thức |
| Giao dịch không đồng bộ | Filter pipeline | Kiểm tra cấu hình ánh xạ pipeline |

### Chế Độ Debug

```yaml
connectors:
  pipedrive:
    debug: true
    log_level: verbose
    log_webhooks: true
```

### Kiểm Tra Kết Nối

```bash
tajo connectors test pipedrive
# ✓ API connection successful
# ✓ Persons readable
# ✓ Deals accessible
# ✓ Organizations readable
# ✓ Pipelines loaded
```

## Thực Hành Tốt Nhất

1. **Dùng email làm định danh** - Đảm bảo email nhất quán giữa Pipedrive và Brevo
2. **Ánh xạ giai đoạn pipeline** - Liên kết giai đoạn Pipedrive với phân đoạn Brevo
3. **Đồng bộ tăng dần** - Sử dụng khoảng thời gian để giảm tải API
4. **Theo dõi chủ sở hữu giao dịch** - Đồng bộ thông tin người dùng Pipedrive để định tuyến
5. **Xử lý trường tùy chỉnh** - Tạo thuộc tính Brevo trước khi đồng bộ trường tùy chỉnh

## Bảo Mật

- **Xác thực API Token** - Bảo mật dựa trên token mỗi người dùng
- **OAuth 2.0** - Xác thực dựa trên token cho ứng dụng đa người dùng
- **Mã hóa TLS** - Tất cả giao tiếp API được mã hóa qua HTTPS
- **Xác minh Webhook** - Xác thực nguồn gốc sự kiện qua IP allowlisting
- **Giám sát nhật ký** - Theo dõi sử dụng API qua nhật ký Pipedrive

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

- [Tài Liệu API Pipedrive](https://developers.pipedrive.com/docs/api/v1)
- [Hướng Dẫn Webhook Pipedrive](https://pipedrive.readme.io/docs/guide-for-webhooks)
- [Trình Kết Nối HubSpot](https://tajo.io/vi/docs/connectors/crm/hubspot)
- [Trình Kết Nối Brevo](https://tajo.io/vi/docs/connectors/marketing/brevo)
- [Customer Sync Skill](https://tajo.io/vi/docs/skills/data-sync/customer-sync)