> 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/bloomreach/setup.md).

# Configuration

Configurez le connecteur The Wallet Crew, connectez les identifiants Bloomreach et installez les activités prédéfinies Bloomreach WebHook.

Connecter **Bloomreach Engagement** avec **L'équipe Wallet Crew** pour orchestrer les parcours de Carte. Les scénarios Bloomreach peuvent déclencher des actions sur la Carte (créer, mettre à jour, notifier). The Wallet Crew envoie également des événements à Bloomreach pour la segmentation et la mesure.

Une configuration minimale de bout en bout prend généralement **1 à 2 heures**. Cela suppose que les droits d'accès et une Carte de test sont disponibles pour valider le flux.

## Prérequis

Avant de commencer, assurez-vous d’avoir :

* **Autorisations Bloomreach**
  * Accès à **Paramètres du projet → Intégrations**.
  * Accès aux identifiants API sous **Paramètres du projet → Gestion des accès → API**.
* **Autorisations The Wallet Crew**
  * Accès à la console d’administration pour configurer le connecteur Bloomreach.
  * Autorisation de créer et de gérer des clés API.
* **Environnement et données de test**
  * Environnement cible identifié (staging vs production).
  * Une Carte de test existe, avec un `passId`connu, pour valider les appels de bout en bout.
  * Toute mise en liste blanche réseau requise et les contraintes de sécurité sont en place.

## Configuration de The Wallet Crew

{% stepper %}
{% step %}

#### Activer le connecteur

Le connecteur Bloomreach doit être activé pour le tenant. Cela est généralement effectué par l'équipe The Wallet Crew.
{% endstep %}

{% step %}

#### Configurer les paramètres généraux

Ouvrez les paramètres du connecteur Bloomreach dans le back-office Wallet Crew.

<p align="center"><a href="https://admin.thewalletcrew.io/tenant/~/integrations/bloomreach/settings" class="button secondary" data-icon="chevrons-right">Ouvrir la page des paramètres généraux</a></p>

<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-9e6cb9821aca9c06323a46cf6136099222c893b4%2Fdocumentation-bloomreach-bloomreach-wallet-integration-general-settings.png?alt=media" alt="The Wallet Crew Bloomreach connector: general settings screen"><figcaption><p>Les paramètres généraux définissent comment The Wallet Crew s’authentifie auprès de Bloomreach.</p></figcaption></figure></div>

Renseignez :

* `Jeton du projet`
* `URL de base de l’API`
* `ID de clé API`
* `Secret API`

Les valeurs Bloomreach sont disponibles sous `Paramètres du projet` → `Gestion des accès` → `API`.

{% hint style="info" %}
Le jeton du projet détermine l’environnement cible. Cela permet de maintenir staging et production séparés.
{% endhint %}

<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-ba43eb739ae6a45f89ab8e0f9df6fb0bb6a6b9f0%2Fdocumentation-bloomreach-bloomreach-api-key.png?alt=media" alt="Bloomreach Engagement API credentials screen showing API keys and project token"><figcaption><p>Utilisez un jeton et une clé API adaptés au bon environnement Bloomreach.</p></figcaption></figure></div>
{% endstep %}

{% step %}

#### Paramètres avancés (extensibilité)

Les paramètres avancés exposent des points d’entrée de script pour le connecteur. Ces scripts contrôlent la résolution des contacts, la transformation des événements et le mappage des champs.

<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-92301f7cc05c647c6273900f0f113b4156b64aae%2Fdocumentation-bloomreach-bloomreach-wallet-integration-advanced-settings.png?alt=media" alt="The Wallet Crew Bloomreach connector: advanced settings screen with script configuration blocks"><figcaption><p>Les paramètres avancés sont utilisés pour les modèles de données personnalisés et la gouvernance.</p></figcaption></figure></div>

Détails et exemples de scripts : [Extensibilité](/connectors/fr/marketing-automation/bloomreach/extensibility.md).
{% endstep %}
{% endstepper %}

## Configuration Bloomreach

{% stepper %}
{% step %}

#### Configurer un schéma d’authentification HTTP

Bloomreach appelle les API de Wallet Crew à l’aide d’une clé API. Celle-ci est configurée une seule fois comme schéma d’authentification HTTP dans Bloomreach.

Dans Bloomreach :

1. Aller à `Données et ressources` → `Intégrations` → `+ Ajouter une nouvelle intégration`.

<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-26422f3c063d8a30817032b1d7788a805334af4f%2Fimage%20(7).png?alt=media" alt="Add new HTTP integration" width="375"><figcaption></figcaption></figure></div>

2. Sélectionner **Schémas d’authentification HTTP**.

<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-b2fb7acdc771933589efe403b84e2a6d24b884ce%2Fimage%20(8).png?alt=media" alt="Http Authentication schemes configuration" width="375"><figcaption></figcaption></figure></div>

3. Configurez le schéma avec une clé API créée dans Wallet Crew.

Une clé API Wallet Crew avec `tenant.Carte:write` Une autorisation est requise. Les clés API sont gérées dans la console d'administration Wallet Crew.

<p align="center"><a href="https://admin.thewalletcrew.io/tenant/~/settings/security/apiKeys" class="button secondary" data-icon="chevrons-right">Ouvrir la configuration des clés API</a></p>

Valeurs du schéma Bloomreach :

<table data-header-hidden data-full-width="true"><thead><tr><th width="141.88885498046875"></th><th></th></tr></thead><tbody><tr><td>Point de terminaison</td><td><code>https://app.neostore.cloud/api</code> (production) ou <code>https://app-qa.neostore.cloud/api</code> (préproduction)</td></tr><tr><td>Type</td><td>En-têtes personnalisés</td></tr><tr><td>Clé</td><td><code>X-API-KEY</code></td></tr><tr><td>Valeur</td><td>La clé API Wallet Crew</td></tr></tbody></table>
{% endstep %}

{% step %}

#### Installer les activités prédéfinies WebHook

Les activités Bloomreach sont installées en tant qu’intégrations prédéfinies WebHook. Une intégration Bloomreach est généralement créée par activité.

Seules les activités nécessaires doivent être installées. Cela simplifie la création de scénarios et réduit les dérives de configuration.

{% hint style="info" %}
Les icônes des activités sont disponibles dans un fichier :

{% file src="/files/c55600c4999d7e1ad7f18eb1bd86a6243936be46" %}
{% endhint %}

Les exemples de charge utile utilisent la syntaxe des paramètres prédéfinis WebHook de Bloomreach.

<details>

<summary><strong>Mettre à jour la Carte ("Push Update")</strong></summary>

URL du point de terminaison :

```
PATCH https://app.neostore.cloud/api/<<tenantId>>/passes/?id=[[ {name: 'passId', tooltip: 'Identifiant de la Carte', category: 'Cible de Carte', isJsonParam: true} : string]]
```

Charge utile minimale (options uniquement) :

```json
{
  "options": {
    "correlationId": "[[ {name: 'Correlation Id', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : string]]"
  }
}
```

Exemple de charge utile à mettre à jour `additionalData`:

```json
{
  "additionalData": {
    "xx": "[[ {name: 'xx', tooltip: 'xx', category: 'Contenu', orderIndex: 10, isJsonParam: true} : string]]", 
    "xy": "[[ {name: 'xy', tooltip: 'xy', category: 'Contenu', orderIndex: 11, isJsonParam: true} : string]]"
  },
  "options": {
    "correlationId": "[[ {name: 'Correlation Id', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : string]]"
  }
}
```

Exemple de charge utile pour changer le modèle de carte (`passType`):

```json
{
  "passType": "newTemplate",
  "options": {
    "correlationId": "[[ {name: 'Correlation Id', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : string]]"
  }
}
```

Référence de l’API : [Guide du développeur](/developers-guides/fr/readme.md).

</details>

<details>

<summary><strong>Notifier</strong></summary>

URL du point de terminaison :

```
PATCH https://app.neostore.cloud/api/<<tenantId>>/passes/notification?id=[[ {name: 'passId', tooltip: 'Identifiant de la carte', category: 'Cible de la Carte', isJsonParam: true} : string]]
```

Exemple de charge utile (une seule langue) :

```json
{
  "content": "[[ {name: 'Contenu de la notification', tooltip: 'Contenu de la notification', category: 'Contenu', orderIndex: 10, isJsonParam: true} : string]]",
  "options": {
    "updateData": [[ {name: 'Mettre à jour les données', tooltip: 'Mettre également à jour les données de la Carte lorsque la notification est envoyée', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : boolean | false]],
    "correlationId": "[[ {name: 'Correlation Id', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : string]]"
  }
}
```

Exemple de charge utile (localisée) :

```json
{
  "localizedContent": {
    "en": "[[ {name: 'Contenu de la notification (en)', tooltip: 'Contenu de la notification', category: 'Contenu', orderIndex: 10, isJsonParam: true} : string]]",
    "fr": "[[ {name: 'Contenu de la notification (fr)', tooltip: 'Contenu de la notification', category: 'Contenu', orderIndex: 11, isJsonParam: true} : string]]"
  },
  "options": {
    "updateData": [[ {name: 'Mettre à jour les données', tooltip: 'Mettre également à jour les données de la Carte lorsque la notification est envoyée', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : boolean | false]],
    "correlationId": "[[ {name: 'Correlation Id', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : string]]"
  }
}
```

Référence de l’API : [Guide du développeur](/developers-guides/fr/readme.md).

</details>

<details>

<summary><strong>Appliquer le privilège</strong></summary>

URL du point de terminaison :

```
POST https://app.neostore.cloud/api/<<tenantId>>/passes/[[ {name: 'passId', tooltip: 'Identifiant de la Carte', category: 'Cible de la Carte', isJsonParam: true} : string]]/privileges
```

Exemple de charge utile (privilège non localisé) :

```json
{
  "type": "multiUse",
  "origin": {
    "generator": "bloomreach",
    "processId": "[[ {name: 'Identifiant du processus', tooltip: 'Identifiant du scénario / de la campagne', category: 'Configuration avancée', orderIndex: 120, isJsonParam: true} : string]]"
  },
  "priority": [[ {name: 'Priorité', tooltip: 'Des valeurs élevées signifient une priorité plus forte', category: 'Configuration avancée', orderIndex: 110, isJsonParam: true} : number]],
  "content": {
    "title": {
      "value": "[[ {name: 'Titre', tooltip: 'Titre de ce privilège', category: 'Contenu', orderIndex: 10, isJsonParam: true} : string]]"
    },
    "description": {
      "value": "[[ {name: 'Description', tooltip: 'Description de ce privilège', category: 'Contenu', orderIndex: 20, isJsonParam: true} : string]]"
    }
  },
  "appearance": {
    "mainImageUrl": {
      "value": "[[ {name: 'Image principale', tooltip: 'URL de l’image principale', category: 'Contenu', orderIndex: 30, isJsonParam: true} : image]]"
    }
  },
  "options": {
    "correlationId": "[[ {name: 'Id de corrélation', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 130, isJsonParam: true} : string]]"
  }
}
```

Référence de l’API : [Guide du développeur](/developers-guides/fr/readme.md).

</details>

{% hint style="danger" %}
Les points de terminaison incluent `<<tenantId>>`. Remplacez-le par l’identifiant du tenant de The Wallet Crew.
{% endhint %}

Pour en savoir plus sur les activités : [Activités Bloomreach](/connectors/fr/marketing-automation/bloomreach/bloomreach-activities.md).
{% endstep %}
{% endstepper %}

## Liste de vérification de validation

Une exécution de validation minimale couvre généralement :

* Une Carte de test existe et son `passId` est disponible dans Bloomreach.
* Une activité de mise à jour de la Carte actualise le contenu visible sur la Carte.
* Une activité Notify envoie un message.
* Une installation/désinstallation de test produit des événements Bloomreach.

Noms et propriétés des événements : [Événements](/connectors/fr/marketing-automation/bloomreach/events.md).

## Bonnes pratiques

* **Préproduction d'abord** : validez les activités et les événements dans un jeton de projet Bloomreach de test.
* **Déploiement progressif** : installez d'abord uniquement Notify, puis ajoutez Appliquer le privilège.
* **Configuration multi-équipes** : l’IT configure les identifiants et les listes d’autorisation, le marketing installe les activités du scénario.

## FAQ

<details>

<summary><strong>Qui est généralement responsable de la configuration ?</strong></summary>

L’activation du connecteur et les identifiants sont généralement gérés par l’IT ou un partenaire d’implémentation. L’installation des activités et l’utilisation du scénario relèvent souvent du CRM ou des opérations marketing.

</details>

<details>

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

Un environnement de préproduction est généralement configuré en premier. Cela permet de valider les activités, les événements et les scripts avant la production.

</details>

<details>

<summary><strong>Quelles autorisations sont requises pour la clé API utilisée par Bloomreach ?</strong></summary>

Une clé avec `tenant.Carte:write` Une autorisation est requise pour les activités qui mettent à jour des pass. Des autorisations supplémentaires peuvent être requises selon l’ensemble d’activités.

</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/bloomreach/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.