# Configuration

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.

<details>

<summary><strong>Exemples concrets</strong></summary>

* 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.

</details>

## 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.

{% stepper %}
{% step %}

### 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.
{% endstep %}

{% step %}

### 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**.

<div data-with-frame="true"><figure><img src="/files/9d153ecbe97276c96b8a3d3661d4b72f62206db6" alt="Salesforce Marketing Cloud Key Management screen used to create a symmetric key for The Wallet Crew"><figcaption><p>Créez une clé symétrique et stockez le secret The Wallet Crew comme clé prépartagée.</p></figcaption></figure></div>
{% endstep %}

{% step %}

### 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`.
{% endstep %}
{% endstepper %}

## 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.

{% stepper %}
{% step %}

### Créer le package

Ouvrir **Configuration** → **Applications** → **Packages installés**.

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

<div data-with-frame="true"><figure><img src="/files/468c35d445da84c3b86936f899409ab353aab421" alt="Salesforce Marketing Cloud Installed Packages screen showing creation of a The Wallet Crew package"><figcaption><p>Créez un package installé dédié pour l’activité Journey Builder de The Wallet Crew.</p></figcaption></figure></div>
{% endstep %}

{% step %}

### Copier la clé de connexion JWT

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

<div data-with-frame="true"><figure><img src="/files/4f7ab9f661cdaeb40e8f3ec72c3f75349dd829af" alt="Salesforce Marketing Cloud package screen showing the JWT Signin Key"><figcaption><p>La clé de connexion JWT est requise par la configuration de l’activité personnalisée The Wallet Crew.</p></figcaption></figure></div>
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### 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.

<div data-with-frame="true"><figure><img src="/files/4326ac0adbff399ad21bbc8ae358c76e0b36522e" alt="Salesforce Marketing Cloud Journey Builder Activity component form for The Wallet Crew push update endpoint"><figcaption><p>Enregistrez l’activité Journey Builder de The Wallet Crew avec le point de terminaison de mise à jour Push spécifique au locataire.</p></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## 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

<details>

<summary><strong>Le package installé est-il requis pour les liens de Carte Email Studio ?</strong></summary>

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.

</details>

<details>

<summary><strong>Quel environnement doit être configuré en premier ?</strong></summary>

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.

</details>

<details>

<summary><strong>Quelle est l’erreur de configuration la plus courante ?</strong></summary>

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.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thewalletcrew.io/docs/fr/connecter/marketing-automation/salesforce-marketing-cloud/configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.