> 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é
Les connecteurs personnalisés permettent à The Wallet Crew de s'intégrer à des systèmes qui ne disposent pas de connecteur natif. Ils sont utiles lorsqu'une Brand 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 des e-mails transactionnels via une pile de diffusion interne.
## Connecteurs personnalisés pour des intégrations spécifiques au tenant
Un connecteur personnalisé n'est pas un module produit distinct. Il s'agit d'une couche d'intégration propre au projet implémentée avec des hooks d'exécution exposés par The Wallet Crew.
En pratique :
1. Le système source conserve la propriété 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 garder la couche Wallet alignée sur vos systèmes existants sans imposer un connecteur natif complet.
## Ce qui est nécessaire 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 | Précise quelle équipe contrôle les règles métier et la qualité des données |
| Identifiants stables (customerId, membershipId, ticketId, etc.) | Lie les cartes Wallet aux enregistrements sources au fil du temps |
| Modèle de déclenchement (pull, push, hooks du 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 | Précise 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 des scripts.
Exemples concrets
* Une Brand enrichit une carte de fidélité avec des points, un niveau ou des données de profil provenant d'un CRM.
* Une équipe synchronise l'état d'installation de la Carte avec une plateforme marketing, analytique ou BI.
* Un partenaire conserve le rendu d'e-mails de The Wallet Crew, mais l'envoie via sa propre passerelle.
## Ce que couvre cette section
Cette section regroupe les modèles de connecteurs personnalisés les plus souvent 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 des cartes Wallet.
Les cas d'utilisation 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)
### Diffusion d'e-mails basée 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.
C'est utile pour les passerelles internes, les ESP non pris en charge ou les environnements soumis à une gouvernance stricte de la diffusion.
* [Extensibilité d’EmailSender](/connectors/fr/custom-connector/emailsender-extensibility.md)
### Scripting d'exécution
Certains connecteurs personnalisés ont également 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 des connecteurs les plus souvent utilisés dans les projets Connect. Pour l'enregistrement à l'exécution et les détails d'implémentation, consultez [Guide des connecteurs personnalisés pour les développeurs](https://github.com/TheWalletCrew/docs/tree/main/developers/guides/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 natif ne convienne pas clairement.
Utilisez un connecteur standard lorsqu'il en existe déjà un. Un connecteur standard peut également être défini par The Wallet Crew et le partenaire de la plateforme lorsqu'il peut prendre en charge plusieurs Brands.
Utilisez un connecteur personnalisé lorsque le scripting 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 | Wallet Crew |
| ---------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------- |
| Accès au système externe | Fournit les API, les identifiants et la propriété métier | Fournit le contexte d'exécution |
| Règles de mappage des données | Définit le mappage sémantique à partir des champs sources | Applique les données mappées à la génération des payloads Wallet |
| Réactions au cycle de vie | Décide quoi faire lors de l'installation/désinstallation | Émet des hooks et des événements du cycle de vie |
| Diffusion d'e-mails (fournisseur script) | Envoie les e-mails via le relais/fournisseur sélectionné | Construit les modèles et appelle le runtime de script |
## FAQ
Quand faut-il utiliser un connecteur natif à la place ?
Utilisez un connecteur natif lorsque The Wallet Crew prend déjà en charge la plateforme cible et que le flux de travail 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 à l'exécution.
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 de l'installation des cartes 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 d'e-mails 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ù le modèle générique de scripting des connecteurs personnalisés est-il documenté ?
Cette page se concentre sur les points d'entrée des connecteurs exposés dans la **Connect** section. Les modèles de scripting d'exécution plus larges sont documentés séparément.
Une plateforme non répertoriée peut-elle devenir un connecteur natif ?
Oui. The Wallet Crew et le partenaire de la plateforme peuvent définir conjointement un connecteur natif lorsqu'il peut prendre en charge plusieurs Brands. Pour des intégrations spécifiques au tenant, utilisez un connecteur personnalisé avec du scripting tenant et des API.
---
# 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.