---
title: "创建联系人 | Tajo"
description: "创建带有忠诚度计划数据和客户属性的新联系人"
url: https://tajo.io/zh-cn/docs/contact-management/contacts/create-contact/
markdown: https://tajo.io/zh-cn/docs/contact-management/contacts/create-contact.md
lang: zh-CN
author: "Set Noa"
author_url: https://tajo.io/zh-cn/set-noa/
robots: noindex
---

申请抢先体验

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

# 创建联系人

[Set Noa](https://tajo.io/zh-cn/set-noa/)

把新客户添加到 Brevo 联系人数据库，附带忠诚度计划信息和自定义属性，用于个性化互动。

## 快速开始

### 基础的联系人创建

```http
POST https://api.brevo.com/v3/contacts
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "email": "customer@example.com",
  "attributes": {
    "FIRSTNAME": "John",
    "LASTNAME": "Doe",
    "LOYALTY_POINTS": 1500,
    "LOYALTY_TIER": "Gold",
    "SIGNUP_DATE": "2024-01-15",
    "LAST_PURCHASE": "2024-01-20",
    "TOTAL_SPENT": 299.99
  },
  "listIds": [1, 2],
  "updateEnabled": true
}
```

### 响应

```json
{
  "id": 123456
}
```

## 忠诚度计划集成

### 带忠诚度属性的新客户

```json
{
  "email": "newcustomer@example.com",
  "attributes": {
    "FIRSTNAME": "Sarah",
    "LASTNAME": "Johnson",
    "PHONE": "+1234567890",
    "LOYALTY_ID": "LYL-2024-001",
    "LOYALTY_POINTS": 0,
    "LOYALTY_TIER": "Bronze",
    "PREFERRED_REWARDS": "Discounts",
    "BIRTHDAY": "1990-05-15",
    "SIGNUP_SOURCE": "Website",
    "REFERRAL_CODE": "REF-12345",
    "COMMUNICATION_PREFERENCES": "Email,SMS",
    "PURCHASE_CATEGORIES": ["Electronics", "Fashion"],
    "AVERAGE_ORDER_VALUE": 0
  },
  "listIds": [1], // New customers list
  "emailBlacklisted": false,
  "smsBlacklisted": false,
  "updateEnabled": true
}
```

### 更新已有客户

```json
{
  "email": "existing@example.com",
  "attributes": {
    "LOYALTY_POINTS": 2500,
    "LOYALTY_TIER": "Platinum",
    "LAST_PURCHASE": "2024-01-25",
    "TOTAL_SPENT": 1299.99,
    "RECENT_PURCHASES": ["Product A", "Product B"],
    "ENGAGEMENT_SCORE": 8.5,
    "LAST_EMAIL_OPENED": "2024-01-24",
    "PREFERRED_CONTACT_TIME": "Evening"
  },
  "listIds": [1, 3], // Add to platinum customers list
  "updateEnabled": true
}
```

## Tajo 专属属性

### 客户忠诚度数据

| 属性名 | 类型 | 说明 |
| --- | --- | --- |
| `LOYALTY_ID` | String | 忠诚度计划的唯一 ID |
| `LOYALTY_POINTS` | Number | 当前积分余额 |
| `LOYALTY_TIER` | String | 当前等级（Bronze、Silver、Gold、Platinum） |
| `POINTS_EARNED_YTD` | Number | 本年度累计获得的积分 |
| `POINTS_REDEEMED_YTD` | Number | 本年度累计兑换的积分 |
| `TIER_PROGRESS` | Number | 距下一等级的进度（%） |
| `NEXT_TIER_POINTS` | Number | 升至下一等级还需的积分 |

### 购买行为

| 属性名 | 类型 | 说明 |
| --- | --- | --- |
| `TOTAL_SPENT` | Number | 客户终身价值 |
| `AVERAGE_ORDER_VALUE` | Number | 平均订单金额 |
| `PURCHASE_FREQUENCY` | String | 购买频次 |
| `LAST_PURCHASE` | Date | 最近一次购买日期 |
| `FAVORITE_CATEGORIES` | Array | 偏好的商品类目 |
| `SEASONAL_BUYER` | Boolean | 是否按季节购买 |

### 互动指标

| 属性名 | 类型 | 说明 |
| --- | --- | --- |
| `ENGAGEMENT_SCORE` | Number | 1-10 的互动评分 |
| `EMAIL_OPEN_RATE` | Number | 个人邮件打开率（%） |
| `CLICK_THROUGH_RATE` | Number | 个人点击率（%） |
| `LAST_EMAIL_OPENED` | Date | 最近一次邮件互动 |
| `PREFERRED_CHANNEL` | String | Email、SMS、WhatsApp |

## 批量创建联系人

一次创建多个联系人：

```json
{
  "contacts": [
    {
      "email": "customer1@example.com",
      "attributes": {
        "FIRSTNAME": "Alice",
        "LOYALTY_POINTS": 500,
        "LOYALTY_TIER": "Bronze"
      }
    },
    {
      "email": "customer2@example.com",
      "attributes": {
        "FIRSTNAME": "Bob",
        "LOYALTY_POINTS": 1200,
        "LOYALTY_TIER": "Silver"
      }
    }
  ],
  "listIds": [1],
  "updateEnabled": true
}
```

## 错误处理

常见错误及处理方式：

```json
{
  "code": "duplicate_parameter",
  "message": "Contact already exists",
  "details": {
    "email": "customer@example.com",
    "existingId": 123456
  }
}
```

```json
{
  "code": "invalid_parameter",
  "message": "Invalid list ID",
  "details": {
    "listIds": [999]
  }
}
```

## Tajo 最佳实践

1. **始终填写核心忠诚度字段**：LOYALTY\_POINTS、LOYALTY\_TIER、LOYALTY\_ID
2. **开启更新**：允许更新已存在的联系人
3. **使用细分列表**：按等级、行为、偏好组织联系人
4. **追踪互动**：监控邮件和 SMS 的互动率
5. **定期同步数据**：让忠诚度数据与你的系统保持一致

## 后续步骤

- 更新联系人属性
- 管理联系人列表
- 设置自定义属性
- 批量导入联系人