> 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.md).
# Connecteur personnalisé
Utilisez des connecteurs personnalisés avec le scripting du tenant pour intégrer des API privées, des hooks du cycle de vie Wallet et une distribution d’e-mails personnalisée.
Les connecteurs personnalisés permettent à The Wallet Crew de s’intégrer à des systèmes qui ne disposent pas d’un connecteur natif. Ils sont utiles lorsqu’une marque ou un partenaire doit récupérer des données externes, réagir aux événements du cycle de vie des cartes Wallet ou acheminer les e-mails transactionnels via une pile de distribution interne.
## Connecteurs personnalisés pour des intégrations spécifiques au tenant
Un connecteur personnalisé n’est pas un module produit distinct. C’est une couche d’intégration spécifique au projet, implémentée à l’aide des hooks d’exécution exposés par The Wallet Crew.
En pratique :
1. Le système source conserve la responsabilité des données métier.
2. Le script du connecteur résout et mappe les données nécessaires aux cartes Wallet.
3. The Wallet Crew génère et met à jour les payloads Apple Wallet et Google Wallet.
Cela permet de maintenir la couche Wallet alignée sur les systèmes existants sans imposer un connecteur natif complet.
## Ce qu’il faut pour concevoir un nouveau connecteur
Avant l’implémentation, définissez ces entrées :
| Entrée requise | Pourquoi c’est important |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Système source et propriétaire | Clarifie quelle équipe contrôle les règles métier et la qualité des données |
| Identifiants stables (customerId, membershipId, ticketId, etc.) | Relie les cartes Wallet aux enregistrements sources dans le temps |
| Modèle de déclenchement (pull, push, hooks de cycle de vie) | Définit quand les données sont récupérées et quand les mises à jour sont propagées |
| Contrat API/événement | Définit l’authentification, la structure du payload et la gestion des erreurs |
| Responsabilité opérationnelle | Clarifie qui surveille les échecs d’intégration et les nouvelles tentatives |
Si ces entrées ne sont pas claires, alignez-les d’abord avant d’écrire les scripts.
Exemples réels
* Une marque enrichit une Carte de fidélité avec des points, un niveau ou des données de profil provenant d’un CRM.
* Une équipe synchronise le statut d’installation de la Carte avec une plateforme marketing, d’analytics ou de BI.
* Un partenaire conserve le rendu des e-mails de The Wallet Crew, mais les envoie via sa propre passerelle.
## Ce que couvre cette section
Cette section regroupe les modèles de connecteur personnalisé les plus utilisés dans les projets de livraison.
### Hooks du cycle de vie de la Carte
Utilisez ce modèle lorsqu’un système externe doit réagir aux changements d’installation de la Carte Wallet.
Les cas d’usage typiques incluent la synchronisation CRM, la segmentation basée sur l’installation, les parcours d’onboarding et le suivi des désinstallations.
* [Hooks d’installation et de désinstallation de la Carte](/connectors/fr/custom-connector/installation-changed-extensibility.md)
### Envoi d’e-mails basé sur des scripts
Utilisez ce modèle lorsque The Wallet Crew doit toujours générer le contenu de l’e-mail, mais que l’envoi final doit être pris en charge par un fournisseur ou un relais contrôlé en dehors de The Wallet Crew.
Ce modèle est utile pour les passerelles internes, les ESP non pris en charge ou les environnements soumis à une gouvernance stricte de la distribution.
* [Extensibilité d'EmailSender](/connectors/fr/custom-connector/emailsender-extensibility.md)
### Script d’exécution
Certains connecteurs personnalisés ont aussi besoin de scripts d’exécution plus larges pour enrichir les données de la Carte ou enregistrer une logique de fournisseur personnalisée.
Cette section se concentre sur les points d’entrée du connecteur les plus souvent utilisés dans les projets Connect. Pour l’enregistrement à l’exécution et les détails d’implémentation, voir [Guide des connecteurs personnalisés pour développeurs](/developers-guides/fr/integration-guides/custom-connectors.md).
## Quand utiliser un connecteur personnalisé
Utilisez un connecteur personnalisé lorsque les besoins d’intégration sont suffisamment spécifiques pour qu’un connecteur intégré ne convienne pas proprement.
Utilisez un connecteur standard lorsqu’il en existe déjà un. Un connecteur standard peut aussi être défini par The Wallet Crew et le partenaire de la plateforme lorsqu’il peut prendre en charge plusieurs marques.
Utilisez un connecteur personnalisé lorsque le script du tenant doit appeler une API privée, utiliser un relais interne ou réagir aux événements du cycle de vie de la Carte.
## Répartition des responsabilités
| Sujet | Client / partenaire | L'équipe Wallet |
| ------------------------------------------ | -------------------------------------------------------------- | -------------------------------------------------------------- |
| Accès au système externe | Fournit les API, les identifiants et la responsabilité métier | Fournit le contexte d’exécution runtime |
| Règles de mappage des données | Définit le mappage sémantique des champs source | Applique les données mappées à la génération du payload Wallet |
| Réactions au cycle de vie | Décide quoi faire lors de l’installation/de la désinstallation | Émet les hooks et événements du cycle de vie |
| Livraison des e-mails (fournisseur script) | Envoie les e-mails via le relais/fournisseur sélectionné | Construit les modèles et appelle le runtime de scripts |
## FAQ
Quand faut-il utiliser à la place un connecteur intégré ?
Utilisez un connecteur intégré lorsque The Wallet Crew prend déjà en charge la plateforme cible et que le workflow attendu correspond aux besoins du projet. Utilisez un connecteur personnalisé lorsque l’intégration dépend d’API privées, de relais internes ou d’une logique spécifique au runtime.
Est-ce le bon endroit pour la synchronisation de l’installation et de la désinstallation ?
Oui. Pour les événements du cycle de vie d’installation de Wallet, commencez par [Hooks d’installation et de désinstallation de la Carte](/connectors/fr/custom-connector/installation-changed-extensibility.md).
Est-ce le bon endroit pour une passerelle e-mail personnalisée ?
Oui. Pour l’envoi d’e-mails transactionnels basé sur des scripts, utilisez [Extensibilité d'EmailSender](/connectors/fr/custom-connector/emailsender-extensibility.md).
Où la documentation du modèle générique de scripting des connecteurs personnalisés est-elle disponible ?
Cette page se concentre sur les points d’entrée du connecteur exposés dans la section **Connect** La documentation des modèles de scripting runtime plus larges est fournie séparément.
Un service non répertorié peut-il devenir un connecteur standard ?
Oui. The Wallet Crew et le partenaire de la plateforme peuvent définir conjointement un connecteur intégré lorsqu’il peut prendre en charge plusieurs marques. Pour les intégrations spécifiques au tenant, utilisez un connecteur personnalisé avec du scripting et des API de tenant.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.thewalletcrew.io/connectors/fr/custom-connector.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.