Esta acción lee los datos de un cliente en JeriCommerce: su perfil, su saldo de puntos y su nivel. Úsala para decidir qué ocurre a continuación en una automatización, como enviar un mensaje distinto a los clientes que están cerca de su próxima recompensa, o para mostrar datos de fidelización en tus propios sistemas.

Configúralo

Usa la acción Get customer de JeriCommerce en un workflow de Shopify Flow. Devuelve los datos del cliente en JeriCommerce a los siguientes pasos, así que puedes usarlos en condiciones y acciones.

1

Añade la acción

En Shopify, abre Flow, crea o edita un workflow y añade Get customer después de tu desencadenante.

2

Rellena el correo

En Email, añade el correo del cliente. Usa Add variable para elegirlo desde el desencadenante.

3

Usa los datos en los siguientes pasos

En una condición o en una acción posterior, usa Add variable para elegir los datos del cliente que necesitas, como su saldo. Los datos están agrupados como en la respuesta de la API: loyaltyData incluye el saldo de puntos (balance), userData el nombre y el teléfono, y customerTier los puntos de nivel.

Si el correo no pertenece a ningún cliente de tu programa, el paso falla y el motivo aparece en el historial de ejecuciones del workflow.

Los webhooks de Klaviyo solo pueden enviar datos, no leerlos, así que un webhook no puede obtener los datos de un cliente. No lo necesitas: activa Custom Fields en la integración de Klaviyo y JeriCommerce mantendrá estas propiedades actualizadas en cada perfil de Klaviyo:

Propiedad de Klaviyo Contiene
balance El saldo de puntos del cliente.
tier-name El nombre de su nivel VIP actual.
tier-balance Sus puntos de nivel.
tier-entered-at Cuándo alcanzó su nivel actual.
tier-expires-at Cuándo caduca su nivel actual.
birthdate Su fecha de nacimiento.
jericommerce_download_wallet_pass_url Su enlace de descarga de la tarjeta de fidelización.

Úsalas en filtros de flujos, segmentos y mensajes, como cualquier otra propiedad de perfil. Consulta Sincroniza campos personalizados con Klaviyo para activarlo y ver la lista completa.

GET https://api.jericommerce.com/v1/programs/{program_slug}/customers/{email}

Sustituye {email} por el correo del cliente, codificado como URL (por ejemplo, ana%2Bvip%40example.com para ana+vip@example.com). Envía tu clave de API en el encabezado api-key. Consulta Autenticación mediante la API.

Una solicitud correcta devuelve 200 con el cliente:

{
  "id": "6f1d2c3b-...",
  "programId": "a1b2c3d4-...",
  "email": "customer@example.com",
  "origin": "SHOPIFY",
  "language": "en",
  "referral": null,
  "utmSource": null,
  "utmMedium": null,
  "utmCampaign": null,
  "balanceNotifications": true,
  "tierNotifications": true,
  "rewardAvailableNotifications": true,
  "locationNotifications": true,
  "marketingNotifications": true,
  "referralEarned": false,
  "joinedAt": "2026-03-02T10:15:00.000Z",
  "createdAt": "2026-03-02T10:15:00.000Z",
  "updatedAt": "2026-10-01T08:00:00.000Z",
  "userData": {
    "externalCustomerId": "4455885",
    "firstName": "Ana",
    "lastName": "García",
    "phone": null,
    "birthdate": "1990-05-14",
    "emailVerified": true
  },
  "loyaltyData": {
    "loyaltyCustomerId": "155445",
    "balance": 1250,
    "memberSince": "2026-03-02",
    "tierStatus": null,
    "referralLink": "https://..."
  },
  "customerTier": {
    "currentTierId": "9e8d7c6b-...",
    "carryTierId": "9e8d7c6b-...",
    "currentTierPoints": 320,
    "carryTierPoints": 900,
    "tierChangedAt": "2026-06-01T05:00:00.000Z",
    "recalculationDate": "2027-01-01T05:00:00.000Z"
  }
}

Los objetos anidados incluyen también sus propios campos id, customerId, createdAt y updatedAt, que se han omitido aquí para que el ejemplo sea más corto.

Campos del cliente

Campo Notas
origin De dónde vino el cliente: API, INITIAL_SYNC, JERICOMMERCE, SHOPIFY o UNKNOWN.
language El idioma del cliente. Puede ser null.
referral, utmSource, utmMedium, utmCampaign Cómo llegó el cliente cuando se unió. Pueden ser null.
balanceNotifications, tierNotifications, rewardAvailableNotifications, locationNotifications, marketingNotifications Las notificaciones del wallet que el cliente permite.
referralEarned true cuando el cliente ya ha conseguido su recompensa por referidos.
joinedAt Cuándo se unió el cliente al programa. Puede ser null.

userData

El perfil del cliente. Es null si el cliente todavía no tiene datos de perfil. firstName, lastName, phone y birthdate pueden ser null. externalCustomerId es el ID de tu sistema, enviado con la sincronización de clientes.

loyaltyData

La información de fidelización del cliente. Es null si el cliente todavía no tiene saldo. balance es un número entero de puntos. tierStatus solo se rellena cuando un sistema de fidelización externo lo envía mediante la sincronización de fidelización.

customerTier

El progreso del cliente en los niveles VIP. Es null si el programa no tiene niveles o el cliente todavía no tiene nivel. La respuesta incluye los ID de los niveles, no sus nombres.

Campo Notas
currentTierId, currentTierPoints El nivel que tiene el cliente ahora y los puntos ganados en el periodo actual.
carryTierId, carryTierPoints El nivel y los puntos que se arrastran del periodo anterior.
tierChangedAt Cuándo cambió el nivel por última vez.
recalculationDate El próximo recálculo de niveles. Puede ser null.

Para entender los puntos actuales y los arrastrados, consulta Puntos actuales y puntos arrastrados.

Si ningún cliente tiene ese correo, la API responde 404 con CUSTOMER_NOT_FOUND.

Crea una solicitud lista para ejecutar con tus propios valores:

Tus datos

Encuéntralo en Settings > Technical > Program Information.

Crea una en Settings > Technical > API Keys. Se queda en tu navegador.

Tu solicitud

curl --request GET \
  --url 'https://api.jericommerce.com/v1/programs/your-program-slug/customers/customer%40example.com' \
  --header 'api-key: your-api-key'

Pégalo en una terminal para probar la solicitud con tu programa.