> 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/salesforce-marketing-cloud.md).

# Salesforce Marketing Cloud comme expéditeur d’e-mails

Configurez The Wallet Crew pour envoyer ses e-mails transactionnels via Salesforce Marketing Cloud, avec un script de tenant, au lieu du fournisseur d'e-mails par défaut.

Utilisez cette page pour demander à The Wallet Crew d’envoyer **des e-mails transactionnels** via **Salesforce Marketing Cloud**, tandis que Salesforce Marketing Cloud reste l’endroit où la marque gère les ressources d’e-mail, le suivi et les rapports.

Il s’agit d’un script de référence pour le **fournisseur de script d’e-mail**, et non un type de fournisseur natif. The Wallet Crew déclenche l’envoi. Le script du locataire transmet l’événement à Salesforce Marketing Cloud.

{% hint style="info" %}
**De quelle page ai-je besoin ?** Utilisez cette page lorsque The Wallet Crew envoie l’e-mail via Salesforce Marketing Cloud. Pour envoyer des liens de Carte depuis Email Studio ou pour mettre à jour des Carte depuis Journey Builder, consultez [Salesforce Marketing Cloud dans l’automatisation marketing](https://docs.thewalletcrew.io/connectors/fr/marketing-automation/salesforce-marketing-cloud.md).
{% endhint %}

## Fonctionnement

The Wallet Crew appelle l’implémentation du locataire de `runtime.scriptable.emailEngine.SendEmail`. Ce script appelle ensuite l’API REST de Salesforce Marketing Cloud pour déclencher un événement (en utilisant une `EventDefinitionKey`). Salesforce Marketing Cloud utilise cette charge utile d’événement pour générer et envoyer l’e-mail.

Ce modèle évite de dupliquer les modèles. Salesforce Marketing Cloud détient le modèle et le HTML de l’e-mail, de sorte que l’équipe marketing peut l’itérer sans déployer de modifications de The Wallet Crew. The Wallet Crew envoie uniquement les variables dont Salesforce Marketing Cloud a besoin, comme le titre, l’URL de téléchargement de la Carte et le libellé localisé de l’CTA.

Lorsque le fournisseur de script n’est pas encore configuré, commencez par [Extensibilité de EmailSender](https://docs.thewalletcrew.io/connectors/fr/custom-connector/emailsender-extensibility.md).

## Configuration requise dans Salesforce Marketing Cloud

Dans Salesforce Marketing Cloud, créez un point d’entrée déclenché par API et le contenu d’e-mail associé.

1. Créez un **package installé** capable d’appeler des API REST, et conservez le **ID client** et **secret client**.
2. Créez la ressource d’envoi à déclencher par API (généralement un événement d’entrée de parcours ou un événement API), puis copiez son `EventDefinitionKey`.
3. Assurez-vous que le modèle d’e-mail Salesforce Marketing Cloud attend les mêmes noms de variables envoyés dans `Données`.
4. Utilisez un identifiant stable dans la charge utile d’e-mail de The Wallet Crew (exemple : `id.customerId`) pour générer l’URL de Carte.

{% hint style="info" %}
La configuration de Salesforce Marketing Cloud varie selon la configuration du compte et l’ensemble des fonctionnalités. Conservez un contrat de charge utile stable : les noms de champs dans `Données` doivent correspondre à ce qu’attend la ressource Salesforce Marketing Cloud.
{% endhint %}

## Activez Salesforce Marketing Cloud dans The Wallet Crew

Sélectionnez **Personnalisé** dans **Paramètres → Général → Fournisseur d’e-mail**, comme décrit dans [Extensibilité de EmailSender](https://docs.thewalletcrew.io/connectors/fr/custom-connector/emailsender-extensibility.md#enable-the-script-email-provider).

## Exemple de script (déclencher un événement Salesforce Marketing Cloud)

Cet exemple déclenche un événement Salesforce Marketing Cloud à l’aide du point de terminaison REST `interaction/v1/events`. Il envoie un titre localisé, un libellé d’CTA localisé et une URL de Carte de The Wallet Crew générée à partir d’un identifiant client. Stockez les identifiants en tant que secrets du locataire et chargez-les à l’exécution avec `getSecret`. N’intégrez pas les identifiants en dur dans les scripts.

{% hint style="warning" %}
Cette implémentation délègue le rendu à Salesforce Marketing Cloud. The Wallet Crew `buildEmail()` le rappel n’est volontairement pas utilisé.
{% 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 Salesforce Marketing Cloud (implémentation SendEmail)" %}

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

const CUSTOM_DOMAIN = "wallet.brand.com";
const TENANTID = "brand";
const SFMC_SUBDOMAIN = "<your-subdomain>";

async function sendEmail(recipient, emailTemplate, data, cultures, buildEmail){

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

  const locales = {
    "en": {
      title: "Votre compte est prêt : ajoutez votre Carte au Wallet",
      label: "Ajouter au Wallet"
    },
    "fr": {
      title: "Votre compte est prêt : ajoutez votre Carte au Wallet",
      label: "Ajouter au Wallet"
    }
  };

  const locale = locales[cultures[0]];

  const response = await fetch(`https://${SFMC_SUBDOMAIN}.rest.marketingcloudapis.com/interaction/v1/events`,  {
    Method : "POST", 
    Authentication : {
        mode : 'OAuth2.0', 
        grantType : 'clientCredentials',
        accessTokenUrl : `https://${SFMC_SUBDOMAIN}.auth.marketingcloudapis.com/v2/token`, 
        sendCredentialsAsFormParams: true,
        clientId: await getSecret('SFMC-CLIENTID'), 
        clientSecret : await getSecret('SFMC-CLIENTSECRET')
    }, 
    Headers: {
      "Content-Type": "application/json",
    },
    Body: {
      "ContactKey": recipient,
      "EventDefinitionKey": "<EVENT_DEFINITION_KEY>",
      "Data": {
          "SubscriberKey": recipient,
          "EmailAddress": recipient,
          "Title": locale.title,
          "Url": url,
          "LabelCTA": locale.label,
      }
    }
  });
  const responseData = JSON.parse(response.ResponseText); 
  if(!responseData?.eventInstanceId){
    throw new Error(`erreur lors de l'envoi du statut de l'e-mail personnalisé : ${response.StatusCode} - contenu : ${response.ResponseText}`)
  }
}

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

{% endcode %}

## Ce qu'il faut valider

Déclenchez un e-mail transactionnel réel, puis validez de bout en bout :

* The Wallet Crew appelle le script sans erreur.
* L'appel à l'API Salesforce Marketing Cloud renvoie un `eventInstanceId`.
* Salesforce Marketing Cloud affiche l'e-mail avec `Titre`, `URL`, et `Libellé du CTA`.
* Le CTA ouvre l'URL de The Wallet Crew et la Carte peut être installée.

## Dépannage

Si les envois échouent, isolez le problème dans cet ordre :

* **Échec d’OAuth (401/403)**: l’ID client / secret est incorrect, révoqué, ou le package installé n’a pas accès à l’API.
* **Non `eventInstanceId`**: le `EventDefinitionKey` est invalide, non publié, ou le schéma de la charge utile est rejeté.
* **Variables vides dans l’e-mail**: le modèle Salesforce Marketing Cloud attend des noms de champs différents de ceux envoyés dans `Données`.
* **Langue incorrecte**: `cultures[0]` ne correspond pas à la carte des paramètres régionaux. Ajoutez une solution de repli (par exemple : par défaut, utiliser `en`).

## FAQ

<details>

<summary><strong>Peut-on utiliser les modèles de l’équipe Wallet et <code>buildEmail()</code> peuvent-ils encore être utilisés ?</strong></summary>

Oui, mais cela devient une stratégie différente. Dans ce modèle, l’équipe Wallet génère `Objet` et `Corps`, et Salesforce Marketing Cloud n’est utilisé que comme passerelle de livraison. Dans ce cas, configurez l’asset Salesforce Marketing Cloud pour accepter le HTML rendu et évitez le double templating.

</details>

<details>

<summary><strong>Que doit-on utiliser comme <code>ContactKey</code>?</strong></summary>

Utilisez un identifiant de contact Salesforce Marketing Cloud stable. De nombreuses marques utilisent l’adresse e-mail, mais un identifiant CRM fonctionne aussi lorsqu’il s’agit de la stratégie de clé de contact Salesforce Marketing Cloud. Gardez-le cohérent avec la façon dont le parcours ou l’asset résout les destinataires.

</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/salesforce-marketing-cloud.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.
