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 eurer Zendesk-Umgebung vollständig einsatzbereit ist.

1. Hubspot-Zugriffstoken abrufen

Zuerst benötigt ihr ein Access Token von HubSpot. Folgt dazu dieser Anleitung im HubSpot Help Center: 
👉 API-Aufrufe mit dem Zugriffstoken Ihrer App durchführen

Sobald ihr das Token erhalten habt, könnt ihr es während des Installationsprozesses in den App-Einstellungen einfügen.

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

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

Um Zendesk mit eurer HubSpot-Umgebung zu verbinden, benötigt ihr eure HubSpot-Instanz-ID und ein benutzerdefiniertes Benutzerfeld in Zendesk.

Hubspot-Instanz-ID finden

Die Instanz-ID ist die 7-stellige Zahl in eurer HubSpot-URL, zum Beispiel: https://app.hubspot.com/homepage/1234567). 

Kopiert diese ID und fügt sie in der App-Konfiguration ein.
 

Benutzerdefiniertes Feld in Zendesk erstellen

Erstellt ein benutzerdefiniertes Benutzerfeld, um die HubSpot-Kontakt-ID pro Kontakt in Zendesk zu speichern.

So geht ihr vor:

• Öffnet das Zendesk Admin Center.
• Navigiert zu Personen → Konfiguration → Benutzerfelder.
• Klickt oben rechts auf Feld hinzufügen.
• Erstellt ein Textfeld, zum Beispiel 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 eurem Hubspot-Konto.

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

Ihr könnt die Eigenschaftsnamen in HubSpot auf zwei Arten finden oder exportieren:

• Export-Methode:
  Nutzt diese HubSpot-Anleitung, um alle Eigenschaften zu exportieren.
  👉 Alle Eigenschaften exportieren
   
• Manuelle Methode:
  Geht in HubSpot zu Einstellungen → Eigenschaften. Dort findet ihr die internen Namen der Felder in der Übersicht.

Sobald ihr die gewünschten Feldnamen habt, tragt ihr sie 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:

• Definiert die relevanten Rollen und Gruppen in eurer Zendesk-Instanz, zum Beispiel Admins, Support-Agents oder Abrechnungs-Admins.
• Legt in den App-Einstellungen fest, für wen die App sichtbar sein soll.

Fragen?

Wir helfen euch gern weiter:

📧 E-Mail: app-support@leafworks.de
📝 Kontaktformular