# Nœuds HubSpot

HubSpot dans la palette est un nœud par objet. Chaque carte reste **Setup required** jusqu'à ce que HubSpot soit connecté sur [Integrations](https://docs.voicelogica.ai/fr/integrations/hubspot/). L'outil agent **HubSpot** (ID d'appelant, mises à jour de propriétés en direct) est cette page — cette page est le *graphe*.

  <ShotPlaceholder
    src="/assets/workflow-nodes/hubspot.png"
    name="wn-hs"
    alt="Manage Contact in HubSpot"
    capture="HubSpot Contact node. 1600×900. Operation visible. Redact emails."
  />

## Pourquoi ces nœuds

Une écriture déterministe après que vous connaissez déjà le téléphone ou l'e-mail. Les triggers **HubSpot Contact Created** / **Property Changed** sont [Workflow Triggers](https://docs.voicelogica.ai/fr/workflows/) plus la même connexion.

## Quel nœud

Titres du catalogue :

- **Trouver ou upsert la personne** — turn on **Manage Contact in HubSpot** (needs Get / Get or create / Create or update / List / Search / Delete. Téléphone depuis **Call Parameters**.)
- **L'entreprise** — turn on **Manage Company in HubSpot** (needs Nom + domaine lors de la création.)
- **Une affaire ou un ticket** — turn on **Manage Deal / Manage Ticket** (needs Pipeline + étape lors de la création.)
- **Un suivi pour un humain** — turn on **Manage Task in HubSpot** (needs Titre requis. Propriétaire + date d'échéance.)
- **Une note sur l'enregistrement** — turn on **Create Note in HubSpot** (needs Corps requis. **Associations** le lient.)
- **Enregistrer l'activité** — turn on **Log Call / Log Email / Schedule Meeting** (needs Sur un trigger téléphonique, les métadonnées d'appel (direction, durée) sont remplies depuis l'appel — ne les définissez pas manuellement.)

**Operation** est requis sur chaque carte. Les champs de recherche utilisent **Get by** / **Value** (`{{call.phone_number}}`). Les champs de création changent avec l'opération.

Les ports suivent l'objet (Contact : **Contact saved** / **HubSpot error** / **No wait**).

Galaxy, Shopify, Soft1, WooCommerce, Salesforce, Guesty sont la même règle : connectez sur [Integrations](https://docs.voicelogica.ai/fr/integrations/), puis ajoutez le nœud de ce fournisseur. Ils n'obtiennent pas leurs propres pages ici.

## Première configuration — upsert l'appelant après le raccrochage

1. [Connecter HubSpot](https://docs.voicelogica.ai/fr/integrations/hubspot/).

2. [On Call End](https://docs.voicelogica.ai/fr/workflows/on-call-end/) → **Manage Contact in HubSpot**. Opération **Create or update**. Téléphone = numéro de l'appelant.

     <ShotPlaceholder
       src="/assets/workflow-nodes/hubspot-filled.png"
       name="hubspot-filled"
       alt="Manage Contact in HubSpot rempli"
       capture="Workflow builder → Manage Contact in HubSpot selected. Operation Create or update, phone mapped. 1600×900. Redact numbers/emails/PINs."
     />

3. **Save & go live**, attachez, raccrochez. Ouvrez le contact dans HubSpot.

## À quoi ressemble "cassé"

- **Setup required** — Integrations → HubSpot n'est pas connecté.
- Contact vide — Value ne correspondait pas (`+` manquant, mauvais **Get by**).
- Les champs de journal d'appel que vous avez tapés sont ignorés — un trigger téléphonique les possède déjà.

## Dépannage

**Outil vs nœud de workflow ?**

L'outil est ce que le *modèle* peut faire en parlant. Le nœud est ce que le *graphe* fait toujours sur ce trigger. Utilisez le nœud pour "toujours enregistrer ce contact". Utilisez l'outil pour "mettre à jour une propriété qu'ils viennent de confirmer".

## Prochaines étapes

[Connecter HubSpot](https://docs.voicelogica.ai/fr/integrations/hubspot/).  
[On Call End](https://docs.voicelogica.ai/fr/workflows/on-call-end/).  
[Choisir un nœud](https://docs.voicelogica.ai/fr/workflow-nodes/).