> 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/custom-connector/emailsender-extensibility.md).

# Extensibilité d’EmailSender

Implémentez un fournisseur d’e-mails basé sur un script en enregistrant \`runtime.scriptable.emailEngine.SendEmail\`.

Utilisez ce point d'extensibilité pour permettre à l'équipe Wallet d'envoyer des e-mails via un fournisseur contrôlé par le tenant. Il s'agit d'une intégration au niveau du script. Elle conserve les modèles et la logique de rendu de l'équipe Wallet, tout en déléguant l'envoi final à des appels d'API dédiés.

La référence complète du `runtime.scriptable.emailEngine` le point de terminaison est le [Moteur d'e-mails](https://docs.thewalletcrew.io/developers-guides/fr/scripting/endpoints/email-engine.md) page des guides développeurs.

Scripts de référence pour [Salesforce Marketing Cloud](https://docs.thewalletcrew.io/connectors/fr/email-provider/salesforce-marketing-cloud.md) et [Adobe](https://docs.thewalletcrew.io/connectors/fr/email-provider/adobe-marketing-cloud.md) s'appuient sur le `SendEmail` la signature, le `buildEmail` le callback et le runtime décrits dans le [Moteur d'e-mails](https://docs.thewalletcrew.io/developers-guides/fr/scripting/endpoints/email-engine.md) .

## Activer le fournisseur d'e-mails script

Le passage au fournisseur d'e-mails script est un changement de configuration. Il indique à l'équipe Wallet d'appeler le tenant `SendEmail` pour les e-mails sortants.

Dans **Paramètres → Général → Fournisseur d’e-mail**, sélectionnez **Personnalisé**. Sinon, ouvrez l'éditeur de configuration avancée (**Paramètres → Avancé → configuration avancée**), puis créez ou modifiez `/server/emails.yml`. Définissez le type de fournisseur sur `script`. Conservez `ressources` pointant vers le répertoire des modèles d'e-mails. Stockez les identifiants du fournisseur en tant que secrets du tenant (**Paramètres → Contrôle d’accès → Clés API et secrets**, **Secrets d'application** onglet) et lisez-les dans le script avec `getSecret`.

```yaml
provider:
  type: script
resources:
  - /locales/emails/
```

## Notes sur les modèles et les cultures

Les modèles d'e-mails sont chargés à partir des chemins listés sous `ressources`. Par défaut, cela pointe vers `/locales/emails/`. Gardez cela aligné avec l'emplacement des modèles HTML, car le callback de rendu utilise ces modèles.

La gestion des cultures fait partie du contrat. La plateforme transmet un `cultures` tableau, mais l'implémentation du fournisseur décide comment l'utiliser. En pratique, la plupart des configurations choisissent soit une seule culture par destinataire, soit reviennent à une culture par défaut lorsqu'aucun modèle spécifique n'existe.

## Liens de Carte dans les e-mails

{% hint style="warning" %}
Ajoutez toujours un `id.customerId.hmac` paramètre à l'URL : le HMAC-SHA256 de la valeur de l'identifiant avec le secret du tenant, en hexadécimal, comme décrit dans [Fonctionnement du bouton Ajouter à Wallet](https://docs.thewalletcrew.io/connectors/fr/e-commerce.md#how-the-add-to-wallet-button-works). Un script peut le calculer avec `CryptoJS.HmacSHA256(secret, value)`.
{% endhint %}

## Dépannage

Si les e-mails cessent d'être envoyés après l'activation du fournisseur script, commencez par vérifier que `/server/emails.yml` est un YAML valide et enregistré dans le bon tenant. Puis confirmez que le script est bien enregistré sous `runtime.scriptable.emailEngine` et exporte `SendEmail`.

Pour les erreurs côté fournisseur, consignez le nom du modèle et les choix de culture, mais évitez de consigner les corps rendus complets. Le contenu des e-mails peut contenir des données personnelles.

## FAQ

<details>

<summary><strong>S'agit-il d'un point de terminaison HTTP public ?</strong></summary>

Non. Cette page documente une interface runtime de script que le script du tenant implémente. Une API HTTP externe est appelée depuis `SendEmail`.

</details>

<details>

<summary><strong>Un fournisseur script peut-il être combiné avec SendGrid ou Mailchimp ?</strong></summary>

Pas en même temps pour un tenant donné. Le fournisseur actif est sélectionné dans `/server/emails.yml`, sauf si le script lui-même achemine certains envois vers un autre fournisseur.

</details>

<details>

<summary><strong>Que doit <code>SendEmail</code> retourner ?</strong></summary>

Retournez normalement lorsque l'e-mail est accepté par le fournisseur. Levez une erreur lorsque l'envoi échoue, afin que la plateforme puisse l'afficher.

</details>

<details>

<summary><strong>Quel est le moyen le plus rapide de valider la configuration ?</strong></summary>

Activez le `script` fournisseur, déclenchez un seul e-mail transactionnel, puis vérifiez les journaux du fournisseur pour l'événement d'envoi.

</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/custom-connector/emailsender-extensibility.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.
