# Synchroniser l’état d’installation de la carte avec votre CRM ## Synchroniser l’état d’installation de la carte avec votre CRM Suivre si une carte est installée dans **Apple Wallet** ou **Google Wallet**. Puis synchronisez ce signal vers votre CRM, votre CDP ou vos outils marketing. ### Ce que signifie « l’état d’installation » L’état d’installation est un signal du cycle de vie émis lorsqu’un utilisateur ajoute ou supprime une carte. Il couvre quatre états. Elle peut être installée sur Apple. Elle peut être installée sur Google. Elle peut être désinstallée d’Apple. Elle peut être désinstallée de Google. {% hint style="info" %} Assurez-vous que chaque carte inclut un identifiant externe stable (par exemple `customerId` ou `email`). Vous l’utiliserez pour rapprocher les événements des enregistrements de votre CRM. {% endhint %} ### Choisissez la bonne méthode de synchronisation Si vous voulez des mises à jour en temps réel, utilisez **webhooks** ou un **connecteur personnalisé**. Si vous préférez les traitements par lots ou les backfills, utilisez la **API Carte**. Si vous avez surtout besoin de volumes et de tendances, utilisez **Insights API**. ### Décidez ce que vous souhaitez synchroniser Commencez par choisir la « vérité » que vous voulez dans votre CRM. La plupart des équipes stockent à la fois un statut simple et quelques horodatages. Vous voulez généralement un champ global, plus des champs par Wallet. Cela vous permet de segmenter sans perdre de détails. Champs CRM courants : * `walletStatus`: `aucun`, `apple`, `google`, `les deux` * `appleWalletInstalledAt`: horodatage, facultatif * `googleWalletInstalledAt`: horodatage, facultatif * `walletLastChangedAt`: horodatage * `walletLastEvent`: installé ou désinstallé {% hint style="warning" %} Traitez les événements comme **une livraison au moins une fois**. Attendez-vous à des doublons et à des livraisons hors ordre. {% endhint %} ### Rapprochez les événements des enregistrements CRM Votre synchronisation a besoin d’une clé de jointure. Utilisez un identifiant externe stable stocké sur la carte. De bons identifiants sont `customerId`, `accountId`, ou un email normalisé. Évitez les identifiants susceptibles de changer fréquemment. Lorsqu’un événement arrive, associez-le à un seul enregistrement CRM. Mettez ensuite à jour les indicateurs par Wallet et votre statut global. ### Comprenez les cas limites L’installation est spécifique à Wallet. Un même client peut installer sur Apple et Google. La désinstallation reste elle aussi spécifique à Wallet. Une désinstallation d’Apple n’implique pas une désinstallation de Google. Certains clients réinstallent rapidement. Utilisez des horodatages pour éviter les « oscillations » dans votre CRM. ### Option 1 — Webhooks (temps réel, effort minimal) Les webhooks envoient les événements vers votre point de terminaison au fur et à mesure qu’ils se produisent. Abonnez-vous à `Carte:Installed` et `Carte:Uninstalled`. Étape suivante : configurez votre point de terminaison webhook et validez les signatures. Voir [Écouter l’événement The Wallet Crew via webhook](https://github.com/TheWalletCrew/docs/blob/main/guides/develop/guides/webhook.md). ### Option 2 — Connecteur personnalisé (temps réel, charge utile personnalisée) Utilisez un connecteur personnalisé lorsque la charge utile webhook par défaut ne suffit pas. C’est le bon choix pour des structures de charge utile personnalisées. C’est aussi utile pour une authentification personnalisée (clé API, OAuth) ou une logique supplémentaire. La logique typique inclut le routage, l’enrichissement, le contrôle du débit et les tentatives de nouvelle exécution. Étape suivante : implémentez `OnCarteInstalled` et `OnCarteUninstalled`. Voir [Connecteur personnalisé pour appeler l’API lorsque l’état d’installation de la carte change](https://github.com/TheWalletCrew/docs/blob/main/guides/connect/custom-connector/installation-changed-extensibility.md). ### Option 3 — API Carte (synchronisation par lots + backfills) Utilisez l’API Carte lorsque vous souhaitez synchroniser périodiquement l’état d’installation. C’est aussi le meilleur choix pour reconstruire l’état de votre CRM après une interruption. Commencez par la documentation Swagger. Cherchez les points de terminaison de liste de cartes pouvant être filtrés par état d’installation. Swagger : #### Modèle de backfill qui fonctionne bien Exécutez une tâche planifiée qui recalcule la vérité CRM à partir de l’API Carte. La plupart des équipes l’exécutent quotidiennement. Utilisez vos événements en temps réel pour la rapidité. Utilisez le backfill pour la cohérence. Si votre CRM et les cartes ne sont pas d’accord, faites confiance à l’API Carte. Puis corrigez l’enregistrement CRM et continuez. ### Option 4 — Insights API (analytique / BI) Utilisez Insights lorsque vous voulez des volumes et des tendances, pas une synchronisation par client. Interrogez des événements comme `Carte:Installed` et `Carte:Uninstalled` avec KQL. Étape suivante : configurez l’authentification et lancez une première requête. Voir [Insights API](https://github.com/TheWalletCrew/docs/blob/main/guides/develop/guides/insights-api.md). ### Un flux de travail de bout en bout pragmatique {% stepper %} {% step %} ### 1) Ajoutez un identifiant stable à chaque carte Choisissez un seul identifiant. Utilisez le même champ sur chaque carte. {% endstep %} {% step %} ### 2) Envoyez les événements en temps réel à votre stack Utilisez les webhooks pour la plupart des configurations. Utilisez un connecteur personnalisé si vous avez besoin d’une charge utile différente. {% endstep %} {% step %} ### 3) Mettez à jour les champs CRM et les segments Mettez à jour les indicateurs par Wallet et les horodatages. Recalculez le `walletStatus`. {% endstep %} {% step %} ### 4) Faites des backfills régulièrement Planifiez une tâche API Carte. Utilisez-la pour corriger les écarts et couvrir les périodes d’indisponibilité. {% endstep %} {% step %} ### 5) Suivez l’adoption avec Insights Utilisez Insights pour les tendances et la surveillance. Validez que les installations et les désinstallations correspondent aux attentes. {% endstep %} {% endstepper %} ### Dépannage Si vous ne voyez pas d’événements, commencez par valider la signature. Vérifiez ensuite la disponibilité du point de terminaison et la gestion des nouvelles tentatives. Si vous voyez des doublons, ajoutez de l’idempotence dans votre chemin d’écriture CRM. Utilisez l’horodatage le plus récent comme critère de départage. Si vous ne pouvez pas associer les événements aux clients, il vous manque un identifiant. Ajoutez-le aux données de la carte, puis faites un backfill pour corriger l’historique. --- # Agent Instructions: 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: ``` GET https://docs.thewalletcrew.io/guides-monitoring/fr/wallet-and-privileges/sync-pass-installation-status-to-your-crm.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.