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

# Intégrations CRM

> Connectez Qwoty à votre CRM pour synchroniser les clients, les opportunités et les transactions

{/* AUDIT NOTE: Nav "Settings → Integrations → CRM" is WRONG. Integrations are under Settings → Developer → Integrations (/settings/integrations) — there is no dedicated CRM sub-page. Salesforce is NOT available (confirmed integrations: Google Chat, HubSpot, Microsoft Teams, Pennylane, Pipedrive, Slack, Stripe Invoice, Stripe Payment Link). HubSpot and Pipedrive are available CRM-type integrations. The Tabs component listing Salesforce, HubSpot, Pipedrive and the nav steps referencing "Settings → Integrations → CRM" are incorrect. All [BUTTON LABEL] TODOs retained. */}

Les intégrations CRM maintiennent vos données clients synchronisées entre Qwoty et votre plateforme commerciale. Lorsqu'elles sont activées, Qwoty peut automatiquement créer ou mettre à jour des enregistrements CRM lorsque vous créez des devis, publiez des Dealrooms ou concluez des transactions.

Qwoty prend en charge des intégrations natives avec Salesforce, HubSpot et Pipedrive.

## Ce que font les intégrations CRM

Les intégrations CRM établissent une connexion bidirectionnelle entre Qwoty et votre plateforme commerciale. Cela maintient les fiches clients, le statut des transactions et les données de devis synchronisés entre les deux systèmes.

**Fonctionnalités principales :**

* Importer les données clients et les opportunités dans Qwoty lors de la création de devis
* Envoyer les totaux de devis, les lignes de détail et les mises à jour de statut vers le CRM
* Créer ou mettre à jour automatiquement les transactions CRM lorsque les devis atteignent certains statuts
* Associer les champs Qwoty aux champs personnalisés du CRM
* Synchroniser les contrats et les détails de commande

<Note>
  Les intégrations CRM nécessitent des permissions de rôle **Administrateur** pour être configurées. Une fois activées, tous les utilisateurs bénéficient de la synchronisation.
</Note>

## Fonctionnement de la synchronisation

```mermaid theme={null}
sequenceDiagram
    participant CRM
    participant Qwoty
    participant Sales Rep
    
    Sales Rep->>Qwoty: Create quote for customer
    Qwoty->>CRM: Fetch customer & opportunity data
    CRM-->>Qwoty: Return account details
    Sales Rep->>Qwoty: Publish quote to Dealroom
    Qwoty->>CRM: Update opportunity stage
    Sales Rep->>Qwoty: Quote accepted
    Qwoty->>CRM: Create closed-won deal + order record
```

## Plateformes prises en charge

<Tabs>
  <Tab title="Salesforce">
    L'intégration Salesforce se connecte aux Comptes, Opportunités, Devis et Produits. Vous pouvez synchroniser les objets standard et personnalisés.

    **Objets synchronisés :**

    * Comptes → Clients
    * Opportunités → Devis
    * Produits → Éléments du catalogue
    * Commandes → Commandes Qwoty

    Qwoty prend en charge Salesforce Classic et Lightning Experience.
  </Tab>

  <Tab title="HubSpot">
    L'intégration HubSpot synchronise les Entreprises, Transactions, Lignes de détail et Contacts via l'API CRM HubSpot.

    **Objets synchronisés :**

    * Entreprises → Clients
    * Transactions → Devis
    * Lignes de détail → Lignes de détail du devis
    * Contacts → Contacts clients

    Les propriétés personnalisées sont prises en charge pour la correspondance des champs.
  </Tab>

  <Tab title="Pipedrive">
    L'intégration Pipedrive connecte les Organisations, Transactions et Produits via l'API REST Pipedrive.

    **Objets synchronisés :**

    * Organisations → Clients
    * Transactions → Devis
    * Produits → Éléments du catalogue

    Vous pouvez associer les étapes de transaction aux statuts de devis Qwoty.
  </Tab>
</Tabs>

## Configurer une intégration

<Steps>
  <Step title="Accéder aux paramètres CRM">
    Allez dans **Paramètres** → **Intégrations** → **CRM** et sélectionnez votre plateforme.
  </Step>

  <Step title="Autoriser la connexion">
    Cliquez sur **\[BUTTON LABEL]** {/* TODO: verify button label */} et effectuez le flux OAuth dans votre CRM. Accordez à Qwoty les permissions demandées.
  </Step>

  <Step title="Configurer la correspondance des champs">
    Associez les champs Qwoty aux champs de votre CRM. Les correspondances obligatoires incluent le nom du client, l'identifiant de l'opportunité et le total du devis. Ajoutez des correspondances de champs personnalisés si nécessaire.
  </Step>

  <Step title="Définir les déclencheurs de synchronisation">
    Choisissez les événements Qwoty qui déclenchent les mises à jour du CRM. Les déclencheurs courants incluent la création de devis, les changements de statut et la génération de commandes.
  </Step>

  <Step title="Tester la connexion">
    Cliquez sur **\[BUTTON LABEL]** {/* TODO: verify test button label */} pour vérifier que les données circulent correctement entre les systèmes.
  </Step>
</Steps>

<Warning>
  Une fois activée, l'intégration commence à synchroniser immédiatement. Testez soigneusement dans un environnement sandbox avant d'activer en production.
</Warning>

## Correspondance des champs

La correspondance des champs définit la façon dont les données circulent entre Qwoty et votre CRM. Vous pouvez associer des champs standard et personnalisés.

**Correspondances standard :**

| Champ Qwoty               | Champ CRM (typique)               | Direction   |
| ------------------------- | --------------------------------- | ----------- |
| Nom du client             | Nom du compte/de l'entreprise     | Les deux    |
| E-mail du client          | E-mail du compte                  | Les deux    |
| Total du devis            | Montant de l'opportunité          | Qwoty → CRM |
| Statut du devis           | Étape de l'opportunité            | Les deux    |
| Date de création du devis | Date de création de l'opportunité | Qwoty → CRM |

**Correspondance de champs personnalisés :**

Ajoutez des correspondances personnalisées pour synchroniser des données supplémentaires telles que le secteur, la région ou le type de transaction. Les champs personnalisés doivent exister dans les deux systèmes avant d'être associés.

## Comportement et règles de synchronisation

La synchronisation CRM de Qwoty suit ces règles pour éviter les conflits et les pertes de données :

**Direction de la synchronisation :**

* Les données clients et les opportunités circulent généralement du **CRM → Qwoty** lors de la création de devis
* Le statut du devis, les totaux et les lignes de détail circulent de **Qwoty → CRM** lors des mises à jour de devis
* La synchronisation bidirectionnelle est disponible pour les informations de contact client et les notes d'opportunité

**Résolution des conflits :**

* Les données du CRM ont la priorité pour les enregistrements clients de référence
* Les données Qwoty ont la priorité pour les calculs de devis et les lignes de détail
* Les modifications manuelles dans l'un ou l'autre système déclenchent un événement de synchronisation

**Fréquence de synchronisation :**

* En temps réel pour les changements de statut et les mises à jour critiques
* Par lots toutes les 15 minutes pour les données non critiques
* Synchronisation à la demande disponible via **\[BUTTON LABEL]** {/* TODO: verify manual sync button */}

<Info>
  Les enregistrements supprimés dans Qwoty ne sont pas supprimés dans votre CRM. Ils sont marqués avec un champ personnalisé pour préserver l'historique d'audit.
</Info>

## Déconnecter une intégration

Pour déconnecter une intégration CRM, allez dans **Paramètres** → **Intégrations** → **CRM** et cliquez sur **\[BUTTON LABEL]** {/* TODO: verify disconnect action */}.

La déconnexion arrête immédiatement toute synchronisation. Les données existantes dans les deux systèmes restent inchangées. Vous pouvez vous reconnecter à tout moment sans perte de données.

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Puis-je connecter plusieurs comptes CRM ?">
    Non. Qwoty prend en charge une seule connexion CRM active par espace de travail. Pour changer de CRM, déconnectez l'intégration actuelle avant d'en connecter une nouvelle.
  </Accordion>

  <Accordion title="Que se passe-t-il si une synchronisation échoue ?">
    Les synchronisations échouées sont consignées dans **Paramètres** → **Intégrations** → **Journaux de synchronisation**. Qwoty réessaie automatiquement jusqu'à trois fois. Si l'échec persiste, vous recevez une notification par e-mail et pouvez relancer manuellement la synchronisation.
  </Accordion>

  <Accordion title="Puis-je synchroniser des devis historiques ?">
    Oui. Après avoir activé l'intégration, utilisez l'option **\[BUTTON LABEL]** {/* TODO: verify bulk sync feature */} pour synchroniser les devis existants. Il s'agit d'une opération unique qui peut prendre plusieurs minutes selon le volume de données.
  </Accordion>

  <Accordion title="Les intégrations fonctionnent-elles avec des champs CRM personnalisés ?">
    Oui. Vous pouvez associer n'importe quel champ personnalisé de votre CRM aux champs Qwoty lors de la configuration. Les types de champs texte et liste déroulante sont pris en charge.
  </Accordion>

  <Accordion title="Comment les lignes de détail du devis sont-elles synchronisées ?">
    Les lignes de détail du devis sont synchronisées en tant qu'enregistrements de produits individuels ou objets de ligne dans votre CRM. La structure dépend du modèle de données de votre CRM. Les offres groupées sont synchronisées sous forme de relations parent-enfant lorsque cela est pris en charge.
  </Accordion>
</AccordionGroup>

## Sujets associés

<CardGroup cols={2}>
  <Card title="API et webhooks" icon="code" href="/developers/core-concepts/webhooks">
    Connectez Qwoty à des systèmes personnalisés via l'API REST et les webhooks
  </Card>

  <Card title="Gestion des clients" icon="users" href="/user-guide/customers/introduction">
    Découvrez comment les clients et les contacts sont gérés dans Qwoty
  </Card>

  <Card title="Cycle de vie des devis" icon="chart-line" href="/user-guide/quotes/reference/lifecycle">
    Comprenez les statuts des devis et leur correspondance avec les étapes CRM
  </Card>

  <Card title="Rôles et permissions utilisateurs" icon="shield" href="/user-guide/settings/users/manage-users">
    Contrôlez qui peut configurer et utiliser les intégrations
  </Card>
</CardGroup>