Vraag vroegtijdige toegang aan

Vul je voornaam en een e-mailadres of telefoonnummer in. We nemen daarna contact met je op en leggen uit hoe je toegang krijgt tot Tajo.

Op deze pagina

Contact aanmaken

Voeg nieuwe klanten toe aan je Brevo-contactdatabase, inclusief informatie uit het loyaliteitsprogramma en aangepaste kenmerken voor gepersonaliseerde communicatie.

Snel aan de slag

Een eenvoudig contact aanmaken

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
}

Reactie

{
  "id": 123456
}

Integratie met het loyaliteitsprogramma

Nieuwe klant met loyaliteitskenmerken

{
  "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
}

Bestaande klant bijwerken

{
  "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
}

Tajo-specifieke kenmerken

Loyaliteitsgegevens van klanten

Naam kenmerk	Type	Beschrijving
`LOYALTY_ID`	String	Unieke ID binnen het loyaliteitsprogramma
`LOYALTY_POINTS`	Number	Huidig puntensaldo
`LOYALTY_TIER`	String	Huidig niveau (Bronze, Silver, Gold, Platinum)
`POINTS_EARNED_YTD`	Number	Dit jaar verdiende punten
`POINTS_REDEEMED_YTD`	Number	Dit jaar ingewisselde punten
`TIER_PROGRESS`	Number	Voortgang naar het volgende niveau (%)
`NEXT_TIER_POINTS`	Number	Punten die nodig zijn voor het volgende niveau

Koopgedrag

Naam kenmerk	Type	Beschrijving
`TOTAL_SPENT`	Number	Klantwaarde over de hele levensduur
`AVERAGE_ORDER_VALUE`	Number	Gemiddeld aankoopbedrag
`PURCHASE_FREQUENCY`	String	Hoe vaak de klant koopt
`LAST_PURCHASE`	Date	Datum van de laatste aankoop
`FAVORITE_CATEGORIES`	Array	Favoriete productcategorieën
`SEASONAL_BUYER`	Boolean	Koopt seizoensgebonden

Betrokkenheidscijfers

Naam kenmerk	Type	Beschrijving
`ENGAGEMENT_SCORE`	Number	Betrokkenheidsscore van 1 tot 10
`EMAIL_OPEN_RATE`	Number	Persoonlijk openingspercentage in %
`CLICK_THROUGH_RATE`	Number	Persoonlijke CTR in %
`LAST_EMAIL_OPENED`	Date	Laatste e-mailinteractie
`PREFERRED_CHANNEL`	String	E-mail, SMS, WhatsApp

Contacten in bulk aanmaken

Maak meerdere contacten tegelijk aan:

{
  "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
}

Foutafhandeling

Veelvoorkomende fouten en oplossingen:

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

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

Best practices voor Tajo

Neem altijd de kernvelden voor loyaliteit op: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
Zet updates aan: sta wijzigingen aan bestaande contacten toe
Gebruik segmentatielijsten: orden op niveau, gedrag en voorkeuren
Volg betrokkenheid: houd de interactie via e-mail en SMS in de gaten
Synchroniseer regelmatig: houd de loyaliteitsgegevens in je systeem actueel

Volgende stappen

Contactkenmerken bijwerken
Contactlijsten beheren
Aangepaste kenmerken instellen
Contacten in bulk importeren

Transactionele e-mails

Transactionele sms

Contacten

Gebeurtenissen