Configuration

Préparez Salesforce Marketing Cloud et The Wallet Crew pour des liens de Carte authentifiés, des mises à jour de Carte et des 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 tenant cible est connu.
• Un contact de test existe dans Salesforce Marketing Cloud.

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

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

1

Copiez le secret partagé de The Wallet Crew

Ouvrez les secrets de sécurité du tenant 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éez une clé symétrique dans Salesforce Marketing Cloud

Ouvrez Configuration → Administration → Gestion des clés.

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

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

3

Enregistrez la valeur de clé externe

Gardez la valeur de clé externe à portée de main.

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

Créez le package installé pour Journey Builder

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

1

Créez le package

Ouvrez Configuration → Applications → Packages installés.

Créez un package nommé L'équipe Wallet.

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

2

Copiez 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

Demandez au support The Wallet Crew d’activer le connecteur Salesforce Marketing Cloud

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

Demandez au support The Wallet Crew d’activer le connecteur avant de continuer.

4

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

Ouvrez 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

Enregistrez les activités Journey Builder

À partir du même package, ajoutez un composant d’activité Journey Builder 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 tenant The Wallet Crew.

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

Validez 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 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 le bon identifiant de tenant.
• 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é est uniquement requis pour les activités personnalisées Journey Builder.

Les liens de Carte Email Studio nécessitent uniquement la clé de signature symétrique.

Quel environnement doit être configuré en premier ?

L’environnement de préproduction doit être configuré en premier.

Cela facilite la validation de la signature du jeton, 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 discordance entre le secret The Wallet Crew et la clé symétrique Salesforce Marketing Cloud.

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

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