Solicită acces anticipat

Introduceți prenumele și adresa de e-mail profesională. Vă vom trimite un link pentru a confirma cererea de acces la Tajo.

Pe această pagină

Creează un contact

Set Noa

Adaugă clienți noi în baza de date de contacte Brevo, cu informații despre programul de loialitate și atribute personalizate pentru o interacțiune personalizată.

Start rapid

Crearea unui contact simplu

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

{
  "email": "[email protected]",
  "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
}

Răspuns

{
  "id": 123456
}

Integrarea cu programul de loialitate

Client nou cu atribute de loialitate

{
  "email": "[email protected]",
  "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
}

Actualizarea unui client existent

{
  "email": "[email protected]",
  "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
}

Atribute specifice Tajo

Datele de loialitate ale clientului

Nume atribut	Tip	Descriere
`LOYALTY_ID`	String	ID unic în programul de loialitate
`LOYALTY_POINTS`	Number	Soldul curent de puncte
`LOYALTY_TIER`	String	Nivelul curent (Bronze, Silver, Gold, Platinum)
`POINTS_EARNED_YTD`	Number	Puncte acumulate anul acesta
`POINTS_REDEEMED_YTD`	Number	Puncte folosite anul acesta
`TIER_PROGRESS`	Number	Progresul către nivelul următor (%)
`NEXT_TIER_POINTS`	Number	Puncte necesare pentru nivelul următor

Comportamentul de cumpărare

Nume atribut	Tip	Descriere
`TOTAL_SPENT`	Number	Valoarea pe durata relației
`AVERAGE_ORDER_VALUE`	Number	Valoarea medie a unei comenzi
`PURCHASE_FREQUENCY`	String	Cât de des cumpără
`LAST_PURCHASE`	Date	Data ultimei achiziții
`FAVORITE_CATEGORIES`	Array	Categoriile de produse preferate
`SEASONAL_BUYER`	Boolean	Cumpără sezonier

Indicatori de interacțiune

Nume atribut	Tip	Descriere
`ENGAGEMENT_SCORE`	Number	Scor de interacțiune de la 1 la 10
`EMAIL_OPEN_RATE`	Number	Rata personală de deschidere (%)
`CLICK_THROUGH_RATE`	Number	CTR personal (%)
`LAST_EMAIL_OPENED`	Date	Ultima interacțiune cu un e-mail
`PREFERRED_CHANNEL`	String	Email, SMS, WhatsApp

Crearea contactelor în lot

Creează mai multe contacte deodată:

{
  "contacts": [
    {
      "email": "[email protected]",
      "attributes": {
        "FIRSTNAME": "Alice",
        "LOYALTY_POINTS": 500,
        "LOYALTY_TIER": "Bronze"
      }
    },
    {
      "email": "[email protected]",
      "attributes": {
        "FIRSTNAME": "Bob",
        "LOYALTY_POINTS": 1200,
        "LOYALTY_TIER": "Silver"
      }
    }
  ],
  "listIds": [1],
  "updateEnabled": true
}

Tratarea erorilor

Erori frecvente și soluțiile lor:

{
  "code": "duplicate_parameter",
  "message": "Contact already exists",
  "details": {
    "email": "[email protected]",
    "existingId": 123456
  }
}

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

Bune practici pentru Tajo

Include întotdeauna câmpurile de bază de loialitate: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
Activează actualizarea: permite actualizarea contactelor existente
Folosește liste de segmentare: organizează contactele după nivel, comportament și preferințe
Urmărește interacțiunea: monitorizează ratele de interacțiune prin e-mail și SMS
Sincronizează datele constant: păstrează datele de loialitate la zi cu sistemul tău

Pașii următori

Actualizarea atributelor unui contact
Gestionarea listelor de contacte
Configurarea atributelor personalizate
Importul contactelor în masă