Aller au contenu
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 dans la documentation développeur de Marketo.

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)

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.

L’exemple génère une URL de Carte non signée : voir Liens de Carte dans les e-mails.

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.

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

Le modèle d’e-mail doit-il être créé dans Marketo ?

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.

Quelle est la manière la plus rapide de diagnostiquer un problème ?

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.

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

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.

Mis à jour