创建联系人
把新客户添加到 Brevo 联系人数据库，附带忠诚度计划信息和自定义属性，用于个性化互动。
快速开始
基础的联系人创建
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}响应
{ "id": 123456}忠诚度计划集成
带忠诚度属性的新客户
{ "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}更新已有客户
{ "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 |
批量创建联系人
一次创建多个联系人：
{ "contacts": [ { "attributes": { "FIRSTNAME": "Alice", "LOYALTY_POINTS": 500, "LOYALTY_TIER": "Bronze" } }, { "attributes": { "FIRSTNAME": "Bob", "LOYALTY_POINTS": 1200, "LOYALTY_TIER": "Silver" } } ], "listIds": [1], "updateEnabled": true}错误处理
常见错误及处理方式：
{ "code": "duplicate_parameter", "message": "Contact already exists", "details": { "existingId": 123456 }}{ "code": "invalid_parameter", "message": "Invalid list ID", "details": { "listIds": [999] }}Tajo 最佳实践
- 始终填写核心忠诚度字段：LOYALTY_POINTS、LOYALTY_TIER、LOYALTY_ID
- 开启更新：允许更新已存在的联系人
- 使用细分列表：按等级、行为、偏好组织联系人
- 追踪互动：监控邮件和 SMS 的互动率
- 定期同步数据：让忠诚度数据与你的系统保持一致
后续步骤
- 更新联系人属性
- 管理联系人列表
- 设置自定义属性
- 批量导入联系人