Questa azione ottiene un link personale da cui un cliente scarica la sua carta fedeltà. Quando lo apre, sceglie tra Apple Wallet e Google Wallet. Aggiungilo a un'email, a un SMS o al tuo sito per far installare la carta a più clienti.

Ogni link appartiene a un solo cliente, quindi non condividerlo con nessun altro. Per avere un unico link per tutti, usa invece un URL personalizzato per scaricare la carta fedeltà.

Configurazione

Usa l'azione Get Download Loyalty Card Link di JeriCommerce in un workflow di Shopify Flow. Restituisce il link ai passaggi successivi del workflow, così puoi usarlo subito, per esempio in un'email o in una nota sul cliente.

1

Aggiungi l'azione

In Shopify apri Flow, crea o modifica un workflow e aggiungi Get Download Loyalty Card Link dopo il trigger.

2

Compila l'email

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

3

Usa il link nel passaggio successivo

Nell'azione successiva, usa Add variable e scegli downloadPassUrl, il link restituito dall'azione.

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

Forse non ti serve nemmeno un workflow: JeriCommerce può salvare il link anche nel profilo Shopify di ogni cliente. Consulta Sincronizza l'URL di download con i profili Shopify.

I webhook di Klaviyo possono solo inviare dati, non leggerli, quindi un webhook non può recuperare il link. Non ne hai bisogno: attiva Custom Fields nell'integrazione Klaviyo e JeriCommerce salva il link in ogni profilo Klaviyo come jericommerce_download_wallet_pass_url.

Usalo in qualsiasi email o SMS con {{ person.jericommerce_download_wallet_pass_url }}. Consulta Sincronizza i campi personalizzati con Klaviyo per attivarlo.

Richiedi un token di tipo download per il cliente, poi costruisci il link con quello.

GET https://api.jericommerce.com/v1/programs/{program_slug}/customers/token?email={customerEmail}&token_type=download&expires_in=7d

Invia la tua chiave API nell'header api-key. Consulta Autenticazione tramite API. La risposta contiene il token:

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Codifica accessToken in Base64 e aggiungilo a questo URL:

https://jeri.link/{program_slug}/download?token={base64Token}

Se non invii expires_in, il link non scade mai. Imposta sempre una scadenza adatta al modo in cui lo condividi, come 7d per una campagna email.

Per tutti i parametri, gli errori e i link che fanno accedere i clienti alla Customer App, consulta Token cliente.

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.

Dettagli dell’azione

La tua richiesta

curl --request GET \
  --url 'https://api.jericommerce.com/v1/programs/your-program-slug/customers/token?email=customer%40example.com&token_type=download&expires_in=7d' \
  --header 'api-key: your-api-key'

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