Marketo Engage (API d'e-mails transactionnels)

Envoyez les e-mails transactionnels de Wallet Crew via Marketo Engage en utilisant le fournisseur d'e-mails basé sur des scripts.

Utilisez cette option lorsque votre organisation utilise Marketo Engage et souhaite que les envois transactionnels soient suivis dans les journaux d’activité de Marketo.

Avant d’aller plus loin, assurez-vous de comprendre le fonctionnement du fournisseur de scripts dans The Wallet Crew. Commencez par Adobe Marketing Cloud et le prérequis Extensibilité d’EmailSender.

Quand utiliser cette option

Il s’agit souvent du modèle REST le plus simple, mais il suppose que vous gérez et approuvez le modèle d’e-mail dans Marketo.

Configuration requise dans Marketo

Créez l’élément d’e-mail que vous souhaitez envoyer et faites-le approuver. Les règles d’approbation varient selon la configuration de Marketo.

Décidez ensuite comment vous mappez la sortie de The Wallet Crew :

• Utilisez des jetons ou des variables Marketo pour injecter Objet et Body.
• Ou conservez l’objet et le corps dans Marketo et ne transmettez que des données contextuelles.

Notes d’implémentation (jeton + envoi)

Les instances Marketo sont spécifiques à une région. Votre script demande généralement un jeton d’accès Marketo, puis appelle le point de terminaison d’envoi transactionnel pour l’élément d’e-mail choisi.

Enregistrez ces valeurs en tant que secrets avant de tester :

• marketo-baseUrl (exemple : https://123-ABC-456.mktorest.com)
• marketo-clientId
• marketo-clientSecret
• marketo-emailId (l’identifiant de l’élément d’e-mail Marketo que vous envoyez)

Les points de terminaison du jeton OAuth Marketo peuvent légèrement varier selon l’instance et la configuration. Si votre point de terminaison de 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.

Exemple Marketo Engage (implémentation SendEmail)

import { getSecret } from "neo/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('Champ "id.customerId" manquant 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 marketoEmailId = await getSecret("marketo-emailId");

  const sendUrl = `${baseUrl}/rest/v1/email/${encodeURIComponent(marketoEmailId)}/send.json`;

  // Votre `fetch` d'exécution gère les identifiants client OAuth et joint le jeton.
  const result = await fetch(sendUrl, {
    Method: "POST",
    Authentication: {
      mode: "OAuth2.0",
      grantType: "clientCredentials",
      sendCredentialsAsFormParams: true,
      accessTokenUrl: `${baseUrl}/identity/oauth/token`,
      clientId,
      clientSecret,
    },
    Headers: {
      "Content-Type": "application/json",
    },
    Body: JSON.stringify({
      input: [
        {
          email,
          variables: [
            { name: "url", value: url },
            { name: "language", value: language },
            { name: "subject", value: rendered.Subject },
            { name: "body", value: rendered.Body },
            { name: "customerId", value: customerId },
            { name: "template", value: emailTemplate },
          ],
        },
      ],
    }),
    ThrowOnError: false,
  });

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

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

Marketo exige que l’élément d’e-mail existe (et souvent qu’il soit approuvé) avant de pouvoir être utilisé pour les envois.

Ce qu'il faut valider

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

• L’élément d’e-mail existe et est approuvé.
• Marketo accepte l’appel d’envoi.
• Les variables correspondent à ce qu’attend votre modèle Marketo.

FAQ

Doit-on créer le modèle d’e-mail dans Marketo ?

Oui. Marketo exige un élément d’e-mail existant pour les envois transactionnels, et de nombreuses configurations exigent que l’élément soit approuvé. Votre script peut toujours transmettre des variables, mais Marketo a besoin de l’élément conteneur.

The Wallet Crew peut-il toujours générer le HTML ?

Oui. Vous pouvez appeler buildEmail() et transmettre objet et corps comme variables. Votre e-mail Marketo doit être conçu pour injecter ces variables aux bons endroits.

Quelle est la façon la plus rapide de dépanner ?

Vérifiez d’abord que l’élément est approuvé, puis consultez le corps de la réponse de l’API Marketo pour un code d’erreur spécifique. Si l’appel API réussit mais que l’e-mail s’affiche mal, vérifiez que votre modèle Marketo attend les mêmes noms de variables que ceux que vous envoyez.

Peut-on utiliser différentes instances Marketo selon l’environnement ?

Oui. Configurez différents secrets et points de terminaison par locataire (staging vs production). Conservez une nomenclature de variables cohérente entre les environnements afin d’éviter la dérive du modèle.