# HubSpot-Knoten

HubSpot in der Palette ist ein Knoten pro Objekt. Jede Karte bleibt **Setup required**, bis HubSpot unter [Integrations](https://docs.voicelogica.ai/de/integrations/hubspot/) verbunden ist. Das Agent-Tool **HubSpot** (Anrufer-ID, Live-Property-Updates) befindet sich auf dieser Seite — diese Seite ist der *Graph*.

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

## Warum diese Knoten

Ein deterministischer Schreibvorgang, nachdem Sie bereits die Telefonnummer oder E-Mail kennen. Trigger **HubSpot Contact Created** / **Property Changed** sind [Workflow-Trigger](https://docs.voicelogica.ai/de/workflows/) plus dieselbe Verbindung.

## Welcher Knoten

Katalog-Titel:

- **Person finden oder erstellen** — turn on **Manage Contact in HubSpot** (needs Get / Get or create / Create or update / List / Search / Delete. Telefon aus **Call Parameters**.)
- **Das Unternehmen** — turn on **Manage Company in HubSpot** (needs Name + Domain beim Erstellen.)
- **Ein Deal oder Ticket** — turn on **Manage Deal / Manage Ticket** (needs Pipeline + Phase beim Erstellen.)
- **Eine Folgeaufgabe für einen Menschen** — turn on **Manage Task in HubSpot** (needs Titel erforderlich. Besitzer + Fälligkeitsdatum.)
- **Eine Notiz zum Datensatz** — turn on **Create Note in HubSpot** (needs Inhalt erforderlich. **Associations** verknüpfen es.)
- **Die Aktivität protokollieren** — turn on **Log Call / Log Email / Schedule Meeting** (needs Bei einem Telefon-Trigger werden Anrufmetadaten (Richtung, Dauer) automatisch aus dem Anruf übernommen — stellen Sie diese nicht manuell ein.)

**Operation** ist bei jeder Karte erforderlich. Suchfelder verwenden **Get by** / **Value** (`{{call.phone_number}}`). Erstellungsfelder ändern sich mit der Operation.

Ports folgen dem Objekt (Contact: **Contact saved** / **HubSpot error** / **No wait**).

Galaxy, Shopify, Soft1, WooCommerce, Salesforce, Guesty folgen derselben Regel: Verbinden Sie unter [Integrations](https://docs.voicelogica.ai/de/integrations/), dann fügen Sie den Knoten dieses Anbieters hinzu. Sie erhalten hier keine eigenen Seiten.

## Erste Einrichtung — Anrufer nach Auflegen erstellen oder aktualisieren

1. [HubSpot verbinden](https://docs.voicelogica.ai/de/integrations/hubspot/).

2. [On Call End](https://docs.voicelogica.ai/de/workflows/on-call-end/) → **Manage Contact in HubSpot**. Operation **Create or update**. Phone = Anrufernummer.

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

3. **Save & go live**, anhängen, auflegen. Öffnen Sie den Kontakt in HubSpot.

## So sieht "fehlerhaft" aus

- **Setup required** — Integrations → HubSpot ist nicht verbunden.
- Leerer Kontakt — Value stimmt nicht überein (fehlendes `+`, falsches **Get by**).
- Anrufprotokollfelder, die Sie eingegeben haben, werden ignoriert — ein Telefon-Trigger besitzt sie bereits.

## Fehlerbehebung

**Tool vs. Workflow-Knoten?**

Das Tool ist das, was das *Modell* während des Gesprächs tun kann. Der Knoten ist das, was der *Graph* immer bei diesem Trigger tut. Verwenden Sie den Knoten für "diesen Kontakt immer ablegen". Verwenden Sie das Tool für "eine Property aktualisieren, die sie gerade bestätigt haben".

## Nächste Schritte

[HubSpot verbinden](https://docs.voicelogica.ai/de/integrations/hubspot/).  
[On Call End](https://docs.voicelogica.ai/de/workflows/on-call-end/).  
[Knoten auswählen](https://docs.voicelogica.ai/de/workflow-nodes/).