Trình Kết Nối Pipedrive

Trình Kết Nối Pipedrive

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

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.

# 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:

# 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"

Cấu Hình

Thiết Lập Cơ Bản

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ạ Trường Tùy Chỉnh

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ệ

Giao Dịch

Tổ Chức

Hoạt Động

Sự Kiện

Sự Kiện Webhook

Ví Dụ Code

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

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

// Đồ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

// 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 Độ

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

Chế Độ Debug

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

Kiểm Tra Kết Nối

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
• Hướng Dẫn Webhook Pipedrive
• Trình Kết Nối HubSpot
• Trình Kết Nối Brevo
• Customer Sync Skill