> 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/marketo-engage-transactional-email-api.md).

# Marketo Engage (Transactional Email API)

Envoyer les e-mails transactionnels de The Wallet Crew via Marketo Engage à l’aide du fournisseur d’e-mails du script.

Utilisez cette option lorsque l’organisation utilise **Marketo Engage** et souhaite que les envois transactionnels soient suivis dans les journaux d’activité de Marketo. Le script utilise le modèle d’e-mail transactionnel documenté par Adobe : il déclenche une campagne Marketo via l’API REST et transmet les valeurs sous forme de jetons de programme. Voir [E-mail transactionnel](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/assets/transactional-email) dans la documentation développeur de Marketo.

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 Marketo

Créez l’asset d’e-mail à envoyer et faites-le approuver. Si l’e-mail est légalement considéré comme opérationnel, marquez-le comme opérationnel dans ses paramètres d’e-mail.

Créez une campagne déclencheur dont le déclencheur est **La campagne est demandée**, avec la source **API de service Web**, et un **Envoyer l’e-mail** étape de flux pour l’e-mail. Activez-la.

Créez les jetons de programme utilisés dans l’e-mail (par exemple `{{my.url}}`). Un jeton ne peut pas être enregistré vide, donc attribuez à chacun un contenu factice.

Ensuite, décidez comment la sortie de The Wallet Crew est mappée :

* Utiliser des jetons pour injecter `Objet` et `Corps`.
* Ou conservez l’objet et le corps dans Marketo et ne transmettez que les données contextuelles.

Le destinataire doit déjà exister en tant que lead Marketo : le script le recherche par e-mail avant de déclencher la campagne.

## Notes d’implémentation (jeton + envoi)

Les instances Marketo sont spécifiques à une région. Le script demande un jeton d’accès Marketo, trouve le lead par e-mail (`GET /rest/v1/leads.json`), puis déclenche la campagne (`POST /rest/v1/campaigns/{id}/trigger.json`) avec les jetons.

Stockez ces valeurs comme secrets du tenant avant de tester :

* `marketo-baseUrl` (exemple : `https://123-ABC-456.mktorest.com`)
* `marketo-clientId`
* `marketo-clientSecret`
* `marketo-campaignId` (l’identifiant de la campagne déclencheur)

{% hint style="info" %}
Les points de terminaison du jeton OAuth Marketo peuvent varier légèrement selon l’instance et la configuration. Lorsque le point de terminaison du jeton Marketo nécessite des paramètres de requête ou une méthode HTTP spécifique, adaptez les paramètres d’authentification en conséquence.
{% endhint %}

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

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

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

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)}`;
  const rendered = await buildEmail(emailTemplate);

  const baseUrl = await getSecret("marketo-baseUrl");
  const clientId = await getSecret("marketo-clientId");
  const clientSecret = await getSecret("marketo-clientSecret");
  const campaignId = await getSecret("marketo-campaignId");

  // Votre `fetch` d’exécution gère les identifiants client OAuth et joint le jeton.
  const authentication = {
    mode: "OAuth2.0",
    grantType: "clientCredentials",
    sendCredentialsAsFormParams: true,
    accessTokenUrl: `${baseUrl}/identity/oauth/token`,
    clientId,
    clientSecret,
  };

  // 1. Trouver le lead Marketo du destinataire.
  const lookup = await fetch(
    `${baseUrl}/rest/v1/leads.json?filterType=email&filterValues=${encodeURIComponent(email)}&fields=id`,
    { Method: "GET", Authentication: authentication, ThrowOnError: false }
  );
  const leads = JSON.parse(lookup.ResponseText || "{}").result || [];
  if (leads.length === 0) {
    throw new Error(`Aucun lead Marketo pour ${email} (${lookup.StatusCode}) : ${lookup.ResponseText}`);
  }

  // 2. Déclencher la campagne avec les jetons.
  const triggerUrl = `${baseUrl}/rest/v1/campaigns/${encodeURIComponent(campaignId)}/trigger.json`;
  const result = await fetch(triggerUrl, {
    Method: "POST",
    Authentication: authentication,
    Headers: {
      "Content-Type": "application/json",
    },
    Body: JSON.stringify({
      input: {
        leads: [{ id: leads[0].id }],
        tokens: [
          { name: "{{my.url}}", value: url },
          { name: "{{my.language}}", value: language },
          { name: "{{my.subject}}", value: rendered.Subject },
          { name: "{{my.body}}", value: rendered.Body },
          { name: "{{my.customerId}}", value: customerId },
          { name: "{{my.template}}", value: emailTemplate },
        ],
      },
    }),
    ThrowOnError: false,
  });

  // Marketo peut répondre 200 avec "success": false, donc vérifiez les deux.
  const answer = JSON.parse(result.ResponseText || "{}");
  if (result.StatusCode < 200 || result.StatusCode >= 300 || answer.success !== true) {
    throw new Error(`L’appel de déclenchement Marketo a échoué (${result.StatusCode}) : ${result.ResponseText}`);
  }
}

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

{% endcode %}

{% hint style="info" %}
Marketo exige que l’asset d’e-mail soit approuvé et que la campagne déclencheur soit active avant que l’appel puisse envoyer quoi que ce soit.
{% endhint %}

## Ce qu'il faut valider

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

* L’asset d’e-mail existe et est approuvé, et la campagne déclencheur est active.
* Le destinataire existe en tant que lead Marketo.
* Marketo accepte l’appel de déclenchement.
* Les jetons correspondent à ce que l’e-mail Marketo attend.

## FAQ

<details>

<summary><strong>Le modèle d’e-mail doit-il être créé dans Marketo ?</strong></summary>

Oui. Marketo envoie un asset d’e-mail approuvé depuis la campagne déclencheur. Le script peut toujours transmettre des jetons, mais Marketo a besoin de l’asset conteneur.

</details>

<details>

<summary><strong>Quelle est la manière la plus rapide de diagnostiquer un problème ?</strong></summary>

Vérifiez d’abord que l’asset est approuvé et que la campagne est active, puis consultez le corps de la réponse de l’API Marketo pour obtenir un code d’erreur spécifique. Si l’appel API réussit mais que l’e-mail s’affiche mal, vérifiez que l’e-mail Marketo utilise les mêmes noms de jetons que ceux envoyés.

</details>

<details>

<summary><strong>Peut-on utiliser différentes instances Marketo selon l’environnement ?</strong></summary>

Oui. Configurez différents secrets et points de terminaison par tenant (préproduction vs production). Conservez une nomenclature cohérente des jetons entre les environnements afin d’éviter la dérive des modèles.

</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/marketo-engage-transactional-email-api.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.
