Installationsanleitung für die Hubspot App

Die Einrichtung der Hubspot App umfasst einige technische Schritte, da es sich um eine Integrations-App handelt, die sowohl in Hubspot als auch in Zendesk konfiguriert werden muss. Damit die Integration reibungslos funktioniert, sind vorbereitende Maßnahmen auf Hubspot-Seite erforderlich, bevor die App in Ihrer Zendesk-Umgebung vollständig einsatzbereit ist.

1. Hubspot-Zugriffstoken abrufen

Zuerst benötigen Sie ein Access Token von Hubspot. Folgen Sie dazu dieser Anleitung im Hubspot Help Center: 👉 API-Aufrufe mit dem Zugriffstoken Ihrer App durchführen

Sobald Sie das Token erhalten haben, können Sie es im Installationsprozess der App in den Einstellungen einfügen.

Probleme bei der Einrichtung?
📧 Schreiben Sie uns an app-support@leafworks.de, falls es Schwierigkeiten beim Abrufen des Tokens gibt. Wir helfen gerne weiter.

2. Hubspot-Instanz-ID & Zendesk-Benutzerfeld hinzufügen

Um Zendesk mit Ihrer Hubspot-Umgebung zu verbinden:

Ihre Hubspot-Instanz-ID finden

Die Instanz-ID ist die 7-stellige Zahl in Ihrer Hubspot-URL, z. B.: https://app.hubspot.com/homepage/1234567). Kopieren Sie diese ID und fügen Sie sie in der App-Konfiguration ein.
 

Benutzerdefiniertes Feld in Zendesk erstellen

Erstellen Sie ein benutzerdefiniertes Benutzerfeld, um die Hubspot-Kontakt-ID pro Kontakt in Zendesk zu speichern.

So geht’s:

1. Gehen Sie zum Admin Center in Zendesk

2. Navigieren Sie zu: Personen → Konfiguration → Benutzerfelder

3. Klicken Sie oben rechts auf Feld hinzufügen

4. Erstellen Sie ein Textfeld, z. B. mit dem Namen „Hubspot Contact ID“

Dieses Feld wird später von der App automatisch befüllt, um Kontakte zwischen Zendesk und Hubspot abzugleichen.

View of user field in Admin Center	View of field in User Page of Ticket

3. Kontakt- und Unternehmensfelder definieren

Die App unterstützt die Anzeige beliebiger Kontakt- oder Unternehmensfelder aus Ihrem Hubspot-Konto.

📝 Wichtig: Verwenden Sie die internen Namen der Felder, nicht die sichtbaren Anzeigenamen.

Sie finden bzw. exportieren die Eigenschaftsnamen in Hubspot auf zwei Arten:

• Export-Methode:
  Nutzen Sie diese Anleitung, um alle Eigenschaften zu exportieren:
  👉 Alle Eigenschaften exportieren
   
• Manuelle Methode:
  Gehen Sie in Hubspot zu Einstellungen → Eigenschaften in Hubspot – dort finden Sie die (internen) Namen der Felder in der Übersicht.
  
  Sobald Sie die gewünschten Feldnamen haben, tragen Sie diese im Konfigurationsbereich der App in Zendesk ein.

4. App-Zugriff über Rollen & Gruppen steuern

Alle Leafworks-Apps unterstützen rollen- und gruppenbasierte Einschränkungen in Zendesk.

Um festzulegen, wer Zugriff auf die Hubspot App erhält:

• Definieren Sie die relevanten Rollen und Gruppen in Ihrer Zendesk-Instanz (z. B. Admins, Support-Agenten, Abrechnungs-Admins).

• Legen Sie in den App-Einstellungen fest, für wen die App sichtbar sein soll.

Brauchen Sie Hilfe?

Wenn Sie Fragen oder Anregungen zur Hubspot App haben, melden Sie sich gerne bei uns:
📧 app-support@leafworks.de
Oder nutzen Sie unser Kontaktformular