Cette action récupère un lien personnel avec lequel un client télécharge sa carte de fidélité. En l’ouvrant, il choisit entre Apple Wallet et Google Wallet. Ajoutez-le à un e-mail, à un SMS ou à votre propre site pour que plus de clients installent leur carte.

Chaque lien appartient à un seul client : ne le partagez avec personne d’autre. Pour obtenir un lien unique pour tout le monde, utilisez plutôt une URL personnalisée pour télécharger la carte de fidélité.

Mise en place

Utilisez l’action JeriCommerce Get Download Loyalty Card Link dans un workflow Shopify Flow. Elle renvoie le lien aux étapes suivantes du workflow : vous pouvez donc l’utiliser tout de suite, par exemple dans un e-mail ou une note client.

1

Ajouter l’action

Dans Shopify, ouvrez Flow, créez ou modifiez un workflow, puis ajoutez Get Download Loyalty Card Link après votre déclencheur.

2

Renseigner l’adresse e-mail

Dans Email, ajoutez l’adresse e-mail du client. Utilisez Add variable pour la reprendre du déclencheur.

3

Utiliser le lien à l’étape suivante

Dans l’action suivante, utilisez Add variable et choisissez downloadPassUrl, le lien renvoyé par l’action.

Si l’adresse e-mail n’appartient à aucun client de votre programme, l’étape échoue et la raison apparaît dans l’historique d’exécution du workflow.

Vous n’avez peut-être pas besoin d’un workflow : JeriCommerce peut aussi enregistrer le lien dans le profil Shopify de chaque client. Consultez Synchroniser l’URL de téléchargement avec les profils Shopify.

Les webhooks Klaviyo ne peuvent qu’envoyer des données, pas en lire : un webhook ne peut donc pas récupérer le lien. Vous n’en avez pas besoin : activez Custom Fields dans l’intégration Klaviyo, et JeriCommerce enregistre le lien dans chaque profil Klaviyo sous le nom jericommerce_download_wallet_pass_url.

Utilisez-le dans n’importe quel e-mail ou SMS avec {{ person.jericommerce_download_wallet_pass_url }}. Consultez Synchroniser les champs personnalisés avec Klaviyo pour l’activer.

Demandez un jeton de type download pour le client, puis construisez le lien avec celui-ci.

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

Envoyez votre clé API dans l’en-tête api-key. Consultez Authentification via l’API. La réponse contient le jeton :

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

Encodez accessToken en Base64 et ajoutez-le à cette URL :

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

Si vous n’envoyez pas expires_in, le lien n’expire jamais. Définissez toujours une expiration adaptée à la façon dont vous le partagez, comme 7d pour une campagne e-mail.

Pour tous les paramètres, les erreurs et les liens qui connectent les clients à la Customer App, consultez Jetons client.

Construisez une requête prête à l’emploi avec vos propres valeurs :

Vos informations

Retrouvez-le dans Settings > Technical > Program Information.

Créez-en une dans Settings > Technical > API Keys. Elle reste dans votre navigateur.

Détails de l’action

Votre requête

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'

Collez-la dans un terminal pour tester la requête avec votre programme.