JeriCommerce si integra con Shopify Flow tramite 18 trigger di eventi e 8 azioni. Questa guida descrive configurazione e funzionalità specifiche per Shopify. Per l'elenco completo degli eventi, la struttura del payload e le relative proprietà, consulta la guida di riferimento agli eventi.
Attiva i trigger degli eventi ¶
Per ricevere gli eventi JeriCommerce in Shopify Flow:
- Vai a Settings → Integrations → Shopify.
- Attiva Events.
- Salva le modifiche.
Da quel momento, gli eventi cliente supportati attivano Shopify Flows.
Attiva Events nelle impostazioni dell'integrazione Shopify
Handle dei trigger Flow ¶
In Shopify Flow ogni evento appare come trigger con un handle trasformato in slug. Per esempio, Balance changed diventa balance-changed e Wallet pass installed diventa wallet-pass-installed.
Per i trigger Flow supportati, l'handle usa il nome dell'evento in minuscolo e sostituisce gli spazi con trattini. Consulta la guida di riferimento agli eventi per i dettagli e la disponibilità per canale.
Payload del trigger ¶
Ogni trigger invia a Shopify Flow questa struttura:
{
"id": "event-uuid",
"customerId": "customer-uuid",
"email": "customer@example.com",
"campaignId": "campaign-uuid",
"url": "https://...",
"browser": "Chrome 120",
"createdAt": "2026-03-08T12:00:00Z",
"properties": { ... }
}
Usa l'oggetto properties nelle condizioni e azioni del flusso per accedere ai dati specifici dell'evento, come amount, rewardTitle o i nomi dei livelli previous e current. Consulta la guida di riferimento agli eventi per l'elenco completo delle proprietà.
Azioni disponibili ¶
JeriCommerce offre 8 azioni da usare nei passaggi di qualsiasi Shopify Flow. Non è necessario attivare una funzionalità: sono sempre disponibili.
| Azione | Handle | Funzione |
|---|---|---|
| Invia notifica push | send-push-notification |
Invia una notifica push al wallet pass del cliente |
| Ottieni link di download | get-download-link |
Genera un link monouso per scaricare i wallet pass |
| Aggiungi saldo | add-balance |
Aggiunge punti fedeltà a un cliente |
| Rimuovi saldo | remove-balance |
Rimuove punti fedeltà a un cliente |
| Assegna campagna | assign-campaign |
Assegna una campagna o un pass a un cliente |
| Invia gift card | send-gift-card |
Invia un coupon gift card al cliente |
| Ottieni cliente | get-customer |
Recupera i dati cliente da JeriCommerce |
| Esegui flusso di accumulo | execute-earning-flow |
Esegue un flusso di accumulo personalizzato per il cliente (per esempio CUSTOM_1) e accredita i punti definiti |
Usa Execute earning flow per accreditare punti in seguito ad attività che avvengono al di fuori di JeriCommerce, come la pubblicazione di una recensione, l'invio di una risposta a un sondaggio o la partecipazione a un evento. Abbinala a un flusso personalizzato configurato su Tap and external trigger o External trigger only.
