Questa azione legge i dati JeriCommerce di un cliente: il suo profilo, il saldo punti e il livello. Usala per decidere cosa succede dopo in un'automazione, per esempio inviare un messaggio diverso ai clienti vicini al premio successivo, oppure per mostrare i dati fedeltà nei tuoi sistemi.

Configurazione

Usa l'azione Get customer di JeriCommerce in un workflow di Shopify Flow. Restituisce i dati JeriCommerce del cliente ai passaggi successivi, così puoi usarli in condizioni e azioni.

1

Aggiungi l'azione

In Shopify apri Flow, crea o modifica un workflow e aggiungi Get customer dopo il trigger.

2

Compila l'email

In Email, aggiungi l'email del cliente. Usa Add variable per sceglierla dal trigger.

3

Usa i dati nei passaggi successivi

In una condizione o in un'azione successiva, usa Add variable per scegliere i dati del cliente che ti servono, come il suo saldo. I dati sono raggruppati come nella risposta dell'API: loyaltyData contiene il saldo punti (balance), userData nome e telefono, e customerTier i punti livello.

Se l'email non appartiene a un cliente del tuo programma, il passaggio fallisce e il motivo compare nella cronologia delle esecuzioni del workflow.

I webhook di Klaviyo possono solo inviare dati, non leggerli, quindi un webhook non può recuperare i dettagli del cliente. Non ne hai bisogno: attiva Custom Fields nell'integrazione Klaviyo e JeriCommerce mantiene aggiornate queste proprietà in ogni profilo Klaviyo:

Proprietà Klaviyo Contiene
balance Il saldo punti del cliente.
tier-name Il nome del suo livello VIP attuale.
tier-balance I suoi punti livello.
tier-entered-at Quando ha raggiunto il livello attuale.
tier-expires-at Quando scade il suo livello attuale.
birthdate La sua data di nascita.
jericommerce_download_wallet_pass_url Il suo link di download della carta fedeltà.

Usale nei filtri dei flussi, nei segmenti e nei messaggi, come qualsiasi altra proprietà del profilo. Consulta Sincronizza i campi personalizzati con Klaviyo per attivarli e per l'elenco completo.

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

Sostituisci {email} con l'indirizzo email del cliente, codificato per URL (per esempio ana%2Bvip%40example.com per ana+vip@example.com). Invia la tua chiave API nell'header api-key. Consulta Autenticazione tramite API.

Una richiesta riuscita restituisce 200 con il 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"
  }
}

Gli oggetti annidati includono anche i campi id, customerId, createdAt e updatedAt, omessi qui per mantenere breve l'esempio.

Campi del cliente

Campo Note
origin Da dove arriva il cliente: API, INITIAL_SYNC, JERICOMMERCE, SHOPIFY o UNKNOWN.
language La lingua del cliente. Può essere null.
referral, utmSource, utmMedium, utmCampaign Come è arrivato il cliente quando si è iscritto. Possono essere null.
balanceNotifications, tierNotifications, rewardAvailableNotifications, locationNotifications, marketingNotifications Le notifiche wallet che il cliente accetta.
referralEarned true quando il cliente ha già ottenuto il premio per il passaparola.
joinedAt Quando il cliente si è iscritto al programma. Può essere null.

userData

Il profilo del cliente. È null se il cliente non ha ancora dati di profilo. firstName, lastName, phone e birthdate possono essere null. externalCustomerId è l'ID del tuo sistema, inviato con la sincronizzazione dei clienti.

loyaltyData

Le informazioni fedeltà del cliente. È null se il cliente non ha ancora un saldo. balance è un numero intero di punti. tierStatus viene compilato solo quando un sistema fedeltà esterno lo invia tramite la sincronizzazione fedeltà.

customerTier

I progressi del cliente nei livelli VIP. È null se il programma non ha livelli o il cliente non ha ancora un livello. La risposta include gli ID dei livelli, non i loro nomi.

Campo Note
currentTierId, currentTierPoints Il livello attuale del cliente e i punti guadagnati nel periodo corrente.
carryTierId, carryTierPoints Il livello e i punti riportati dal periodo precedente.
tierChangedAt Quando il livello è cambiato l'ultima volta.
recalculationDate Il prossimo ricalcolo del livello. Può essere null.

Per capire i punti correnti e quelli riportati, consulta Punti correnti e punti riportati.

Se nessun cliente ha quell'email, l'API risponde 404 con CUSTOMER_NOT_FOUND.

Crea una richiesta pronta all'uso con i tuoi valori:

I tuoi dati

Lo trovi in Settings > Technical > Program Information.

Creane una in Settings > Technical > API Keys. Resta nel tuo browser.

La tua richiesta

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

Incollalo in un terminale per testare la richiesta con il tuo programma.