Trình Kết Nối Salesforce

Trình Kết Nối Salesforce

Kết nối Salesforce với Brevo qua Tajo để hợp nhất dữ liệu CRM doanh nghiệp với marketing automation, đồng bộ leads và liên hệ, và kết nối kết quả bán hàng với mức độ tương tác marketing.

Tổng Quan

Tính Năng

• Đồng bộ liên hệ và lead - Đồng bộ hai chiều giữa Salesforce và Brevo
• Theo dõi cơ hội - Ánh xạ giai đoạn cơ hội sang vòng đời liên hệ Brevo
• Đồng bộ tài khoản - Liên kết dữ liệu tài khoản Salesforce với hồ sơ công ty Brevo
• Tích hợp campaign - Ánh xạ thành viên Salesforce Campaign sang danh sách Brevo
• Truy vấn SOQL - Đồng bộ đối tượng tùy chỉnh qua Salesforce Object Query Language
• Bulk API - Xuất và nhập dữ liệu khối lượng lớn hiệu quả
• Streaming API - Nhận cập nhật thời gian thực qua Platform Events
• Custom Objects - Đồng bộ bất kỳ đối tượng Salesforce tùy chỉnh nào

Yêu Cầu

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

1. Tài khoản Salesforce (Professional, Enterprise, Unlimited, hoặc Developer)
2. Người dùng tích hợp với quyền API
3. Connected App với OAuth 2.0 đã cấu hình
4. Tài khoản Brevo với quyền truy cập API
5. Tài khoản Tajo

Xác Thực

OAuth 2.0 (Khuyến Nghị)

Salesforce sử dụng OAuth 2.0 cho xác thực API.

# Bước 1: Authorization URL
https://login.salesforce.com/services/oauth2/authorize
  ?response_type=code
  &client_id=YOUR_CONSUMER_KEY
  &redirect_uri=YOUR_CALLBACK_URL

# Bước 2: Đổi mã lấy token
curl -X POST https://login.salesforce.com/services/oauth2/token \
  -d "grant_type=authorization_code" \
  -d "client_id=CONSUMER_KEY" \
  -d "client_secret=CONSUMER_SECRET" \
  -d "redirect_uri=CALLBACK_URL" \
  -d "code=AUTHORIZATION_CODE"

Xác Thực Username-Password

Cho server-to-server (ít được khuyến nghị hơn):

curl -X POST https://login.salesforce.com/services/oauth2/token \
  -d "grant_type=password" \
  -d "client_id=CONSUMER_KEY" \
  -d "client_secret=CONSUMER_SECRET" \
  -d "username=YOUR_USERNAME" \
  -d "password=YOUR_PASSWORD_PLUS_SECURITY_TOKEN"

Cấu Hình

Thiết Lập Cơ Bản

connectors:
  salesforce:
    enabled: true
    instance_url: "https://yourorg.salesforce.com"
    oauth:
      client_id: "${SF_CONSUMER_KEY}"
      client_secret: "${SF_CONSUMER_SECRET}"
      refresh_token: "${SF_REFRESH_TOKEN}"

    # Tùy chọn đồng bộ dữ liệu
    sync:
      contacts: true
      leads: true
      opportunities: true
      accounts: true
      campaigns: true

    # Ánh xạ danh sách Brevo
    list_mapping:
      "All Contacts": 10
      "Marketing Qualified": 11
      "Sales Qualified": 12

Ánh Xạ Trường

Ánh xạ trường Salesforce 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: email
  FirstName: FIRSTNAME
  LastName: LASTNAME
  Phone: SMS

  # Trường CRM
  Account.Name: COMPANY_NAME
  LeadSource: LEAD_SOURCE
  Status: LEAD_STATUS

  # Trường cơ hội
  Opportunity.Amount: DEAL_VALUE
  Opportunity.StageName: DEAL_STAGE

  # Trường tùy chỉnh
  Custom_Plan__c: PLAN_TYPE
  Custom_Industry__c: INDUSTRY

API Endpoints

REST API

Bulk API 2.0

Sự Kiện

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 Salesforce
await tajo.connectors.connect('salesforce', {
  instanceUrl: process.env.SF_INSTANCE_URL,
  clientId: process.env.SF_CONSUMER_KEY,
  clientSecret: process.env.SF_CONSUMER_SECRET,
  refreshToken: process.env.SF_REFRESH_TOKEN
});

Truy Vấn Liên Hệ Bằng SOQL

// Truy vấn liên hệ bằng SOQL
const contacts = await tajo.connectors.query('salesforce', {
  soql: `
    SELECT Id, Email, FirstName, LastName, Phone,
           Account.Name, LeadSource, CreatedDate
    FROM Contact
    WHERE CreatedDate > 2024-01-01T00:00:00Z
    AND Email != null
    ORDER BY CreatedDate DESC
    LIMIT 1000
  `
});

Đồng Bộ Hàng Loạt Sang Brevo

// Đồng bộ Salesforce sang Brevo bằng Bulk API
await tajo.connectors.sync('salesforce', {
  type: 'full',
  resources: ['contacts', 'leads'],
  useBulkApi: true,
  options: {
    includeCustomFields: true,
    mapListMemberships: true
  }
});

const status = await tajo.connectors.status('salesforce');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 145000,
//   leadsSynced: 28000,
//   opportunitiesSynced: 9500
// }

Giới Hạn Tốc Độ

Khắc Phục Sự Cố

Sự Cố Phổ Biến

Chế Độ Debug

connectors:
  salesforce:
    debug: true
    log_level: verbose
    log_api_calls: true
    log_bulk_jobs: true

Kiểm Tra Kết Nối

tajo connectors test salesforce
# ✓ OAuth authentication successful
# ✓ REST API accessible
# ✓ Contacts queryable
# ✓ Bulk API available
# ✓ Custom fields loaded

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

1. Dùng Bulk API cho số lượng lớn - Sử dụng Bulk API cho hơn 10.000 bản ghi
2. Bộ nhớ đệm metadata - Cache schema đối tượng để giảm lời gọi API
3. Đồng bộ tăng dần - Sử dụng SystemModstamp để lọc bản ghi thay đổi gần đây
4. Người dùng tích hợp - Tạo người dùng Salesforce chuyên dụng cho tích hợp API
5. Theo dõi giới hạn API - Thiết lập cảnh báo khi sử dụng API đạt 80%
6. Xử lý lỗi - Triển khai retry với backoff hàm mũ

Bảo Mật

• OAuth 2.0 - Xác thực dựa trên token với refresh tokens
• Người dùng tích hợp - Tài khoản Salesforce chuyên dụng với quyền tối thiểu
• Connected App - Kiểm soát phạm vi và IP allowlist
• Mã hóa TLS - Tất cả giao tiếp API được mã hóa
• Nhật ký kiểm tra - Theo dõi truy cập API trong Salesforce Login History

Tài Nguyên Liên Quan

• Tài Liệu API Salesforce
• Tài Liệu Bulk API Salesforce
• Trình Kết Nối HubSpot
• Trình Kết Nối Brevo
• Customer Sync Skill