> 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-campaign-transactional-messaging.md).

# Adobe Campaign Classic : messagerie transactionnelle

Envoyez les e-mails transactionnels de The Wallet Crew via Adobe Campaign Classic Transactional Messaging en utilisant le fournisseur de scripts pour les e-mails.

Utilisez cette option lorsque l'organisation exécute **Adobe Campaign Classic** et utilise déjà **la messagerie transactionnelle** pour les envois de production.

{% hint style="info" %}
**Quelle page ?** Cette page explique comment Wallet Crew envoie ses e-mails transactionnels via Adobe Campaign Classic. Pour mettre à jour des passes depuis un workflow Adobe Campaign Classic, voir [Adobe Campaign dans l'automatisation marketing](https://docs.thewalletcrew.io/connectors/fr/marketing-automation/adobe-campaign.md).
{% endhint %}

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

L'exemple de cette page appelle l'API REST de messagerie transactionnelle Adobe Campaign : une `POST` à `https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>` avec le destinataire dans `email` et les données de l'événement dans `ctx`. Adobe documente cette API pour [Campaign Standard](https://experienceleague.adobe.com/en/docs/campaign-standard/using/working-with-apis/managing-transactional-messages) et pour [Campaign v8](https://experienceleague.adobe.com/en/docs/experience-cloud/campaign/apis/managing-transactional-messages), où Adobe la restreint aux utilisateurs migrés depuis Campaign Standard. Vérifiez qu'elle est disponible sur l'instance.

## Configuration requise dans Adobe

Créez et publiez un **événement de message transactionnel**.

Décidez ensuite si Adobe Campaign utilisera le HTML rendu par Wallet Crew ou construira l'e-mail final à l'aide des modèles et variables Adobe Campaign.

Une méthode d'authentification sécurisée côté serveur prise en charge par le déploiement Adobe Campaign est également requise. Elle est souvent basée sur Adobe I/O ou IMS.

## Notes d'implémentation (appel d'événement)

Le script génère généralement l'e-mail (lorsque Wallet Crew contrôle le HTML), puis appelle le point de terminaison de l'événement transactionnel avec le destinataire et le contexte.

Stockez ces valeurs comme secrets du tenant avant de tester :

* `adobe-clientId`
* `adobe-clientSecret`
* `adobe-campaign-transactionalUrl` (URL complète de l'événement de message transactionnel)
* `adobe-scope` (facultatif : les scopes de l'identifiant, tels qu'indiqués dans Adobe Developer Console)

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 Campaign Classic (implémentation SendEmail)" %}

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

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

// Adobe IMS (identifiants clients OAuth2)
const IMS_TOKEN_URL = "https://ims-na1.adobelogin.com/ims/token/v3";

/**
 * @typedef {Object} EmailData
 * @property {string} Objet
 * @property {string} Corps
 */

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.');
  }

  const url = `https://${CUSTOM_DOMAIN}/${TENANTID}/Carte?id.customerId=${encodeURIComponent(customerId)}`;

  // Conservez la capacité de rendu de Wallet Crew.
  // Si Adobe Campaign possède le modèle, vous pouvez supprimer cela et n'envoyer que les variables.
  const rendered = await buildEmail(emailTemplate);

  const transactionalUrl = await getSecret("adobe-campaign-transactionalUrl");

  const clientId = await getSecret("adobe-clientId");
  const clientSecret = await getSecret("adobe-clientSecret");
  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;

  const headers = {
    "x-api-key": clientId,
    "Content-Type": "application/json;charset=utf-8",
  };

  const result = await fetch(transactionalUrl, {
    Method: "POST",
    Authentication: authentication,
    Headers: headers,
    Body: JSON.stringify({
      // La charge utile doit correspondre à la définition de votre événement de message transactionnel.
      email,
      ctx: {
        url,
        language,

        // Facultatif si vous souhaitez qu'Campaign utilise le rendu de Wallet Crew :
        subject: rendered.Subject,
        body: rendered.Body,

        // Métadonnées utiles :
        template: emailTemplate,
        customerId,
      },
    }),
    ThrowOnError: false,
  });

  if (result.StatusCode < 200 || result.StatusCode >= 300) {
    throw new Error(`L'appel Adobe Campaign 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 :

* L'événement de message transactionnel est publié et appelable.
* Le schéma de la charge utile correspond à la définition de l'événement.
* Adobe Campaign accepte la requête et traite le message.

## FAQ

<details>

<summary><strong>Un événement de message transactionnel est-il requis ?</strong></summary>

Oui. Le script doit appeler un point de terminaison d'événement de messagerie transactionnelle publié. Cet événement définit le schéma de charge utile attendu et les variables disponibles dans le modèle Adobe Campaign.

</details>

<details>

<summary><strong>Quelle méthode d'authentification doit être utilisée ?</strong></summary>

Cela dépend du déploiement Adobe Campaign et de la manière dont l'organisation Adobe gère l'accès serveur à serveur. Cette page montre une approche basée sur IMS, car elle est courante, mais la méthode d'authentification finale doit être alignée avec l'équipe d'administration Adobe et la documentation officielle Adobe pour cet environnement.

</details>

<details>

<summary><strong>Quelle est la raison la plus courante du rejet d'une requête ?</strong></summary>

Incompatibilité de schéma. La définition de l'événement est stricte. Lorsque les champs de la charge utile ne correspondent pas à la structure attendue de l'événement, Campaign rejette ou ignore les champs, et les modèles affichent des valeurs vides.

</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-campaign-transactional-messaging.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.
