> 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

Préparez Salesforce Marketing Cloud et The Wallet Crew pour les liens de cartes authentifiés, les mises à jour de cartes 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.

## Prérequis

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

* **The Wallet Crew**: accès à la console d’administration.
* **Salesforce Marketing Cloud**: accès à **Configuration**, **Gestion des clés**, **Content Builder**, et **Packages installés**.
* Le connecteur Salesforce Marketing Cloud est activé sur le tenant. Demandez à l’assistance The Wallet Crew de l’activer avant de continuer.
* L’identifiant du tenant cible est connu.
* Un contact de test existe dans Salesforce Marketing Cloud.

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

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

{% stepper %}
{% step %}

#### Copiez le secret partagé depuis The Wallet Crew

Dans la console d’administration, ouvrez **Paramètres → Contrôle d’accès → Clés API et secrets**, **Secrets généraux** onglet, puis copiez **Secret 1**. 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

Ouvrez **Configuration → Administration → Gestion des clés**.

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

<div data-with-frame="true"><figure><img src="https://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-eda7cfb5ac44fab99eddb433e31a5bad18598098%2Fsalesforce-marketing-cloud-symmetric-key-clean.png?alt=media" 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 de The Wallet Crew comme clé prépartagée.</p></figcaption></figure></div>
{% endstep %}

{% step %}

#### Enregistrez la valeur de la clé externe

Conservez 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 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é **The Wallet Crew**.

<div data-with-frame="true"><figure><img src="https://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-7d121b561cfff22fdba524b3d6e489a8732ff1a1%2Fsalesforce-marketing-cloud-installed-package-clean.png?alt=media" 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 le secret de signature JWT

Ouvrez le package et copiez le **Secret de signature JWT**.

<div data-with-frame="true"><figure><img src="https://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-ae541deb4b42a6bda9ad82f1e878838872fb2e31%2Fsalesforce-marketing-cloud-package-jwt-signing-key-masked.png?alt=media" alt="Salesforce Marketing Cloud installed package screen with the JWT Signing Secret highlighted"><figcaption><p>Le secret de signature JWT est requis par la configuration de l’activité personnalisée The Wallet Crew.</p></figcaption></figure></div>
{% endstep %}

{% step %}

#### Collez la clé de connexion dans la console d’administration

Ouvrez **Données et intégrations → Connecteurs → Automatisation marketing → SFMC** dans la console d’administration (la page est intitulée Salesforce Marketing Cloud ; [ouvrez la page SFMC](https://admin.thewalletcrew.io/tenant/~/data/connectors/sfmc)).

Collez le **Secret de signature JWT** copié 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 **activité Journey Builder** composant pour chaque activité.

Utilisez ces valeurs pour **Envoyer la mise à jour**:

* **Catégorie**: `Messages`
* **URL du point de terminaison**: `https://<host>/api/<tenantId>/webhooks/listeners/sfmc/actions/pushupdate`

Utilisez ces valeurs pour **Notifier**:

* **Catégorie**: `Messages`
* **URL du point de terminaison**: `https://<host>/api/<tenantId>/webhooks/listeners/sfmc/actions/notify`

`<tenantId>` est l’identifiant du tenant. `<host>` est l’hôte de production ou de préproduction de [Environnements et URL](https://docs.thewalletcrew.io/connectors/fr/marketing-automation.md#environments-and-urls): utilisez le même hôte pour chaque activité enregistrée dans un package, et enregistrez un package distinct pour la préproduction. Les chemins sont en minuscules (`pushupdate`, `notify`).

<div data-with-frame="true"><figure><img src="https://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-b62a3dde19552703892832b6c02fe73f909a81da%2Fsalesforce-marketing-cloud-activity-form-clean.png?alt=media" 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 tenant.</p></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## Validez la configuration

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

* Vérifiez que chaque URL de point de terminaison contient l’identifiant de tenant correct.
* Vérifiez qu’un contact de test est disponible pour l’aperçu et les tests de parcours.

## FAQ

<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 de The Wallet Crew et la clé symétrique Salesforce Marketing Cloud.

Pour Journey Builder, le problème courant suivant est un identifiant de tenant incorrect 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
