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

# HubSpot

> Synchronisez vos leads et contacts avec HubSpot.

L'intégration HubSpot connecte votre compte Scanova à un portail HubSpot via OAuth, puis vous guide à travers un assistant qui associe les soumissions d'un formulaire ou d'un QR code à un objet CRM HubSpot — Contact, Company, Deal ou Ticket — afin que chaque soumission devienne automatiquement un enregistrement HubSpot.

## Prérequis

* Un compte HubSpot avec l'autorisation d'autoriser de nouvelles connexions d'applications pour le portail.
* Un plan Scanova incluant l'intégration HubSpot. Sans cela, la connexion renvoie une erreur "Your plan does not include HubSpot integration".
* Au moins un formulaire du Form-builder ou un QR code avec une source de soumission (Custom Form, Feedback, RSVP, demande Real Estate ou feedback Restaurant) déjà configurée, car l'assistant a besoin d'une source à synchroniser.

## Configurer une connexion

HubSpot s'ouvre comme sa propre page complète (pas un panneau latéral), car l'assistant a besoin de place.

<Steps>
  <Step title="Ouvrir l'intégration HubSpot">
    Depuis **Integrations**, sélectionnez **Add Integration**, puis trouvez la carte **HubSpot** et sélectionnez **Setup**.
  </Step>

  <Step title="Connecter HubSpot">
    Sélectionnez **Connect HubSpot**. Vous êtes redirigé vers HubSpot pour autoriser Scanova, puis ramené à l'assistant. Une bannière verte affiche l'identifiant du portail connecté une fois l'autorisation réussie.
  </Step>

  <Step title="Choisir ce qu'il faut synchroniser">
    Choisissez le type de source de soumission : **Forms** (n'importe quel formulaire du Form-builder), **Custom Form Component**, **Feedback Form (Feedback QR Code)**, **RSVP Form Component**, **Inquiry Form (Real Estate QR Code)**, ou **Feedback Form (Restaurant QR Code)**.
  </Step>

  <Step title="Sélectionner la source">
    Selon le type choisi, recherchez et sélectionnez le formulaire ou le QR code spécifique dont les soumissions doivent être synchronisées.
  </Step>

  <Step title="Choisir l'action HubSpot">
    Sélectionnez quel objet HubSpot chaque soumission doit créer : **Create Contact**, **Create Company**, **Create Deal**, ou **Create Ticket**.
  </Step>

  <Step title="Associer les champs">
    Faites correspondre les champs de votre source aux propriétés HubSpot. Les propriétés HubSpot mises en avant pour l'objet choisi sont pré-listées ; utilisez **Add a field** pour associer d'autres propriétés depuis le catalogue complet. Les associations incompatibles sont bloquées en ligne — par exemple, une propriété numérique HubSpot ne peut pas être associée à un champ texte, et une propriété de type date ne peut pas être associée à un champ qui n'est pas une date.

    <Note>
      Une association que l'assistant ne signale pas comme invalide mais qui ne peut malgré tout pas être convertie vers le type de la propriété HubSpot est silencieusement abandonnée au moment de la synchronisation plutôt que de provoquer une erreur — la validation en ligne existe précisément pour repérer cela au préalable.
    </Note>
  </Step>

  <Step title="Vérifier, tester et terminer">
    Nommez la connexion (utilisé plus tard pour l'identifier dans Active Connections), vérifiez le résumé des associations, et éventuellement sélectionnez **Send test** pour envoyer un enregistrement d'exemple à HubSpot et confirmer son arrivée avant de sélectionner **Complete setup**.
  </Step>
</Steps>

## Gérer la connexion

* **Disconnect** (dans la bannière connectée) arrête la synchronisation pour tout le portail — chaque connexion HubSpot qui lui est liée cesse d'envoyer des données.
* Modifier une connexion existante depuis **Active Connections** rouvre le même assistant en 5 étapes, pré-rempli.

## Quelles données circulent où

Chaque fois que le formulaire ou le QR code configuré reçoit une nouvelle soumission, Scanova envoie les valeurs de champs associées comme un nouvel enregistrement du type d'objet choisi (Contact, Company, Deal ou Ticket) dans le portail connecté.

## À voir aussi

* [Slack](/fr/integrations/slack) — une autre intégration connectée par OAuth avec son propre générateur de règles nommées.
* [Webhooks](/fr/integrations/webhooks) — une alternative générique si vous devez envoyer des données de soumission vers un endroit que HubSpot ne couvre pas.
* [Form management](/fr/api-reference/management-api/forms/list) — l'API derrière les sources Forms que cet assistant synchronise.
* [Lead list management](/fr/api-reference/management-api/leads/list) — l'API derrière les sources de synchronisation Lead List historiques.