---
title: "连接器"
description: "与 Brevo 同步数据的平台连接器。连接你的电商店铺、CRM 或自定义应用。"
url: https://tajo.io/zh-cn/docs/connectors/
markdown: https://tajo.io/zh-cn/docs/connectors.md
lang: zh-CN
robots: noindex
---

申请抢先体验

请输入您的名字和公司电子邮箱地址。我们会发送确认 Tajo 访问申请的链接。

# 连接器

连接器是预构建的集成,用于在你的平台与 Brevo 之间同步数据。它们负责处理身份验证、数据映射和实时同步。

## 什么是连接器?

**连接器**是一条双向数据桥梁,它可以:

- **安全认证**与外部平台建立连接
- **数据同步**支持实时或批处理模式
- **字段映射**在平台 schema 和 Brevo 之间进行字段映射
- **启用 Skill**让 skill 基于同步后的数据执行操作

## 可用连接器

### 电商平台

[S](https://tajo.io/zh-cn/docs/connectors/ecommerce/shopify)

### Shopify

连接器状态: 开发中 Shopify

完整的 Shopify 集成,支持客户、订单、产品及购物车追踪

客户 订单 产品 事件

E-commerce

12 skills Easy setup

[W](https://tajo.io/zh-cn/docs/connectors/ecommerce/woocommerce)

### WooCommerce

连接器状态: 开发中 WordPress

WordPress/WooCommerce 集成,支持 REST API 和 webhook

客户 订单 产品

E-commerce

10 skills Easy setup

[M](https://tajo.io/zh-cn/docs/ecommerce-platforms/magento)

### Magento

Adobe Commerce

Adobe Commerce(Magento 2)集成,适合企业级电商

客户 订单 产品

E-commerce

8 skills Medium setup

[B](https://tajo.io/zh-cn/docs/connectors/ecommerce/bigcommerce)

### BigCommerce

连接器状态: 开发中 BigCommerce

BigCommerce 店面集成,支持多渠道

客户 订单 产品

E-commerce

8 skills Easy setup

### CRM 系统

[S](https://tajo.io/zh-cn/docs/connectors/crm/salesforce)

### Salesforce

连接器状态: 计划中 Salesforce

Salesforce CRM 集成,支持线索、联系人和商机

联系人 线索 商机

CRM

6 skills Advanced setup

[H](https://tajo.io/zh-cn/docs/connectors/crm/hubspot)

### HubSpot

连接器状态: 开发中 HubSpot

HubSpot CRM 集成,支持联系人、交易和营销自动化

联系人 交易 活动

CRM

5 skills Medium setup

[P](https://tajo.io/zh-cn/docs/connectors/crm/pipedrive)

### Pipedrive

连接器状态: 计划中 Pipedrive

Pipedrive CRM 集成,支持个人、交易和组织

个人 交易 组织

CRM

4 skills Easy setup

### 支付

[S](https://tajo.io/zh-cn/docs/connectors/ecommerce/stripe)

### Stripe

连接器状态: 已上线 Stripe

Stripe 支付集成,支持订阅、发票和交易

客户 事件 订阅

Payments

4 skills Easy setup

[P](https://tajo.io/docs/connectors/paypal)

### PayPal

连接器状态: 计划中 PayPal

PayPal 集成,支持交易和支付事件

交易 争议

Payments

2 skills Medium setup

## 连接器架构

```mermaid
graph LR
    A[Your Platform] <-->|OAuth/API Key| B[Tajo Connector]
    B <-->|Real-time Webhooks| C[Event Processing]
    C --> D[Field Mapping]
    D --> E[Brevo API]
    B <-->|Batch Sync| F[Scheduled Jobs]
    F --> D
```

### 数据流

1. **身份验证**:通过 OAuth 2.0 或 API key 建立安全连接
2. **实时事件**:webhook 即时捕获变更
3. **批量同步**:通过定时任务同步历史数据
4. **字段映射**:可配置的 Brevo 属性映射
5. **Brevo API**:数据同步到联系人、事件和列表

## 配置

### 基础设置

```yaml
connectors:
  shopify:
    enabled: true
    shop_url: "your-store.myshopify.com"
    api_key: "${SHOPIFY_API_KEY}"
    api_secret: "${SHOPIFY_API_SECRET}"

    # Data sync settings
    sync:
      customers: true
      orders: true
      products: true
      carts: true

    # Field mappings
    field_mapping:
      email: email
      first_name: FIRSTNAME
      last_name: LASTNAME
      total_spent: TOTAL_SPENT
```

### 同步模式

| 模式 | 说明 | 适用场景 |
| --- | --- | --- |
| **实时** | 通过 webhook 即时同步 | 关键客户更新 |
| **批处理** | 定时同步(每小时/每天) | 历史数据、报表 |
| **混合** | 实时 + 批处理回退 | 两全其美 |

## 快速开始

### 1. 选择你的连接器

从上面的目录中为你的平台选择合适的连接器。

### 2. 身份验证

使用 OAuth 或 API 凭证连接你的平台:

```bash
tajo connectors connect shopify \
  --shop-url your-store.myshopify.com \
  --api-key $SHOPIFY_API_KEY
```

### 3. 配置字段映射

将平台字段映射到 Brevo 联系人属性:

```yaml
field_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  totalOrders: ORDER_COUNT
  totalSpent: TOTAL_REVENUE
  lastOrderDate: LAST_ORDER_DATE
```

### 4. 启用数据同步

开始同步数据:

```bash
tajo connectors sync shopify --full
```

### 5. 激活 Skill

启用使用同步数据的 skill:

```bash
tajo skills enable abandoned-cart
tajo skills enable customer-sync
```

## 下一步

- [Shopify 连接器](https://tajo.io/zh-cn/docs/connectors/ecommerce/shopify) - Shopify 入门