Configuration

Préparez Salesforce Marketing Cloud et The Wallet Crew pour les liens de carte authentifiés, les mises à jour de carte et les notifications wallet.

Cette configuration prépare les éléments partagés utilisés par l’intégration Salesforce Marketing Cloud. Elle couvre les clés de signature pour les liens authentifiés et le package installé utilisé par les activités personnalisées Journey Builder.

Exemples concrets

• Une équipe CRM souhaite des liens de Carte personnalisés dans Email Studio.

• Une équipe marketing souhaite que Journey Builder déclenche des mises à jour de Carte après un achat ou un changement de niveau.

• Une équipe CRM souhaite que Journey Builder envoie des notifications Wallet sans modifier les données de Carte.

• Un partenaire d’implémentation souhaite une configuration de préproduction avant le déploiement en production.

Prérequis

Un accès est requis des deux côtés.

• L’équipe Wallet: accès à la console d’administration.

• Salesforce Marketing Cloud: accès à Configuration, Gestion des clés, Content Builder, et Packages installés.

• L’identifiant du locataire cible est connu.

• Un contact de test existe dans Salesforce Marketing Cloud.

Configurer la clé de signature pour les liens de Carte authentifiés

Le lien de Carte The Wallet Crew est signé comme un JWT. Salesforce Marketing Cloud a besoin d’une clé symétrique pour signer ce jeton dans AMPscript.

1

Copier le secret partagé de The Wallet Crew

Ouvrez les secrets de sécurité du locataire dans la console d’administration The Wallet Crew.

Copiez le premier secret. Cette valeur est utilisée comme clé prépartagée dans Salesforce Marketing Cloud.

2

Créer une clé symétrique dans Salesforce Marketing Cloud

Ouvrir Configuration → Administration → Gestion des clés.

Créer une nouvelle clé symétrique et coller le secret The Wallet Crew dans Clé prépartagée.

Créez une clé symétrique et stockez le secret The Wallet Crew comme clé prépartagée.

3

Enregistrer la valeur de la clé externe

Gardez la valeur de la clé externe à disposition.

L’exemple AMPscript utilise cette valeur comme @keyId lors de l’appel de GetJWTByKeyName.

Créer le package installé pour Journey Builder

Ce package n’est requis que lorsque Journey Builder doit déclencher des mises à jour de Carte ou des notifications Wallet.

1

Créer le package

Ouvrir Configuration → Applications → Packages installés.

Créer un package nommé L’équipe Wallet.

Créez un package installé dédié pour l’activité Journey Builder de The Wallet Crew.

2

Copier la clé de connexion JWT

Ouvrez le package et copiez la clé de connexion JWT.

La clé de connexion JWT est requise par la configuration de l’activité personnalisée The Wallet Crew.

3

Demander à l’assistance The Wallet Crew d’activer le connecteur Salesforce Marketing Cloud

Le connecteur Salesforce Marketing Cloud doit d’abord être activé sur le locataire.

Demandez à l’assistance The Wallet Crew d’activer le connecteur avant de continuer.

4

Coller la clé de connexion dans le back-office The Wallet Crew

Ouvrir Données et intégrations → Connecteurs → SFMC dans le back-office The Wallet Crew.

Collez la clé de connexion JWT copiée depuis le package Salesforce Marketing Cloud dans Clé de connexion, puis enregistrez.

5

Enregistrer les activités Journey Builder

À partir du même package, ajoutez un composant Journey Builder Activity pour chaque activité.

Utilisez ces valeurs pour Mise à jour Push:

• Catégorie: Messages

• URL du point de terminaison: https://app.neostore.cloud/api/<tenantId>/webhooks/listeners/sfmc/actions/pushupdate

Utilisez ces valeurs pour Notifier:

• Catégorie: Messages

• URL du point de terminaison: https://app.neostore.cloud/api/<tenantId>/webhooks/listeners/sfmc/actions/notify

<tenantId> est l’identifiant du locataire The Wallet Crew.

Enregistrez l’activité Journey Builder de The Wallet Crew avec le point de terminaison de mise à jour Push spécifique au locataire.

Valider la configuration

La validation doit commencer avant toute création de campagne.

• Confirmez que la clé symétrique existe dans Gestion des clés.

• Confirmez que la valeur de la clé externe est disponible pour AMPscript.

• Confirmez que le package installé contient le composant d’activité Journey Builder requis par le cas d’utilisation cible.

• Confirmez que le Clé de connexion est enregistré dans Données et intégrations → Connecteurs → SFMC.

• Confirmez que chaque URL de point de terminaison contient l’identifiant de locataire correct.

• Confirmez qu’un contact de test est disponible pour l’aperçu et les tests de parcours.

FAQ

Le package installé est-il requis pour les liens de Carte Email Studio ?

Non. Le package installé n’est requis que pour les activités personnalisées de Journey Builder.

Les liens de Carte Email Studio n’ont besoin que de la clé de signature symétrique.

Quel environnement doit être configuré en premier ?

La préproduction doit être configurée en premier.

Cela facilite la validation de la signature des jetons, de la résolution des contacts et de l’exécution de Journey Builder avant le déploiement en production.

Quelle est l’erreur de configuration la plus courante ?

Le problème le plus courant est une incompatibilité entre le secret The Wallet Crew et la clé symétrique Salesforce Marketing Cloud.

Pour Journey Builder, l’autre problème courant est un mauvais identifiant de locataire dans l’URL du point de terminaison.

Un autre problème courant est l’enregistrement du mauvais point de terminaison d’activité pour le cas d’utilisation prévu.