> 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/email-provider/adobe-marketing-cloud/adobe-journey-optimizer.md).

# Adobe Journey Optimizer

Envoyer les e-mails transactionnels de The Wallet Crew via Adobe Journey Optimizer (AJO) à l’aide du fournisseur d’e-mails du script.

Utilisez cette option lorsque **Adobe Journey Optimizer (AJO)** est disponible et **les envois déclenchés par API** s’intègrent au modèle d’orchestration du parcours en place.

Commencez par [Adobe Marketing Cloud](https://docs.thewalletcrew.io/connectors/fr/email-provider/adobe-marketing-cloud.md) et le prérequis [Extensibilité de EmailSender](https://docs.thewalletcrew.io/connectors/fr/custom-connector/emailsender-extensibility.md).

## Configuration requise dans Adobe

Créez un parcours ou une campagne déclenché par API qui peut accepter un appel d’exécution. Configurez ensuite l’action e-mail.

Au minimum, convenez de ce que le script envoie à AJO.

* **HTML entièrement rendu** de l’équipe Wallet (`Objet`, `Corps`).
* Ou **uniquement des variables de contexte**, avec le modèle géré dans AJO.

## Notes d’implémentation (OAuth + déclencheur)

AJO utilise Adobe IMS pour OAuth2 (identifiants client). Le script demande généralement un jeton d’accès, puis appelle le point de terminaison d’exécution AJO pour la campagne ou le parcours cible.

{% hint style="info" %}
Les points de terminaison Adobe et les structures de charge utile dépendent de la configuration de l’organisation, de la région et de la fonctionnalité AJO utilisée (parcours vs campagne). Considérez l’extrait ci-dessous comme une base, et alignez-le sur la documentation Adobe officielle de la version du produit concernée.
{% endhint %}

Stockez ces valeurs comme secrets du tenant avant de tester :

* `adobe-clientId`
* `adobe-clientSecret`
* `adobe-orgId`
* `adobe-sandboxName`
* `adobe-ajo-triggerUrl` (le point de terminaison d’exécution de la campagne déclenchée par API, d’après la référence de l’API Adobe Journey Optimizer)
* `adobe-ajo-campaignId` (l’ID de la campagne déclenchée par API)
* `adobe-scope` (facultatif : les scopes de l'identifiant, tels qu'indiqués dans Adobe Developer Console)

Le corps de la requête suit les exemples de campagne déclenchée par API d’Adobe : un `campaignId` et un `recipients` tableau, où chaque destinataire porte un `type`, un `namespace`, un `userId` et un `context` objet. Voir [Déclencher des campagnes à l’aide d’API : exemples de code](https://developer.adobe.com/journey-optimizer-apis/references/messaging-samples).

L’exemple génère une URL de Carte non signée : voir [Liens de Carte dans les e-mails](https://docs.thewalletcrew.io/connectors/fr/custom-connector/emailsender-extensibility.md#pass-links-in-emails).

{% code title="Exemple Adobe Journey Optimizer (implémentation SendEmail)" %}

```javascript
import { getSecret } from "twc/secrets";

const CUSTOM_DOMAIN = "wallet.brand.com";
const TENANTID = "brand";

// Adobe IMS (identifiants clients OAuth2)
// Votre environnement d’exécution fournit un `fetch` personnalisé capable d’effectuer des flux OAuth de type identifiants client.
const IMS_TOKEN_URL = "https://ims-na1.adobelogin.com/ims/token/v3";

async function sendEmail(recipient, emailTemplate, data, cultures, buildEmail) {
  const email = recipient;
  const countryCode = data["country"] || "fr";
  const language = `${cultures[0]?.toLowerCase()?.substring(0, 2) || "fr"}_${countryCode.toLowerCase()}`;
  const customerId = data["id.customerId"];

  if (!customerId) {
    throw new Error('Valeur manquante "id.customerId" dans les données de l'e-mail.');
  }

  // URL sur laquelle le client doit cliquer pour télécharger sa Carte.
  // Vous pouvez modifier le chemin pour l’adapter à votre structure de distribution.
  const url = `https://${CUSTOM_DOMAIN}/${TENANTID}/Carte?id.customerId=${encodeURIComponent(customerId)}`;

  // Facultatif : conserver le rendu de Wallet Crew disponible.
  // Si votre modèle AJO est entièrement géré dans Adobe, vous pouvez supprimer ceci.
  const rendered = await buildEmail(emailTemplate);

  // La configuration AJO doit être fournie sous forme de secrets.
  const ajoTriggerUrl = await getSecret("adobe-ajo-triggerUrl");
  const campaignId = await getSecret("adobe-ajo-campaignId");
  const orgId = await getSecret("adobe-orgId");
  const sandboxName = await getSecret("adobe-sandboxName");
  const clientId = await getSecret("adobe-clientId");
  const clientSecret = await getSecret("adobe-clientSecret");

  // Facultatif : les scopes des identifiants dans la console Adobe Developer.
  const scope = await getSecret("adobe-scope");

  const authentication = {
    mode: "OAuth2.0",
    grantType: "clientCredentials",
    sendCredentialsAsFormParams: true,
    accessTokenUrl: IMS_TOKEN_URL,
    clientId,
    clientSecret,
  };
  if (scope) authentication.scope = scope;

  // Votre `fetch` d’exécution gère les identifiants client OAuth et joint le jeton.
  // Cela évite d’appeler IMS manuellement puis de transmettre le jeton Bearer.
  const result = await fetch(ajoTriggerUrl, {
    Method: "POST",
    Authentication: authentication,
    Headers: {
      "x-api-key": clientId,
      "x-gw-ims-org-id": orgId,
      "x-sandbox-name": sandboxName,
      "Content-Type": "application/json",
    },
    Body: JSON.stringify({
      // Conservez ce contrat stable entre votre script et votre campagne AJO.
      campaignId,
      recipients: [
        {
          type: "aep",
          namespace: "email",
          userId: email,
          context: {
            // Variable minimale pour un modèle géré par Adobe :
            url,
            language,

            // Variables facultatives si vous souhaitez réutiliser le rendu de Wallet Crew dans Adobe :
            subject: rendered.Subject,
            body: rendered.Body,

            // Métadonnées utiles pour le routage / le débogage :
            template: emailTemplate,
            customerId,
          },
        },
      ],
    }),
    ThrowOnError: false,
  });

  if (result.StatusCode < 200 || result.StatusCode >= 300) {
    throw new Error(`L’appel du déclencheur AJO a échoué (${result.StatusCode}) : ${result.ResponseText}`);
  }
}

export default function (context) {
  context.register("runtime.scriptable.emailEngine", {
    SendEmail: sendEmail,
  });
}
```

{% endcode %}

## Ce qu'il faut valider

Déclenchez un véritable e-mail transactionnel, puis validez ces points :

* AJO reçoit l’appel d’exécution et l’accepte.
* L’action e-mail AJO a accès aux champs contextuels qui ont été envoyés.
* Lorsque le HTML est passé, l’e-mail final s’affiche correctement dans les clients courants.

## FAQ

<details>

<summary><strong>Un “parcours déclenché par API” est-il requis dans AJO ?</strong></summary>

Oui. Le script a besoin d’un élément AJO publié qui puisse être déclenché par un appel API. Le type exact d’élément (parcours ou campagne) dépend de ce qu’utilise l’organisation Adobe.

</details>

<details>

<summary><strong>Comment tester cela sans envoyer d’e-mails à de vrais clients ?</strong></summary>

Utilisez un sandbox AJO lorsqu’il est disponible. Sinon, limitez les tests aux adresses internes et créez un parcours ou une campagne « test » dédié(e). Conservez un contrat de charge utile identique à la production afin d’éviter les ruptures de schéma de dernière minute.

</details>

<details>

<summary><strong>Pourquoi autant d’en-têtes Adobe sont-ils nécessaires ?</strong></summary>

Les passerelles AJO exigent généralement des en-têtes d’organisation, de sandbox et de clé API pour le routage et l’autorisation. L’ensemble exact peut varier selon la configuration et la région Adobe ; considérez donc la documentation Adobe officielle comme la source de vérité pour le tenant.

</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/email-provider/adobe-marketing-cloud/adobe-journey-optimizer.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.
