Solicita acceso anticipado

Indica tu nombre y un email o número de teléfono. Nos pondremos en contacto contigo para darte los detalles de acceso a Tajo.

En esta página

Crear un contacto

Añade clientes nuevos a tu base de contactos de Brevo con la información de tu programa de fidelización y atributos personalizados para una interacción más personal.

Inicio rápido

Creación básica de un contacto

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
}

Respuesta

{
  "id": 123456
}

Integración con el programa de fidelización

Cliente nuevo con atributos de fidelización

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

Actualización de un cliente existente

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

Atributos específicos de Tajo

Datos de fidelización del cliente

Nombre del atributo	Tipo	Descripción
`LOYALTY_ID`	String	ID único del programa de fidelización
`LOYALTY_POINTS`	Number	Saldo de puntos actual
`LOYALTY_TIER`	String	Nivel actual (Bronze, Silver, Gold, Platinum)
`POINTS_EARNED_YTD`	Number	Puntos ganados este año
`POINTS_REDEEMED_YTD`	Number	Puntos canjeados este año
`TIER_PROGRESS`	Number	Progreso hacia el siguiente nivel (%)
`NEXT_TIER_POINTS`	Number	Puntos que faltan para el siguiente nivel

Comportamiento de compra

Nombre del atributo	Tipo	Descripción
`TOTAL_SPENT`	Number	Valor de vida del cliente
`AVERAGE_ORDER_VALUE`	Number	Importe medio de compra
`PURCHASE_FREQUENCY`	String	Con qué frecuencia compra
`LAST_PURCHASE`	Date	Fecha de la última compra
`FAVORITE_CATEGORIES`	Array	Categorías de producto preferidas
`SEASONAL_BUYER`	Boolean	Compra por temporadas

Métricas de interacción

Nombre del atributo	Tipo	Descripción
`ENGAGEMENT_SCORE`	Number	Puntuación de interacción del 1 al 10
`EMAIL_OPEN_RATE`	Number	Tasa de apertura personal en %
`CLICK_THROUGH_RATE`	Number	CTR personal en %
`LAST_EMAIL_OPENED`	Date	Última interacción por email
`PREFERRED_CHANNEL`	String	Email, SMS, WhatsApp

Creación de contactos por lotes

Crea varios contactos a la vez:

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

Gestión de errores

Errores frecuentes y sus soluciones:

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

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

Buenas prácticas con Tajo

Incluye siempre los campos básicos de fidelización: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
Activa la actualización: permite que se actualicen los contactos ya existentes
Usa listas de segmentación: organízalas por nivel, comportamiento y preferencias
Mide la interacción: sigue las tasas de interacción por email y SMS
Sincroniza los datos con regularidad: mantén al día los datos de fidelización en tu sistema

Próximos pasos

Actualizar los atributos de un contacto
Gestionar las listas de contactos
Configurar atributos personalizados
Importar contactos de forma masiva

Correos Transaccionales

SMS Transaccionales

Contactos

Eventos