HubSpot

​

Überblick

All-in-One-Plattform, die Marketing-, Vertriebs- und Kundenservice-Software integriert. Über die Langdock-Integration kannst du direkt aus deinen Chats auf HubSpot zugreifen und es verwalten.

​

Verfügbare Aktionen

​

Kontakt erstellen

hubspot.createContact

Erstellt einen neuen Kontakt in HubSpot Bestätigung erforderlich: Ja Parameter:

• additionalProperties (TEXT, Optional): Alle benutzerdefinierten Eigenschaften spezifisch für dein HubSpot-Konto
  • firstName (TEXT, Optional): Vorname des Kontakts
  • company (TEXT, Optional): Name des Unternehmens, für das der Kontakt arbeitet
  • zip (TEXT, Optional): Postleitzahl des Kontakts
  • jobtitle (TEXT, Optional): Jobbezeichnung des Kontakts
  • address (TEXT, Optional): Adresse des Kontakts
  • country (TEXT, Optional): Land des Kontakts
  • website (TEXT, Optional): Link zu einem persönlichen Profil des Kontakts oder des Unternehmens
  • leadStatus (TEXT, Optional): Aktueller Status eines Leads in der Sales Pipeline
  • email (TEXT, Required): E-Mail-Adresse des Kontakts
  • lastName (TEXT, Optional): Nachname des Kontakts
  • owner (TEXT, Optional): HubSpot-Besitzer-ID der verantwortlichen Person für diesen Kontakt
  • phone (TEXT, Optional): Telefonnummer des Kontakts
  • lifecycleStage (TEXT, Optional): Lifecycle-Stadium eines Kontakts oder Unternehmens
  • state (TEXT, Optional): Bundesland des Kontakts (innerhalb ihres Landes)
  • leadSource (TEXT, Optional): Die Quelle, aus der der Lead in HubSpot stammt
  • associations (TEXT, Optional): Verknüpfungen zwischen diesem Kontakt und anderen HubSpot-Objekten

Output: Gibt den erstellten Kontakt mit ID und allen spezifizierten Eigenschaften zurück

---

​

Unternehmen erstellen

hubspot.createCompany

Erstellt ein neues Unternehmen in HubSpot Bestätigung erforderlich: Ja Parameter:

• associations (TEXT, Optional): Verknüpfungen zu anderen Objekten (Kontakte, Meetings, Notizen, Deals etc.)
  • city (TEXT, Optional): Stadt, in der sich das Hauptbüro oder Hauptquartier des Unternehmens befindet
  • industry (TEXT, Optional): Sektor oder Branche, in der das Unternehmen tätig ist
  • address (TEXT, Optional): Straßenadresse des Hauptstandorts des Unternehmens
  • name (TEXT, Required): Unternehmensname
  • country (TEXT, Optional): Land, in dem das Unternehmen ansässig ist
  • domain (TEXT, Optional): Website-Domain des Unternehmens ohne Protokoll oder Pfade
  • additionalProperties (TEXT, Optional): Alle benutzerdefinierten Eigenschaften spezifisch für dein HubSpot-Konto
  • description (TEXT, Optional): Kurze Übersicht über das Unternehmen, seine Mission, Produkte oder Dienstleistungen
  • ownerId (TEXT, Optional): HubSpot-User-ID der Person, die für die Verwaltung dieses Unternehmensdatensatzes verantwortlich ist
  • website (TEXT, Optional): Vollständige URL der Unternehmens-Website
  • phone (TEXT, Optional): Hauptkontakt-Telefonnummer für das Unternehmen
  • state (TEXT, Optional): Bundesland, Provinz oder Region, in der das Unternehmen ansässig ist

Output: Gibt das erstellte Unternehmen mit ID und allen spezifizierten Eigenschaften zurück

---

​

Deal erstellen

hubspot.createDeal

Erstellt einen neuen Deal in HubSpot Bestätigung erforderlich: Ja Parameter:

• associatedObjects (MULTI_LINE_TEXT, Optional): Verknüpfungen zu anderen Objekten (Kontakte, Unternehmen, etc.)
  • closeDate (TEXT, Optional): Erwartetes Abschlussdatum des Deals (Format: ISO 8601)
  • additionalProperties (TEXT, Optional): Alle zusätzlichen benutzerdefinierten Eigenschaften, die du setzen möchtest
  • stage (TEXT, Optional): Stadium des Deals in der Pipeline
  • dealOwner (TEXT, Optional): User-ID des HubSpot-Nutzers, der für diesen Deal verantwortlich ist
  • amount (NUMBER, Optional): Geldwert des Deals
  • dealName (TEXT, Required): Name des Deals/der Gelegenheit
  • pipeline (TEXT, Required): Pipeline, zu der der Deal gehört
  • description (TEXT, Optional): Beschreibung des Deals

Output: Gibt den erstellten Deal mit ID und allen spezifizierten Eigenschaften zurück

---

​

Notiz erstellen

hubspot.createNote

Erstellt eine Notiz, die mit einem Objekt verknüpft werden kann Bestätigung erforderlich: Nein Parameter:

• ownerId (TEXT, Required): Besitzer-ID des HubSpot-Nutzers, der die Notiz erstellt
  • noteBody (TEXT, Required): Text für die Notiz
  • attachmentIds (TEXT, Optional): Falls du eine einzelne oder mehrere Anhänge an die Notiz anhängen möchtest
  • associations (TEXT, Required): Kommagetrennte Liste von Objekttyp- und ID-Paaren

Output: Gibt die erstellte Notiz mit ID und Verknüpfungsdetails zurück

---

​

Kontakt aktualisieren

hubspot.updateContact

Aktualisiert einen Kontakt in HubSpot Bestätigung erforderlich: Nein Parameter:

• properties (TEXT, Required): Eigenschaften, die beim HubSpot-Kontakt aktualisiert werden sollen (JSON-String)
  • contactId (TEXT, Required): ID des Kontakts, der aktualisiert werden soll

Output: Gibt den aktualisierten Kontakt mit neuen Eigenschaftswerten zurück

---

​

Unternehmen aktualisieren

hubspot.updateCompany

Aktualisiert ein Unternehmen in HubSpot Bestätigung erforderlich: Nein Parameter:

• companyId (TEXT, Optional): ID des Unternehmens, das aktualisiert werden soll
  • properties (TEXT, Optional): Properties-Parameter erwartet ein JSON-Objekt mit Unternehmenseigenschaftswerten zum Aktualisieren

Output: Gibt das aktualisierte Unternehmen mit neuen Eigenschaftswerten zurück

---

​

Deal aktualisieren

hubspot.updateDeal

Aktualisiert ein oder mehrere Felder eines bestehenden Deals Bestätigung erforderlich: Nein Parameter:

• properties (MULTI_LINE_TEXT, Required): Eigenschaften, die beim HubSpot-Deal aktualisiert werden sollen (JSON-String)
  • dealId (TEXT, Required): ID des Deals, der aktualisiert werden soll

Output: Gibt den aktualisierten Deal mit neuen Eigenschaftswerten zurück

---

​

Kontakt abrufen

hubspot.getContact

Ruft einen Kontakt über seine ID ab Bestätigung erforderlich: Nein Parameter:

• contactId (TEXT, Required): ID des abzurufenden Kontakts

Output: Gibt Kontaktdetails einschließlich aller Eigenschaften und Verknüpfungen zurück

---

​

Kontakt-Engagement abrufen

hubspot.getContactEngagement

Ruft Engagement-Informationen wie kürzliche Aktivitäten eines Kontakts ab Bestätigung erforderlich: Nein Parameter:

• id (TEXT, Required): ID des Objekts, von dem Engagement-Informationen abgerufen werden sollen

Output: Gibt Engagement-Informationen einschließlich kürzlicher Aktivitäten und Interaktionen zurück

---

​

Unternehmen abrufen

hubspot.getCompany

Ruft ein Unternehmen über seine ID ab Bestätigung erforderlich: Nein Parameter:

• companyId (TEXT, Required): ID des abzurufenden Unternehmens

Output: Gibt Unternehmensdetails einschließlich aller Eigenschaften und Verknüpfungen zurück

---

​

Deal abrufen

hubspot.getDeal

Ruft einen Deal über seine ID ab Bestätigung erforderlich: Nein Parameter:

• dealId (TEXT, Required): ID des abzurufenden Deals

Output: Gibt Deal-Details einschließlich aller Eigenschaften und Verknüpfungen zurück

---

​

Deal-Kontext abrufen

hubspot.getDealContext

Ruft alle erforderlichen Informationen zum benutzerdefinierten Deal-Objekt, verfügbaren Pipelines und mehr ab Bestätigung erforderlich: Nein Parameter: Keine Output: Gibt Deal-Kontextinformationen einschließlich verfügbarer Pipelines und benutzerdefinierter Eigenschaften zurück

---

​

Kontakt suchen

hubspot.findContact

Findet einen Kontakt durch Suchen Bestätigung erforderlich: Nein Parameter:

• limit (TEXT, Optional): Maximale Anzahl der Datensätze, die in einer einzelnen Anfrage zurückgegeben werden sollen
  • properties (TEXT, Optional): Gibt an, welche Kontakteigenschaften in der Antwort enthalten sein sollen
  • searchQuery (TEXT, Optional): Textstring für die Volltextsuche in allen durchsuchbaren Eigenschaften
  • filterGroups (TEXT, Optional): Ermöglicht es dir, komplexe Filterlogik zu erstellen, um Kontakt-Suchergebnisse einzugrenzen
  • sorts (TEXT, Optional): Definiert, wie Ergebnisse sortiert werden sollen

Output: Gibt Array von Kontakten zurück, die den Suchkriterien entsprechen

---

​

Unternehmen suchen

hubspot.findCompany

Findet ein Unternehmen durch Suchen Bestätigung erforderlich: Nein Parameter:

• searchQuery (TEXT, Optional): Textstring für die Volltextsuche in allen durchsuchbaren Eigenschaften
  • properties (TEXT, Optional): Gibt an, welche Unternehmenseigenschaften in der Antwort enthalten sein sollen
  • sorts (TEXT, Optional): Definiert, wie Unternehmens-Suchergebnisse sortiert werden sollen
  • limit (NUMBER, Optional): Maximale Anzahl der Datensätze, die in einer einzelnen Anfrage zurückgegeben werden sollen
  • filterGroups (TEXT, Optional): Ermöglicht es dir, komplexe Filterlogik zu erstellen, um Unternehmens-Suchergebnisse einzugrenzen

Output: Gibt Array von Unternehmen zurück, die den Suchkriterien entsprechen

---

​

Deal suchen

hubspot.findDeal

Findet einen Deal durch Suchen Bestätigung erforderlich: Nein Parameter:

• limit (NUMBER, Optional): Maximale Anzahl der Datensätze, die in einer einzelnen Anfrage zurückgegeben werden sollen
  • searchQuery (TEXT, Optional): Textstring für die Volltextsuche in allen durchsuchbaren Eigenschaften
  • filterGroups (TEXT, Optional): Ermöglicht es dir, komplexe Filterlogik zu erstellen, um Suchergebnisse einzugrenzen
  • properties (TEXT, Optional): Gibt an, welche Deal-Eigenschaften in der Antwort enthalten sein sollen
  • sorts (TEXT, Optional): Definiert, wie Ergebnisse sortiert werden sollen

Output: Gibt Array von Deals zurück, die den Suchkriterien entsprechen

---

​

HubSpot-Besitzer abrufen

hubspot.getHubSpotOwners

Ruft alle HubSpot-Besitzer/Nutzer mit optionalem Filtern nach E-Mail ab Bestätigung erforderlich: Nein Parameter:

• email (TEXT, Optional): Suche nach einem bestimmten Besitzer über seine E-Mail-Adresse
  • limit (NUMBER, Optional): Maximale Anzahl der abzurufenden Besitzer (Standard 100, Maximum 500)
  • includeInactive (BOOLEAN, Optional): Ob archivierte/inaktive Besitzer in den Ergebnissen enthalten sein sollen

Output: Gibt Array von Besitzern mit ihren IDs, E-Mails und anderen Details zurück

---

​

Aktuellen Nutzer-Kontext abrufen

hubspot.getCurrentUserContext

Ruft die E-Mail des aktuellen Nutzers, die hubspot_owner_id und andere wichtige Informationen ab Bestätigung erforderlich: Nein Parameter: Keine Output: Gibt aktuellen Nutzer-Kontext einschließlich E-Mail und Besitzer-ID zurück

---

​

Häufige Anwendungsfälle

​

Best Practices

​

Fehlerbehebung

Problem	Lösung
Authentifizierung fehlgeschlagen	Überprüfe deine OAuth-Anmeldedaten
Rate Limit überschritten	Reduziere die Anfragehäufigkeit
Daten nicht gefunden	Prüfe Berechtigungen und Datenverfügbarkeit
Verbindungstimeout	Überprüfe die Netzwerkverbindung

​

Support

Für zusätzliche Hilfe mit der HubSpot-Integration kontaktiere support@langdock.com