---
title: "연락처 생성 | Tajo"
description: "로열티 프로그램 데이터와 고객 속성을 담아 새 연락처를 생성합니다"
url: https://tajo.io/kr/docs/contact-management/contacts/create-contact/
markdown: https://tajo.io/kr/docs/contact-management/contacts/create-contact.md
lang: ko-KR
author: "Set Noa"
author_url: https://tajo.io/kr/set-noa/
robots: noindex
---

Tajo 사전 이용 신청

이름과 회사 이메일 주소를 입력하세요. Tajo 이용 신청을 확인할 수 있는 링크를 이메일로 보내드립니다.

# 연락처 생성

[Set Noa](https://tajo.io/kr/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 | 이메일, 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. **정기적인 데이터 동기화**: 로열티 데이터를 자사 시스템과 최신 상태로 유지합니다

## 다음 단계

- 연락처 속성 업데이트
- 연락처 리스트 관리
- 맞춤 속성 설정
- 연락처 일괄 가져오기