Importazione Clienti

I clienti di Shopify vengono recuperati attivamente da Flowlyze.

L'Adapter aggiunge un tag al cliente per verificarne l'avvenuta esportazione (EXPORTED) ed evitare invii duplicati verso la destinazione, ma solo se l'header di sincronizzazione unica è impostato a true. Questo comportamento consente di sincronizzare un cliente una sola volta, ignorando eventuali aggiornamenti successivi (comportamento opzionale, configurabile tramite header). Se l’header non è valorizzato, il tag non viene aggiunto e l’ordine può essere esportato più volte.

warning

Compatibilità con i piani Shopify

L'importazione dei clienti non è supportata per gli store Shopify con piano Basic a causa di limitazioni dell'API. Per abilitare l'importazione completa dei dati cliente, è necessario effettuare l'upgrade a un piano superiore.

Configurazione del Flusso Clienti (attivo)

Dopo aver creato la destinazione si procede all'inserimento del flusso.

Campo	Valore	Note
Name	es. active-flow-customer	Nome della schedulazione
Cron Expression	*/5 * * * *	Ogni quanto si vuole eseguire il recupero dei clienti (es. */5 * * * * -> ogni 5 minuti)
Source Type	http	Il tipo di sorgente che deve essere utilizzata
Url	https://adapt.flowlyze.com/api/adp/shopify/ingress/get-customers-updated-after	Url dell'endpoint che deve essere richiamato (vedi nota a fine tabella)
Method	GET	Il metodo con cui richiamare l'endpoint
Headers :: x-api-key	**********	L'api key di verifica per l'interazione con l'endpoint
Headers :: x-shopify-graphql-url	https://SHOPIFYURL.myshopify.com/	Url dello shopify con cui connettersi
Headers :: x-shopify-access-token	shpat_CODICEALFANUMERICO	Secret della custom app creata per l'integrazione
Headers :: x-last-customer-updated-processed"	lastCustomerUpdatedProcessed	Data da cui partire per recuperare i clienti, da utilizzare con autoincrementale
Headers :: x-sync-customer-once	true	Booleano per inserire il cliente una sola volta, non propaga aggiornamenti (default false)
Headers :: channel-code"	Your Shopify Store	Il nome o il codice del tuo shop di Shopify
Headers :: x-number-of-customers	10	Numero di clienti da recuperare ad ogni chiamata (default 10)

Esempio delle informazioni recuperate

{
    "id": "gid://shopify/Customer/6182841417961",
    "channel": "shopify",
    "email": "mario.bianchi@gmail.com",
    "createdAt": "2022-05-17T12:21:36+00:00",
    "updatedAt": "2025-04-28T12:38:28+00:00",
    "firstName": "Mario",
    "lastName": "Bianchi",
    "phone": "3345566767",
    "locale": "en-IT",
    "tags": [
      "tag1",
      "tag2"
    ],
    "acceptsEmailMarketing": false,
    "acceptsEmailMarketingDate": null,
    "acceptsSmsMarketing": false,
    "acceptsSmsMarketingDate": null,
    "totalSpent": 3728.03,
    "ordersCount": 27
}