Zum Hauptinhalt springen

HubSpot-Integration - Einrichtungsanleitung

Verbinde dein HubSpot-Konto mit Goodweek, um CRM-Kontakte, Unternehmen, Deals und Marketingdaten direkt aus deinem KI-Arbeitsbereich zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein HubSpot-Konto mit Goodweek, um CRM-Kontakte, Unternehmen, Deals und Marketingdaten direkt aus deinem KI-Arbeitsbereich zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die dem Nutzer in HubSpot gewährten Zugriffsrechte und stellt so sicher, dass die Governance-Richtlinien deiner Organisation eingehalten werden. Ergebnisse und verfügbare Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff jedes Nutzers variieren.

📋 Voraussetzungen

Bevor ein Nutzer die HubSpot-Integration sehen und verbinden kann, muss dein Organisationsadministrator sie zunächst im Goodweek-Admin-Panel im Tab „Integrationen“ aktivieren.

Admin-Einrichtung

Die HubSpot-Integration verwendet OAuth 2.0. Der verbindende Nutzer muss über die Berechtigung Super Admin in HubSpot oder App Marketplace-Zugriff. Standardnutzer ohne diese Berechtigungen sehen die Fehlermeldung „Vous ne disposez pas des autorisations nécessaires pour installer Composio“ (oder das Äquivalent in deiner Sprache).

So gewährst du App Marketplace-Zugriff in HubSpot

Ein HubSpot-Super-Admin kann einem Nutzer App Marketplace-Zugriff gewähren, ohne ihn zum Super Admin zu machen:

  1. Gehe in HubSpot zu Einstellungen → Nutzer & Teams.

  2. Wähle den Nutzer aus und gehe dann zu Berechtigungen.

  3. Aktiviere unter „Konto“ den App Marketplace-Zugriff.

  4. Klicke auf Speichern.

Nutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche HubSpot und klicke auf Verbinden.

  3. Du wirst zu HubSpot weitergeleitet, wo du dich anmelden und den Zugriff autorisieren musst.

  4. Klicke auf App verbinden, um den Zugriff zu gewähren und zu Goodweek zurückzukehren.

Wichtige Hinweise

  • Jeder Nutzer muss sein eigenes Konto individuell verbinden.

  • Goodweek kann nur auf die HubSpot-Daten zugreifen, für die dein individuelles Nutzerkonto Zugriffsrechte hat. Die Sichtbarkeit von CRM-Datensätzen, Pipelines und Marketingdaten in Goodweek entspricht deinen HubSpot-Berechtigungen.

  • Du kannst den Zugriff von Goodweek jederzeit über HubSpot → Einstellungen → Integrationen → Verbundene Apps → Composio → Deinstallieren widerrufen.


Verfügbare Tools

Tool

Beschreibung

Typ

Get Account Information

Ruft Details zum verbundenen HubSpot-Konto ab, einschließlich Portal-ID und Einstellungen.

Lesen

Create Contact

Erstellt einen neuen Kontaktdatensatz im HubSpot-CRM.

Schreiben

Archive Contact

Archiviert (soft-delete) einen HubSpot-Kontaktdatensatz.

Schreiben

Search Contacts

Durchsucht HubSpot-Kontakte mithilfe von Filtern und eigenschaftsbasierten Abfragen.

Lesen

Batch Read Contacts

Ruft mehrere Kontaktdatensätze anhand von ID oder eindeutiger Eigenschaft in einer einzigen Anfrage ab.

Lesen

Create Company

Erstellt einen neuen Unternehmensdatensatz im HubSpot-CRM.

Schreiben

Archive Company

Archiviert einen HubSpot-Unternehmensdatensatz.

Schreiben

Search Companies

Durchsucht HubSpot-Unternehmen mithilfe von Filtern und eigenschaftsbasierten Abfragen.

Lesen

Batch Read Companies by Properties

Ruft mehrere Unternehmensdatensätze anhand von Eigenschaften in einer einzigen Anfrage ab.

Lesen

Create Deal

Erstellt einen neuen Deal in einer HubSpot-Vertriebspipeline.

Schreiben

Archive Deal

Archiviert einen HubSpot-Deal-Datensatz.

Schreiben

Search Deals

Durchsucht HubSpot-Deals mithilfe von Filtern und eigenschaftsbasierten Abfragen.

Lesen

Create Meeting

Erstellt einen neuen Meeting-Datensatz, der mit CRM-Kontakten oder -Unternehmen verknüpft ist.

Schreiben

Create Note

Erstellt eine neue Notiz, die einem CRM-Datensatz (Kontakt, Unternehmen oder Deal) zugeordnet ist.

Schreiben

Create Call

Erstellt einen Anrufprotokolleintrag, der einem CRM-Datensatz zugeordnet ist.

Schreiben

Create Task

Erstellt eine neue CRM-Aufgabe, die einem Kontakt, Unternehmen oder Deal zugeordnet ist.

Schreiben

Add Asset Association

Erstellt eine Verknüpfung zwischen zwei HubSpot-CRM-Objekten (z. B. Kontakt zu Unternehmen).

Schreiben

Get Pipeline by ID

Ruft Details zu einer bestimmten HubSpot-CRM-Pipeline ab.

Lesen

Get Pipelines

Listet alle Pipelines für einen angegebenen CRM-Objekttyp auf.

Lesen

Get Pipeline Stage by ID

Ruft Details zu einer bestimmten Phase innerhalb einer HubSpot-Pipeline ab.

Lesen

Get All Marketing Emails

Listet alle Marketing-E-Mails für ein HubSpot-Konto auf.

Lesen

Get Campaign

Ruft Details zu einer bestimmten HubSpot-Marketingkampagne ab.

Lesen

Get Campaigns

Listet die Marketingkampagnen eines HubSpot-Kontos auf.

Lesen

Get Campaign Metrics

Ruft Engagement-Metriken für eine bestimmte HubSpot-Kampagne ab.

Lesen

Get Aggregated Statistics

Ruft aggregierte Leistungsstatistiken über HubSpot-Marketing-Assets hinweg ab.

Lesen

Get Revenue

Ruft Umsatzdaten ab, die mit Deals in HubSpot verknüpft sind.

Lesen

Search CRM Objects

Durchsucht jeden HubSpot-CRM-Objekttyp mithilfe von Filtern und Eigenschaftsabfragen.

Lesen

Archive Batch of Objects

Archiviert einen Stapel von HubSpot-CRM-Objekten anhand der ID in einer einzigen Anfrage.

Schreiben

Permanently Delete Contact (GDPR)

Löscht einen HubSpot-Kontakt zur DSGVO-Konformität dauerhaft. Diese Aktion ist unumkehrbar.

⚠️ Destruktiv

Permanently Delete Company (GDPR)

Löscht einen HubSpot-Unternehmensdatensatz zur DSGVO-Konformität dauerhaft. Diese Aktion ist unumkehrbar.

⚠️ Destruktiv

Delete Pipeline

Löscht eine HubSpot-CRM-Pipeline dauerhaft.

⚠️ Destruktiv

Delete Marketing Email

Löscht eine HubSpot-Marketing-E-Mail dauerhaft.

⚠️ Destruktiv

Anwendungsfälle

  • CRM-Datensätze direkt aus Unterhaltungen erstellen und aktualisieren. Füge neue Kontakte, Unternehmen oder Deals direkt aus einer Goodweek-Unterhaltung zu HubSpot hinzu – einschließlich Verknüpfungen zwischen Datensätzen – ohne im CRM navigieren zu müssen.

  • CRM-Daten bei Bedarf suchen und abrufen. Frage Kontakte, Unternehmen oder Deals nach Eigenschaftswerten direkt in Goodweek ab, um bestimmte Datensätze zur Prüfung oder Nachverfolgung anzuzeigen, ohne HubSpot zu öffnen.

  • Meetings, Anrufe und Notizen zu Datensätzen protokollieren. Erfasse ein Anrufprotokoll, eine Meeting-Notiz oder eine Aufgabe für einen bestimmten Kontakt oder Deal direkt in Goodweek nach einer Interaktion und halte so die CRM-Datensätze aktuell.

  • Pipeline- und Kampagnenleistung überprüfen. Rufe Pipeline-Phasen, Deal-Anzahlen, Kampagnenmetriken oder Umsatzdaten aus HubSpot direkt in einer Goodweek-Unterhaltung ab, um eine schnelle Leistungsübersicht zu erhalten.


Fehlerbehebung

Fehler „You do not have the necessary permissions to install Composio“

Der verbindende Nutzer verfügt weder über Super-Admin- noch über App-Marketplace-Zugriffsrechte in HubSpot. Ein HubSpot-Super-Admin muss den App-Marketplace-Zugriff wie im Abschnitt Admin-Einrichtung oben beschrieben gewähren.

Integration in Goodweek nicht sichtbar

Stelle sicher, dass dein Organisationsadministrator die HubSpot-Integration im Goodweek-Admin-Panel im Tab „Integrationen“ aktiviert hat.

Referenzen

Hat dies deine Frage beantwortet?