HubSpot

Verbindung von HubSpot mit Siesta AI

1. Wähle in Verbindungen Add Connection und wähle HubSpot.

2. Füge Private App token (API-Schlüssel) ein und wähle Shared oder Private.

3. Öffne in HubSpot Einstellungen -> Integrationen -> Private Apps und erstelle eine neue App.

4. Fülle die grundlegenden Informationen zur App aus.

5. Lege die erforderlichen Scopes für CRM-Objekte fest.

6. Kopiere im Tab Auth den Access token und verwende ihn in Siesta AI.

Übersicht

Diese Verbindung bietet eine standardisierte Schnittstelle zur Arbeit mit HubSpot CRM. Sie ermöglicht das Erstellen und Lesen grundlegender CRM-Entitäten: Unternehmen, Kontakte, Deals und Pipelines.

Die Integration ist als zustandslos, deterministisch und fail-fast konzipiert, geeignet für:

• CRM-Automatisierung
• Synchronisierung von Leads
• Orchestrierung von Verkaufs- und Umsatzpipelines
• Auditierbare Unternehmens-Workflows

Authentifizierung und Sicherheit

• Die Verbindung kommuniziert ausschließlich über die offizielle HubSpot API.
• Die Authentifizierung erfolgt auf der Ebene des HubSpot-Kontos (OAuth / Private App token).
• Keine sensiblen Daten werden protokolliert oder zwischengespeichert.
• Alle Operationen werden mit den in HubSpot zugewiesenen Berechtigungen ausgeführt.

Zugriffsrechte (Scopes) beeinflussen direkt die Verfügbarkeit von Operationen. Falsche Scopes führen zu einem Fehler.

Unterstützte Entitäten

• Unternehmen
• Kontakt
• Deal
• Pipeline

Jede Operation arbeitet mit internen HubSpot-IDs, nicht mit Namen.

1. Unternehmensoperationen

1.1 CreateCompany

Beschreibung
Erstellt ein neues Unternehmen im HubSpot CRM.

Eingabeparameter

Parameter	Typ	Pflicht	Beschreibung
name	String	Ja	Name des Unternehmens.
domain	String	Ja	Domain des Unternehmens (muss einzigartig sein).

Verhalten

• Wenn die Domain bereits existiert, schlägt die Operation fehl.
• Es wird kein Fuzzy-Matching oder Normalisierung der Domain durchgeführt.

Typische Verwendung

• Onboarding neuer Kunden
• Synchronisierung von Unternehmen aus externen Systemen

2. Kontaktoperationen

2.1 CreateContact

Beschreibung
Erstellt einen neuen Kontakt im HubSpot CRM.

Eingabeparameter

Parameter	Typ	Pflicht	Beschreibung
email	String	Ja	E-Mail des Kontakts (muss einzigartig sein).
firstName	String	Ja	Vorname.
lastName	String	Ja	Nachname.

Verhalten

• Die E-Mail dient als eindeutiger Identifikator.
• Doppelte E-Mail = schwerer Fehler.

2.2 GetContactByEmail

Beschreibung
Gibt einen Kontakt basierend auf der E-Mail-Adresse zurück.

Eingabeparameter

Parameter	Typ	Pflicht
email	String	Ja

2.3 GetContactById

Beschreibung
Gibt einen Kontakt anhand seiner eindeutigen HubSpot-ID zurück.

Eingabeparameter

Parameter	Typ	Pflicht
contactId	Int64	Ja

2.4 GetAllContacts

Beschreibung
Gibt eine Liste von Kontakten im HubSpot CRM zurück.

Eingabeparameter

Parameter	Typ	Pflicht	Beschreibung
limit	Int	Nein	Maximale Anzahl zurückgegebener Datensätze.

3. Deal-Operationen

3.1 CreateDeal

Beschreibung
Erstellt einen neuen Deal und weist ihn einem bestimmten Kontakt zu.

Eingabeparameter

Parameter	Typ	Pflicht	Beschreibung
dealName	String	Ja	Name des Deals.
contactId	String	Ja	Existierende Kontakt-ID.
pipelineId	Int64	Ja	ID der Pipeline (nicht der Name).
stageId	Int64	Ja	ID der Phase (nicht der Name).
amount	Int	Nein	Wert des Deals.

Verhalten

• Pipeline und Phase müssen existieren.
• Es erfolgt keine automatische Zuordnung von Namen zu IDs.
• Falsche Beziehungen = Fehler.

3.2 GetDealById

Beschreibung
Gibt die Details eines Deals anhand der ID zurück.

Eingabeparameter

Parameter	Typ	Pflicht
dealId	Int64	Ja

3.3 GetAllDeals

Beschreibung
Gibt eine Liste von Deals zurück.

Eingabeparameter

Parameter	Typ	Pflicht
limit	Int	Nein

4. Pipeline-Operationen

4.1 ListAllPipelines

Beschreibung
Gibt alle Pipelines einschließlich ihrer Phasen und entsprechenden IDs zurück.

Eingabeparameter
Keine.

Hinweis Dieser Schritt ist erforderlich, wenn du keine Deals blind erstellen möchtest.

5. Suchoperationen

5.1 SearchCompanies

Beschreibung
Durchsucht Unternehmen nach Namen.

Eingabeparameter

Parameter	Typ	Pflicht	Beschreibung
name	String	Nein	Name des Unternehmens (ohne Domain).

Einschränkungen

• Keine Domains, URLs oder E-Mails verwenden.
• Die Suche ist textbasiert, ohne Fuzzy-Matching.