# Tạo khách hàng

Tạo hồ sơ khách hàng với thuộc tính và định danh kênh tùy chọn.

API 4.0

Trong API, khách hàng là một **user**. Agent là agent của bạn và không được tạo ở đây.

Dùng endpoint này để thêm khách hàng từ hệ thống của bạn, như một liên hệ trong CRM hoặc người mới đăng ký. Nếu khách hàng đến từ kênh đã kết nối như Facebook hoặc Zalo, hãy dùng [Tìm hoặc tạo theo định danh kênh](/developers/vi/api-reference/users/identity) để tránh trùng lặp.

## Trước khi bắt đầu

- Lấy [Bearer access token](/developers/vi/get-started/authentication). Khách hàng được tạo trong tài khoản của token.
- Dùng khóa thuộc tính đã định nghĩa trong tài khoản, với giá trị đúng kiểu.

## Body yêu cầu

| Trường | Kiểu | Mô tả |
| --- | --- | --- |
| `attributes` | array | Dữ liệu khách hàng, mỗi phần tử là một thuộc tính. |
| `attributes[].key` | string | Khóa thuộc tính, như `fullname`. |
| `attributes[].text` | string | Giá trị cho thuộc tính văn bản. Dùng `number`, `boolean` hoặc `datetime` cho các kiểu khác. |
| `channel` | string | Tùy chọn. Kênh của định danh bên ngoài, như `facebook`. |
| `channel_source` | string | Tùy chọn. Trang hoặc tài khoản đã kết nối trên kênh đó. |
| `profile_id` | string | Tùy chọn. ID của khách hàng trên kênh đó. |

Các trường khác, như `id` hoặc `account_id`, bị bỏ qua.

```json
{
  "attributes": [
    {
      "key": "fullname",
      "text": "Alex Example"
    },
    {
      "key": "emails",
      "text": "alex@example.com"
    },
    {
      "key": "phones",
      "text": "+84900000000"
    }
  ]
}
```

## Thuộc tính thường dùng

Các khóa có sẵn này tồn tại trong mọi tài khoản. Xem [Định dạng khách hàng và thuộc tính](/developers/vi/users/format) để biết kiểu giá trị và cách lưu nhiều giá trị.

| Khóa | Kiểu | Mô tả |
| --- | --- | --- |
| `fullname` | text | Họ và tên. |
| `display_name` | text | Tên hiển thị. |
| `emails` | text | Địa chỉ email. |
| `phones` | text | Số điện thoại. |
| `address`, `city`, `district` | text | Địa chỉ. |
| `gender` | text | Giới tính. |
| `job_title` | text | Chức danh. |
| `birthdate` | datetime | Ngày sinh. |

Một số thuộc tính có sẵn, như `created` hoặc `last_message_sent`, do Subiz đặt và là chỉ đọc.

## Phản hồi

Yêu cầu thành công trả HTTP `200` cùng khách hàng mới. Một số trường:

```json
{
  "id": "user_example",
  "account_id": "account_example",
  "attributes": [
    {
      "key": "fullname",
      "text": "Alex Example"
    }
  ]
}
```

Lưu lại `id`. Bạn cần nó để [đọc](/developers/vi/api-reference/users/retrieve), [cập nhật](/developers/vi/api-reference/users/update) hoặc [nhắn tin](/developers/vi/api-reference/messages/send-to-user) cho khách hàng này.

Mỗi yêu cầu tạo một bản ghi mới. Để thay đổi khách hàng đã có, dùng [Cập nhật thông tin khách hàng](/developers/vi/api-reference/users/update) thay vì tạo lại.

## Giới hạn và lỗi

Một yêu cầu có thể chứa tối đa 1.000 thuộc tính, và mỗi giá trị tối đa 2.048 byte. Xem [Giới hạn thuộc tính khách hàng](/developers/vi/get-started/usage-limits#giới-hạn-thuộc-tính-khách-hàng) và [Xử lý lỗi](/developers/vi/get-started/errors).

## Yêu cầu HTTP

Thay `YOUR_ACCESS_TOKEN` bằng token của bạn.

```http
POST https://api.subiz.com.vn/4.0/users
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "attributes": [
    {
      "key": "fullname",
      "text": "Alex Example"
    }
  ]
}
```