Creazione Clienti

👤 Funzionalità di Creazione/Aggiornamento Cliente

L'endpoint consente di creare o aggiornare un cliente su Shopify.

🔍 Logica di ricerca del cliente:

1. Se è presente l'Id del cliente, viene effettuata una ricerca tramite Id Shopify.
   • Se il cliente esiste, viene restituito per effettuare l'aggiornamento.
   • Se non viene trovato e l'Id fornito in input contiene il prefisso dell'Id shopify, la ricerca si interrompe e si procede con la creazione del cliente.
   • In caso contrario la ricerca prosegue.
2. Se non è stato possibile individuare il cliente tramite Id, e l'email fornita è valida, viene effettuata una ricerca tramite email.
   • Se il cliente viene trovato, viene restituito.
   • In caso contrario, la ricerca prosegue.
3. Se non è disponibile (o non valida) l’email, ma è presente un numero di telefono valido, viene eseguita una ricerca tramite numero di telefono.
   • Se viene trovato un cliente, viene restituito.
4. Se nessuna delle ricerche restituisce risultati, viene restituito un cliente vuoto, e il sistema procederà successivamente con la creazione di un nuovo cliente.

Configurazione destinazione

Configurare una destinazione Shopify e associarla al flusso, oltre alla configurazione base del flusso dati.

Campo	Valore	Note
Destination Type	Shopify
Operation	Sync customer	POST /egress/sync-customer-to-shopify
GraphQL endpoint URL	https://SHOPIFYURL.myshopify.com/	URL dell'endpoint GraphQL Admin API dello shop Shopify
Admin API access token	shpat_CODICEALFANUMERICO	Oppure Client ID (API key) + Client secret — vedi Autenticazione
Client ID (API key)	IL_TUO_CLIENT_ID
Client secret	IL_TUO_CLIENT_SECRET

Deprecato — configurazione precedente (HTTP Adapter)

Deprecato

La configurazione tramite HTTP Adapter con Base Url, Resource Path e header x-api-key nei Settings Override è deprecata. Utilizzare la destinazione Shopify descritta sopra.

Oltre alla configurazione base del flusso dati era necessario impostare nei Settings Override:

Campo	Valore	Note
Base Url	https://adapter.flowlyze.io	url degli adapter
Resource Path	api/adp/shopify/egress/sync-customer-to-shopify	path dell'adapter per il flusso di creazione dei clienti
Headers :: x-api-key	**********	api key di verifica per l'interazione con l'endpoint
Headers :: x-shopify-access-token	shpat_CODICEALFANUMERICO	secret della custom app creata per l'integrazione
Headers :: x-shopify-graphql-url	https://SHOPIFYURL.myshopify.com/	url dello shopify con cui connettersi

Messaggio di Input

L’endpoint lavora in modalità upsert: è possibile inviare JSON parziali e solo i campi specificati verranno aggiornati su Shopify. I campi non inclusi nella richiesta non subiranno modifiche.

Se è necessario svuotare un campo (es. rimuovere un valore precedentemente presente), occorre inviarlo esplicitamente come stringa vuota ("").

Esempi Messaggi di Input

1. Creazione/Aggiornamento cliente

{
    "id": "123456789",
    "email": "mario.bianchi@gmail.com",
    "firstName": "Mario",
    "lastName": "Bianchi",
    "phone": "3342233222",
    "tags": ["tag1","tag2"],
    "acceptsEmailMarketing": false,
    "acceptsSmsMarketing": false
}

💡 Nota: Se si desidera fornire l’Id nel formato Shopify, è possibile utilizzare la versione con prefisso:

"id": "gid://shopify/Customer/123456789"