mirror of
https://github.com/simstudioai/sim.git
synced 2026-02-12 07:24:55 -05:00
295 lines
14 KiB
Plaintext
295 lines
14 KiB
Plaintext
---
|
||
title: HubSpot
|
||
description: Interagieren Sie mit HubSpot CRM oder lösen Sie Workflows von
|
||
HubSpot-Ereignissen aus
|
||
---
|
||
|
||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||
|
||
<BlockInfoCard
|
||
type="hubspot"
|
||
color="#FF7A59"
|
||
/>
|
||
|
||
{/* MANUAL-CONTENT-START:intro */}
|
||
[HubSpot](https://www.hubspot.com) ist eine umfassende CRM-Plattform, die eine vollständige Suite von Marketing-, Vertriebs- und Kundenservice-Tools bietet, um Unternehmen beim besseren Wachstum zu unterstützen. Mit seinen leistungsstarken Automatisierungsfunktionen und umfangreicher API ist HubSpot zu einer der weltweit führenden CRM-Plattformen geworden, die Unternehmen aller Größen und Branchen bedient.
|
||
|
||
HubSpot CRM bietet eine komplette Lösung für die Verwaltung von Kundenbeziehungen, vom ersten Kontakt bis zum langfristigen Kundenerfolg. Die Plattform kombiniert Kontaktverwaltung, Deal-Tracking, Marketing-Automatisierung und Kundenservice-Tools in einem einheitlichen System, das Teams dabei hilft, aufeinander abgestimmt und auf den Kundenerfolg fokussiert zu bleiben.
|
||
|
||
Zu den wichtigsten Funktionen von HubSpot CRM gehören:
|
||
|
||
- Kontakt- & Unternehmensverwaltung: Umfassende Datenbank zur Speicherung und Organisation von Kunden- und Interessenteninformationen
|
||
- Deal-Pipeline: Visuelle Vertriebspipeline zur Verfolgung von Verkaufschancen durch anpassbare Phasen
|
||
- Marketing-Events: Verfolgen und Verwalten von Marketingkampagnen und Veranstaltungen mit detaillierter Attribution
|
||
- Ticket-Management: Kundenservice-Ticketsystem zur Verfolgung und Lösung von Kundenproblemen
|
||
- Angebote & Artikelpositionen: Erstellen und Verwalten von Verkaufsangeboten mit detaillierten Produktpositionen
|
||
- Benutzer- & Teamverwaltung: Teams organisieren, Verantwortlichkeiten zuweisen und Benutzeraktivitäten auf der gesamten Plattform verfolgen
|
||
|
||
In Sim ermöglicht die HubSpot-Integration Ihren KI-Agenten eine nahtlose Interaktion mit Ihren CRM-Daten und die Automatisierung wichtiger Geschäftsprozesse. Dies schafft leistungsstarke Möglichkeiten für intelligente Lead-Qualifizierung, automatisierte Kontaktanreicherung, Deal-Management, Kundenservice-Automatisierung und Datensynchronisierung in Ihrem Tech-Stack. Die Integration ermöglicht Agenten das Erstellen, Abrufen, Aktualisieren und Durchsuchen aller wichtigen HubSpot-Objekte und ermöglicht so anspruchsvolle Workflows, die auf CRM-Ereignisse reagieren, die Datenqualität aufrechterhalten und sicherstellen, dass Ihr Team über die aktuellsten Kundeninformationen verfügt. Durch die Verbindung von Sim mit HubSpot können Sie KI-Agenten erstellen, die automatisch Leads qualifizieren, Support-Tickets weiterleiten, Deal-Phasen basierend auf Kundeninteraktionen aktualisieren, Angebote generieren und Ihre CRM-Daten mit anderen Geschäftssystemen synchronisieren – was letztendlich die Teamproduktivität steigert und die Kundenerfahrung verbessert.
|
||
{/* MANUAL-CONTENT-END */}
|
||
|
||
## Nutzungsanleitung
|
||
|
||
Integrieren Sie HubSpot in Ihren Workflow. Verwalten Sie Kontakte, Unternehmen, Deals, Tickets und andere CRM-Objekte mit leistungsstarken Automatisierungsfunktionen. Kann im Trigger-Modus verwendet werden, um Workflows zu starten, wenn Kontakte erstellt, gelöscht oder aktualisiert werden.
|
||
|
||
## Tools
|
||
|
||
### `hubspot_get_users`
|
||
|
||
Alle Benutzer vom HubSpot-Konto abrufen
|
||
|
||
#### Input
|
||
|
||
| Parameter | Type | Required | Description |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `limit` | string | No | Anzahl der zurückzugebenden Ergebnisse \(Standard: 100\) |
|
||
|
||
#### Output
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `users` | array | Array von HubSpot-Benutzerobjekten |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_list_contacts`
|
||
|
||
Alle Kontakte vom HubSpot-Konto mit Paginierungsunterstützung abrufen
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `limit` | string | Nein | Maximale Anzahl von Ergebnissen pro Seite \(max. 100, Standard 100\) |
|
||
| `after` | string | Nein | Paginierungscursor für die nächste Ergebnisseite |
|
||
| `properties` | string | Nein | Kommagetrennte Liste der zurückzugebenden Eigenschaften \(z.B. "email,firstname,lastname"\) |
|
||
| `associations` | string | Nein | Kommagetrennte Liste der Objekttypen, für die zugehörige IDs abgerufen werden sollen |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `contacts` | array | Array von HubSpot-Kontaktobjekten |
|
||
| `paging` | object | Paginierungsinformationen |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_get_contact`
|
||
|
||
Einen einzelnen Kontakt anhand von ID oder E-Mail aus HubSpot abrufen
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `contactId` | string | Ja | Die ID oder E-Mail des abzurufenden Kontakts |
|
||
| `idProperty` | string | Nein | Eigenschaft, die als eindeutiger Identifikator verwendet werden soll \(z.B. "email"\). Falls nicht angegeben, wird die Datensatz-ID verwendet |
|
||
| `properties` | string | Nein | Kommagetrennte Liste der zurückzugebenden Eigenschaften |
|
||
| `associations` | string | Nein | Kommagetrennte Liste der Objekttypen, für die zugehörige IDs abgerufen werden sollen |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `contact` | object | HubSpot-Kontaktobjekt mit Eigenschaften |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_create_contact`
|
||
|
||
Erstellt einen neuen Kontakt in HubSpot. Erfordert mindestens eines der folgenden Felder: E-Mail, Vorname oder Nachname
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `properties` | object | Ja | Kontakteigenschaften als JSON-Objekt. Muss mindestens eines der folgenden Felder enthalten: E-Mail, Vorname oder Nachname |
|
||
| `associations` | array | Nein | Array von Verknüpfungen, die mit dem Kontakt erstellt werden sollen \(z.B. Unternehmen, Deals\). Jedes Objekt sollte "to" \(mit "id"\) und "types" \(mit "associationCategory" und "associationTypeId"\) enthalten |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `contact` | object | Erstelltes HubSpot-Kontaktobjekt |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_update_contact`
|
||
|
||
Aktualisiert einen bestehenden Kontakt in HubSpot anhand von ID oder E-Mail
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `contactId` | string | Ja | Die ID oder E-Mail des zu aktualisierenden Kontakts |
|
||
| `idProperty` | string | Nein | Eigenschaft, die als eindeutiger Identifikator verwendet werden soll \(z.B. "email"\). Wenn nicht angegeben, wird die Datensatz-ID verwendet |
|
||
| `properties` | object | Ja | Zu aktualisierende Kontakteigenschaften als JSON-Objekt |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `contact` | object | Aktualisiertes HubSpot-Kontaktobjekt |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_search_contacts`
|
||
|
||
Suche nach Kontakten in HubSpot mit Filtern, Sortierung und Abfragen
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `filterGroups` | array | Nein | Array von Filtergruppen. Jede Gruppe enthält Filter mit propertyName, operator und value |
|
||
| `sorts` | array | Nein | Array von Sortierobjekten mit propertyName und direction ("ASCENDING" oder "DESCENDING") |
|
||
| `query` | string | Nein | Suchabfragestring |
|
||
| `properties` | array | Nein | Array von Eigenschaftsnamen, die zurückgegeben werden sollen |
|
||
| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse (max. 100) |
|
||
| `after` | string | Nein | Paginierungscursor für die nächste Seite |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `contacts` | array | Array übereinstimmender HubSpot-Kontaktobjekte |
|
||
| `total` | number | Gesamtanzahl übereinstimmender Kontakte |
|
||
| `paging` | object | Paginierungsinformationen |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_list_companies`
|
||
|
||
Alle Unternehmen aus dem HubSpot-Konto mit Paginierungsunterstützung abrufen
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `limit` | string | Nein | Maximale Anzahl der Ergebnisse pro Seite (max. 100, Standard 100) |
|
||
| `after` | string | Nein | Paginierungscursor für die nächste Ergebnisseite |
|
||
| `properties` | string | Nein | Kommagetrennte Liste der zurückzugebenden Eigenschaften |
|
||
| `associations` | string | Nein | Kommagetrennte Liste der Objekttypen, für die zugehörige IDs abgerufen werden sollen |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `companies` | array | Array von HubSpot-Unternehmensobjekten |
|
||
| `paging` | object | Paginierungsinformationen |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_get_company`
|
||
|
||
Ruft ein einzelnes Unternehmen anhand der ID oder Domain von HubSpot ab
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `companyId` | string | Ja | Die ID oder Domain des abzurufenden Unternehmens |
|
||
| `idProperty` | string | Nein | Eigenschaft, die als eindeutiger Identifikator verwendet wird (z.B. "domain"). Falls nicht angegeben, wird die Datensatz-ID verwendet |
|
||
| `properties` | string | Nein | Kommagetrennte Liste der zurückzugebenden Eigenschaften |
|
||
| `associations` | string | Nein | Kommagetrennte Liste der Objekttypen, für die zugehörige IDs abgerufen werden sollen |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `company` | object | HubSpot-Unternehmensobjekt mit Eigenschaften |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_create_company`
|
||
|
||
Erstellt ein neues Unternehmen in HubSpot
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `properties` | object | Ja | Unternehmensdaten als JSON-Objekt (z.B. Name, Domain, Stadt, Branche) |
|
||
| `associations` | array | Nein | Array von Verknüpfungen, die mit dem Unternehmen erstellt werden sollen |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `company` | object | Erstelltes HubSpot-Unternehmensobjekt |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_update_company`
|
||
|
||
Aktualisiert ein bestehendes Unternehmen in HubSpot anhand der ID oder Domain
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `companyId` | string | Ja | Die ID oder Domain des zu aktualisierenden Unternehmens |
|
||
| `idProperty` | string | Nein | Eigenschaft, die als eindeutiger Identifikator verwendet wird (z.B. "domain"). Falls nicht angegeben, wird die Datensatz-ID verwendet |
|
||
| `properties` | object | Ja | Zu aktualisierende Unternehmensdaten als JSON-Objekt |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `company` | object | Aktualisiertes HubSpot-Unternehmensobjekt |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_search_companies`
|
||
|
||
Suche nach Unternehmen in HubSpot mit Filtern, Sortierung und Abfragen
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `filterGroups` | array | Nein | Array von Filtergruppen. Jede Gruppe enthält Filter mit propertyName, operator und value |
|
||
| `sorts` | array | Nein | Array von Sortierobjekten mit propertyName und direction ("ASCENDING" oder "DESCENDING") |
|
||
| `query` | string | Nein | Suchabfragestring |
|
||
| `properties` | array | Nein | Array von Eigenschaftsnamen, die zurückgegeben werden sollen |
|
||
| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse (max. 100) |
|
||
| `after` | string | Nein | Paginierungscursor für die nächste Seite |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `companies` | array | Array übereinstimmender HubSpot-Unternehmensobjekte |
|
||
| `total` | number | Gesamtzahl übereinstimmender Unternehmen |
|
||
| `paging` | object | Paginierungsinformationen |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
### `hubspot_list_deals`
|
||
|
||
Alle Deals vom HubSpot-Konto mit Paginierungsunterstützung abrufen
|
||
|
||
#### Eingabe
|
||
|
||
| Parameter | Typ | Erforderlich | Beschreibung |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `limit` | string | Nein | Maximale Anzahl von Ergebnissen pro Seite (max. 100, Standard 100) |
|
||
| `after` | string | Nein | Paginierungscursor für die nächste Ergebnisseite |
|
||
| `properties` | string | Nein | Kommagetrennte Liste der zurückzugebenden Eigenschaften |
|
||
| `associations` | string | Nein | Kommagetrennte Liste der Objekttypen, für die zugehörige IDs abgerufen werden sollen |
|
||
|
||
#### Ausgabe
|
||
|
||
| Parameter | Typ | Beschreibung |
|
||
| --------- | ---- | ----------- |
|
||
| `deals` | array | Array von HubSpot-Deal-Objekten |
|
||
| `paging` | object | Paginierungsinformationen |
|
||
| `metadata` | object | Operationsmetadaten |
|
||
| `success` | boolean | Erfolgsstatus der Operation |
|
||
|
||
## Hinweise
|
||
|
||
- Kategorie: `tools`
|
||
- Typ: `hubspot`
|