> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/fr/marketing-automation/salesforce-marketing-cloud/setup.md).

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

{% stepper %}
{% step %}

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

{% step %}

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

<div data-with-frame="true"><figure><img src="/files/7498d56ec2f776d2fcbee441ab473a4966363913" 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 enregistrez le secret The Wallet Crew comme clé prépartagée.</p></figcaption></figure></div>
{% endstep %}

{% step %}

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

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

{% stepper %}
{% step %}

### Créez le package

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

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

<div data-with-frame="true"><figure><img src="/files/4e663259cc57d19722bc5a23bbae2689177cdc45" 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 %}

### Copiez la clé de connexion JWT

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

<div data-with-frame="true"><figure><img src="/files/780e35975b642c7f2f1471154704fc45fbc570ad" 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 %}

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

{% step %}

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

{% step %}

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

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

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

<details>

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

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.

</details>

<details>

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

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.

</details>

<details>

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

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.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/connectors/fr/marketing-automation/salesforce-marketing-cloud/setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.