> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piperai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dépannage des problèmes de synchronisation CRM et d'intégration dans Piper AI

> Résolvez les problèmes de synchronisation CRM dans Piper AI — notes non synchronisées, champs non mis à jour, échecs de liaison de deals, connexions rompues, et problèmes Aircall.

Piper AI synchronise les notes de réunion, les champs CRM structurés et les tâches directement vers votre CRM après chaque appel. Lorsqu'une synchronisation ne se comporte pas comme prévu, la cause est presque toujours l'un d'un petit ensemble de problèmes de configuration — une correspondance de contact manquante, un deal qui n'a pas été lié, ou un jeton d'authentification à rafraîchir. Parcourez les scénarios ci-dessous pour identifier et corriger le problème.

<Accordion title="Mes notes ne se synchronisent pas avec le CRM">
  Piper ne synchronise les notes avec votre CRM que lorsqu'il peut faire correspondre au moins un participant à l'appel avec un enregistrement de contact existant.

  <Steps>
    <Step title="Vérifiez une correspondance de contact">
      Vérifiez qu'au moins une personne ayant assisté à la réunion existe comme **Contact** dans votre CRM. Piper utilise l'adresse e-mail pour faire correspondre les participants aux contacts.
    </Step>

    <Step title="Créez le contact s'il n'existe pas">
      Si aucun enregistrement de contact n'existe pour un participant, créez-en un dans votre CRM puis déclenchez manuellement la synchronisation depuis la page Transcription.
    </Step>

    <Step title="Confirmez la synchronisation">
      Ouvrez la page Transcription de la réunion et vérifiez le sélecteur d'entité CRM pour confirmer qu'un contact a été lié.
    </Step>
  </Steps>

  <Note>
    Les réunions purement internes (où tous les participants appartiennent à votre propre organisation) ne déclencheront pas de synchronisation CRM, sauf si vos collègues sont également présents comme contacts dans le CRM.
  </Note>
</Accordion>

<Accordion title="Les champs CRM ne sont pas renseignés ou mis à jour">
  Le remplissage des champs CRM a deux prérequis : un deal lié et l'Auto-Sync activé. Si l'un des deux manque, les champs ne se mettront pas à jour automatiquement.

  **Vérification 1 — Un Deal est-il lié à la réunion ?**

  <Steps>
    <Step title="Ouvrez l'Activity Card ou la page Transcription">
      Trouvez la réunion sur votre Home Page ou naviguez vers sa page Transcription.
    </Step>

    <Step title="Vérifiez le sélecteur d'entité CRM">
      Recherchez un Deal lié. Si aucun deal n'est affiché, cliquez sur le sélecteur d'entité et liez manuellement le deal concerné.
    </Step>
  </Steps>

  <Note>
    Le sélecteur d'entité CRM manuel (utilisé pour consulter ou lier un Deal, Contact ou Company) est disponible sur le plan **Pro** de Piper. Si vous ne le voyez pas, vérifiez votre plan dans **Settings → Billing**.
  </Note>

  **Vérification 2 — Fields Auto-Sync est-il activé ?**

  <Steps>
    <Step title="Allez dans Settings → Meeting Types">
      Naviguez vers **Settings**, puis sélectionnez **Meeting Types**.
    </Step>

    <Step title="Vérifiez le bouton Auto-Sync">
      Trouvez le Meeting Type applicable à cet appel. Confirmez que **Fields Auto-Sync** est activé.
    </Step>

    <Step title="Activez Auto-Sync si désactivé">
      Si Auto-Sync est désactivé, les champs CRM et tâches sont conservés en **mode de revue** sur la page Transcription. Vous pouvez les approuver individuellement avec le bouton de flèche verte, ou cliquer sur **Send All** pour tout envoyer en une seule fois.
    </Step>
  </Steps>
</Accordion>

<Accordion title="Piper ne lie pas automatiquement un deal à ma réunion">
  Piper lie automatiquement un deal à une réunion lorsqu'il peut trouver un contact participant associé à exactement **un** deal ouvert dans votre CRM.

  Si la liaison automatique ne se produit pas, la cause la plus probable est que le contact est associé à **plus d'un deal ouvert** — Piper ne devine pas lequel est le bon.

  **Pour lier le deal manuellement :**

  <Steps>
    <Step title="Trouvez la réunion sur votre Home Page">
      Localisez l'Activity Card de la réunion.
    </Step>

    <Step title="Utilisez le sélecteur d'entité CRM">
      Cliquez sur le sélecteur de deal sur l'Activity Card ou sur la page Transcription, puis choisissez le bon deal dans la liste.
    </Step>
  </Steps>

  <Tip>
    Si un contact est régulièrement associé à plusieurs deals ouverts (par exemple, un compte enterprise avec plusieurs opportunités actives), envisagez de clôturer ou d'archiver les deals obsolètes dans votre CRM pour permettre à la liaison automatique de fonctionner de manière fiable.
  </Tip>
</Accordion>

<Accordion title="Je ne vois que quelques deals CRM dans Piper, alors que mon CRM en contient des centaines">
  Piper ne reflète pas en continu l'intégralité de la liste de deals de votre CRM. Il n'importe un deal que lorsque :

  * **Un contact lié apparaît sur une réunion du calendrier.** Une fois par jour, Piper vérifie les deals CRM dont les contacts sont participants à une réunion dans les quelques jours autour de celle-ci — seuls ceux-là sont importés.
  * **La connexion au CRM est récente.** Lors de la première connexion d'un CRM, Piper effectue une reprise ponctuelle de vos \~100 deals les plus récemment mis à jour, en plus de l'import basé sur les réunions ci-dessus. Cela ne se produit qu'une seule fois, au moment de la connexion.

  Un deal sans participant sur votre calendrier et sans activité récente dans le CRM au moment de la connexion peut donc ne jamais atteindre Piper de lui-même.

  <Tip>
    Pour importer un deal spécifique immédiatement, recherchez-le par son nom dans n'importe quel sélecteur de Deal — le sélecteur d'entité CRM sur une Activity Card ou une page Transcription, ou le filtre Deal sur la page Deals. Si Piper ne l'a pas déjà, il effectue une recherche en direct dans votre CRM et importe le deal correspondant sur-le-champ.
  </Tip>
</Accordion>

<Accordion title="Je vois une bannière 'Reconnect with CRM' ou l'intégration semble cassée">
  Les intégrations CRM — en particulier Salesforce — peuvent perdre leur jeton d'authentification en raison d'erreurs d'authentification temporaires, d'expiration de session, ou d'un changement de mot de passe sur le compte connecté.

  <Steps>
    <Step title="Allez dans Settings → Integrations">
      Naviguez vers **Settings**, puis sélectionnez **Integrations**.
    </Step>

    <Step title="Reconnectez votre CRM">
      Cliquez sur **Reconnect** à côté de votre CRM (Salesforce, HubSpot, etc.) et complétez le flux d'autorisation OAuth.
    </Step>

    <Step title="Vérifiez la connexion">
      Après reconnexion, retournez sur une page Transcription récente et confirmez que le sélecteur d'entité CRM se charge correctement.
    </Step>
  </Steps>

  <Note>
    Salesforce perd occasionnellement la connexion avec Piper en raison d'erreurs d'authentification temporaires — il s'agit d'un comportement OAuth connu de Salesforce et non d'un bug de Piper. Se reconnecter via Settings résout le problème immédiatement.
  </Note>

  <Note>
    Reconnecter un CRM nécessite le rôle **Owner** ou **Admin** sur le plan **Pro** de Piper. Les Standard users voient une bannière leur demandant de contacter leur Team Owner plutôt qu'un bouton **Reconnect** fonctionnel — si c'est votre cas, demandez à un Admin d'effectuer les étapes ci-dessus.
  </Note>

  **Exigence spécifique à HubSpot :** au moins un Piper Admin doit également avoir le statut **Super Admin** dans HubSpot. Si la connexion HubSpot échoue, vérifiez que le Piper Admin qui a connecté l'intégration est un Super Admin HubSpot.
</Accordion>

<Accordion title="Piper semble écraser mes valeurs de champs CRM existantes">
  Piper n'écrase **jamais** les valeurs CRM existantes. Lorsqu'il met à jour un champ, la formule utilisée est :

  > **Nouvelle valeur CRM = Valeur CRM actuelle + Prompt du champ + Contenu de la transcription**

  En d'autres termes, Piper ajoute à ou enrichit ce qui existe déjà — il ne le remplace pas.

  Si vos valeurs de champs semblent inattendues, la cause la plus probable est le prompt configuré pour ce champ dans les paramètres de votre Meeting Type.

  <Steps>
    <Step title="Allez dans Settings → Meeting Types">
      Ouvrez le Meeting Type applicable à l'appel en question.
    </Step>

    <Step title="Revoyez les prompts des champs">
      Vérifiez le prompt de chaque champ CRM. Des prompts vagues ou trop larges peuvent conduire Piper à intégrer plus de contenu que prévu. Affinez le prompt pour être précis sur les informations qui doivent remplir ce champ.
    </Step>

    <Step title="Enregistrez et testez">
      Exécutez une réunion de test et examinez la sortie du champ CRM pour confirmer que le prompt produit le résultat attendu.
    </Step>
  </Steps>
</Accordion>

<Accordion title="Les appels Aircall n'apparaissent pas dans Piper">
  L'intégration Aircall fonctionne au niveau du **numéro de téléphone**, pas au niveau du compte utilisateur. Chaque numéro de téléphone doit être explicitement activé dans le tableau de bord Aircall avant que Piper puisse capturer les appels effectués ou reçus sur ce numéro.

  <Steps>
    <Step title="Ouvrez l'Aircall Dashboard">
      Connectez-vous à votre compte Aircall.
    </Step>

    <Step title="Allez dans Integrations → Piper AI">
      Naviguez vers **Integrations**, trouvez l'intégration **Piper AI**, et ouvrez ses paramètres.
    </Step>

    <Step title="Ajoutez les numéros concernés">
      Cliquez sur **Add Numbers** et activez chaque numéro de téléphone dont les appels doivent apparaître dans Piper.
    </Step>

    <Step title="Testez avec un nouvel appel">
      Passez ou recevez un appel sur l'un des numéros activés et confirmez qu'il apparaît dans Piper en quelques minutes.
    </Step>
  </Steps>

  <Warning>
    Ajouter Piper au compte d'un utilisateur n'active pas automatiquement ses numéros Aircall. Chaque numéro doit être activé individuellement dans les paramètres d'intégration Aircall.
  </Warning>
</Accordion>

<Accordion title="Je vois des notes ou des appels enregistrés en double provenant d'Aircall et de HubSpot">
  L'intégration Aircall de Piper et sa capture HubSpot Call sont deux sources d'appels téléphoniques indépendantes — chacune est déclenchée par son propre webhook, et Piper ne vérifie pas si l'autre a déjà traité le même appel réel.

  Si un appel arrive chez Piper par les deux voies — par exemple, vos numéros sont connectés via l'intégration Aircall de Piper, et ces mêmes appels sont également enregistrés dans HubSpot avec un enregistrement audio (via le connecteur HubSpot natif propre à Aircall, ou un autre outil d'appel) — Piper crée deux Activities distinctes pour cet appel, chacune avec sa propre transcription, ses notes et sa synchronisation CRM. C'est un comportement attendu compte tenu du fonctionnement actuel des deux intégrations, pas une erreur de configuration.

  <Steps>
    <Step title="Identifiez la seconde source">
      Vérifiez si vos appels sont également enregistrés dans HubSpot avec un enregistrement audio par un outil autre que Piper — le plus souvent le connecteur HubSpot natif propre à Aircall, qui se configure séparément dans le tableau de bord Aircall, pas dans Piper.
    </Step>

    <Step title="Ne gardez qu'une seule voie active">
      Désactivez la voie que vous ne voulez pas voir traitée par Piper : désactivez l'intégration Aircall de Piper si vous préférez vous appuyer sur HubSpot Call, ou supprimez le connecteur d'enregistrement d'appels vers HubSpot de l'autre outil si vous préférez garder l'intégration Aircall de Piper comme source de vérité.
    </Step>

    <Step title="Contactez le support Piper en cas de doute">
      Si vous ne parvenez pas à identifier quelle intégration produit le doublon, le support Piper peut retracer quel webhook a créé chaque Activity.
    </Step>
  </Steps>

  <Warning>
    Piper ne dé-duplique pas aujourd'hui les appels provenant de sources téléphoniques différentes. Si plusieurs intégrations envoient le même appel à Piper, attendez-vous à une Activity distincte — et des notes CRM distinctes — pour chacune.
  </Warning>
</Accordion>

<Accordion title="Auto-Sync est désactivé — comment approuver les mises à jour CRM en attente ?">
  Lorsque l'Auto-Sync est désactivé pour un Meeting Type, Piper conserve tous les champs CRM et tâches générés en **mode de revue** plutôt que de les envoyer automatiquement. Cela vous donne l'occasion de vérifier le résultat avant qu'il n'entre dans votre CRM.

  Pour approuver les mises à jour en attente :

  <Steps>
    <Step title="Ouvrez la page Transcription de la réunion">
      Naviguez vers la réunion concernée et ouvrez sa page Transcription.
    </Step>

    <Step title="Passez en revue les champs et tâches en attente">
      Chaque élément en attente sera affiché avec un indicateur de revue.
    </Step>

    <Step title="Approuvez individuellement ou en une fois">
      * Cliquez sur le bouton de **flèche verte** à côté d'un champ ou d'une tâche individuelle pour l'approuver un par un.
      * Cliquez sur **Send All** pour approuver et envoyer tout en une seule action.
    </Step>
  </Steps>

  <Tip>
    Si vous souhaitez que Piper envoie les mises à jour CRM automatiquement sans revue manuelle, activez **Fields Auto-Sync** dans **Settings → Meeting Types** pour le Meeting Type concerné.
  </Tip>
</Accordion>