Tạo liên hệ
Thêm khách hàng mới vào cơ sở dữ liệu liên hệ Brevo của bạn kèm thông tin chương trình khách hàng thân thiết và thuộc tính tùy chỉnh để cá nhân hóa tương tác.
Bắt đầu nhanh
Tạo liên hệ cơ bản
POST https://api.brevo.com/v3/contactsContent-Type: application/jsonapi-key: YOUR_API_KEY
{ "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}Phản hồi
{ "id": 123456}Tích hợp chương trình khách hàng thân thiết
Khách hàng mới kèm thuộc tính khách hàng thân thiết
{ "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}Cập nhật khách hàng hiện có
{ "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}Thuộc tính riêng của Tajo
Dữ liệu khách hàng thân thiết
| Tên thuộc tính | Kiểu | Mô tả |
|---|---|---|
LOYALTY_ID | String | Mã chương trình khách hàng thân thiết duy nhất |
LOYALTY_POINTS | Number | Số dư điểm hiện tại |
LOYALTY_TIER | String | Hạng hiện tại (Bronze, Silver, Gold, Platinum) |
POINTS_EARNED_YTD | Number | Điểm tích lũy trong năm nay |
POINTS_REDEEMED_YTD | Number | Điểm đã đổi trong năm nay |
TIER_PROGRESS | Number | Tiến độ lên hạng tiếp theo (%) |
NEXT_TIER_POINTS | Number | Số điểm cần để lên hạng tiếp theo |
Hành vi mua hàng
| Tên thuộc tính | Kiểu | Mô tả |
|---|---|---|
TOTAL_SPENT | Number | Giá trị trọn đời |
AVERAGE_ORDER_VALUE | Number | Giá trị đơn hàng trung bình |
PURCHASE_FREQUENCY | String | Tần suất mua hàng |
LAST_PURCHASE | Date | Ngày mua hàng gần nhất |
FAVORITE_CATEGORIES | Array | Danh mục sản phẩm ưa thích |
SEASONAL_BUYER | Boolean | Mua hàng theo mùa |
Chỉ số tương tác
| Tên thuộc tính | Kiểu | Mô tả |
|---|---|---|
ENGAGEMENT_SCORE | Number | Điểm tương tác từ 1 đến 10 |
EMAIL_OPEN_RATE | Number | Tỷ lệ mở email cá nhân (%) |
CLICK_THROUGH_RATE | Number | Tỷ lệ nhấp cá nhân (%) |
LAST_EMAIL_OPENED | Date | Lần tương tác email gần nhất |
PREFERRED_CHANNEL | String | Email, SMS, WhatsApp |
Tạo liên hệ hàng loạt
Tạo nhiều liên hệ cùng lúc:
{ "contacts": [ { "attributes": { "FIRSTNAME": "Alice", "LOYALTY_POINTS": 500, "LOYALTY_TIER": "Bronze" } }, { "attributes": { "FIRSTNAME": "Bob", "LOYALTY_POINTS": 1200, "LOYALTY_TIER": "Silver" } } ], "listIds": [1], "updateEnabled": true}Xử lý lỗi
Các lỗi thường gặp và cách khắc phục:
{ "code": "duplicate_parameter", "message": "Contact already exists", "details": { "existingId": 123456 }}{ "code": "invalid_parameter", "message": "Invalid list ID", "details": { "listIds": [999] }}Thực hành tốt nhất cho Tajo
- Luôn thêm các trường khách hàng thân thiết cốt lõi: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
- Bật cập nhật: Cho phép cập nhật các liên hệ hiện có
- Dùng danh sách phân khúc: Sắp xếp theo hạng, hành vi và tùy chọn
- Theo dõi tương tác: Giám sát tỷ lệ tương tác email và SMS
- Đồng bộ dữ liệu định kỳ: Giữ dữ liệu khách hàng thân thiết luôn khớp với hệ thống của bạn
Bước tiếp theo
- Cập nhật thuộc tính liên hệ
- Quản lý danh sách liên hệ
- Thiết lập thuộc tính tùy chỉnh
- Nhập liên hệ hàng loạt