Was ist ein Zugriffstoken für die HubSpot-Verbindung?
Der Zugriffstoken ist das Zugangsmerkmal, mit dem snapAddy im Rahmen der Systemintegration auf HubSpot zugreifen darf. Bei einer geteilten CRM-Verbindung auf Organisationsebene erstellen Sie diesen Zugriffstoken selbst in HubSpot und hinterlegen ihn in snapAddy.
HubSpot stellt für diesen Zugriffstoken zwei Varianten bereit. Der Service-Schlüssel (englisch: Service Key) ist die neuere, empfohlene Variante für System-zu-System-Integrationen. Die private App bleibt als bisheriger Weg nutzbar, HubSpot hat den Menüpunkt Private Apps jedoch in Alte Apps (englisch: Legacy Apps) umbenannt. Der Zugriffstoken wird gelegentlich auch als HubSpot API-Schlüssel oder API key bezeichnet.
Welche Voraussetzungen gelten für einen Service-Schlüssel?
Für das Erstellen eines Service-Schlüssels benötigen Sie in HubSpot Super-Admin-Rechte oder Zugriff auf die Entwicklerwerkzeuge. Ein Service-Schlüssel kann außerdem nur die Bereiche erhalten, über die der erstellende Benutzer selbst bereits verfügt.
Hinweis: Service-Schlüssel befinden sich bei HubSpot in der Public Beta und sind im Menü mit dem Kennzeichen BETA versehen. Bezeichnungen und Optionen können sich daher noch ändern.
Wie erstelle ich einen Service-Schlüssel in HubSpot?
Sie erstellen einen Service-Schlüssel in HubSpot über Entwicklung > Schlüssel > Service-Schlüssel und die Schaltfläche Neuen Service-Schlüssel erstellen. Alternativ erreichen Sie dieselbe Übersicht über Einstellungen > Integrationen > Service-Schlüssel.
1. Melden Sie sich bei Ihrem HubSpot-Konto an und öffnen Sie über die linke Symbolleiste den Bereich Entwicklung.
2. Klappen Sie in der Seitenleiste den Eintrag Schlüssel auf.
3. Wählen Sie Service-Schlüssel.
4. Klicken Sie oben rechts auf Neuen Service-Schlüssel erstellen.
5. Vergeben Sie unter Name einen sprechenden Namen, zum Beispiel snapAddy. Dieser Name wird in HubSpot-Tools wie den Protokollen angezeigt und muss im Account eindeutig sein.
6. Fügen Sie unter Bereiche über Neuen Bereich hinzufügen die von snapAddy benötigten Bereiche hinzu.
7. Klicken Sie oben rechts auf Erstellen.
8. Öffnen Sie den neuen Service-Schlüssel über seinen Namen. Der Schlüssel ist aus Sicherheitsgründen verdeckt. Klicken Sie auf Anzeigen, um ihn sichtbar zu machen, und anschließend auf Kopieren.
Welche Bereiche (Scopes) benötigt snapAddy?
Für die Verbindung zwischen snapAddy und HubSpot benötigt der Zugriffstoken die folgenden fünf Bereiche:
crm.objects.companies.read
crm.objects.companies.write
crm.objects.contacts.read
crm.objects.contacts.write
files
Diese fünf Bereiche gelten sowohl für den Service-Schlüssel als auch für die private App.
Wie hinterlege ich den Zugriffstoken in snapAddy?
Sie fügen den kopierten Zugriffstoken in den HubSpot-Verbindungseinstellungen in den Organisationseinstellungen von snapAddy ein und speichern die Eingabe. Danach ist die Systemintegration zwischen snapAddy und HubSpot aktiv.
Wie erstelle ich einen Zugriffstoken über eine private App?
Der Weg über eine private App bleibt als Alternative verfügbar. HubSpot hat den Menüpunkt Private Apps jedoch in Alte Apps umbenannt. Sie finden private Apps deshalb im Bereich Entwicklung unter Alte Apps. Für neue Verbindungen empfiehlt sich der Service-Schlüssel.
Umbenennung: Falls Sie den Menüpunkt Private Apps in HubSpot nicht mehr finden, suchen Sie nach Alte Apps (englisch: Legacy Apps). Bestehende private Apps und die damit erzeugten Zugriffstoken bleiben gültig. Ein Abschalttermin ist von HubSpot bislang nicht angekündigt.
1. Melden Sie sich bei Ihrem HubSpot-Konto an.
2. Öffnen Sie den Bereich Entwicklung und wählen Sie Alte Apps, früher Private Apps.
3. Klicken Sie auf Erstellen und wählen Sie Privat.
4. Wählen Sie einen Namen. Dieser wird auf den angelegten Datensätzen als Detaillierte Infos zur [...] Quelle - 2 angezeigt.
5. Wählen Sie im Reiter Bereiche die fünf oben genannten Scopes aus.
6. Klicken Sie anschließend oben rechts auf App erstellen.
7. Kopieren Sie den Zugriffstoken und fügen Sie ihn in den Organisationseinstellungen ein.
Welche Fragen stellen sich häufig im Anschluss?
Wie verbinde ich snapAddy insgesamt mit HubSpot?
Die vollständige Einrichtung der HubSpot-Verbindung für snapAddy LeadResearch und VisitReport ist in einem eigenen Artikel beschrieben: snapAddy Verbindung zu HubSpot.
Wie richte ich eine geteilte CRM-Verbindung für HubSpot in DataAgents ein?
Mit einer geteilten CRM-Verbindung nutzen mehrere Benutzer denselben HubSpot-Zugang. Die Konfiguration erklärt der Artikel Wie man DataAgents konfiguriert, um gemeinsame CRM-Verbindungen für HubSpot zu nutzen.
Welche bekannten Lösungen gibt es für HubSpot?
Häufige Stolpersteine der HubSpot-Anbindung und die passenden Lösungen sind gesammelt unter Bekannte Lösungen für HubSpot.
Falls Sie noch Fragen haben, kontaktieren Sie gerne support@snapaddy.com oder Ihren Customer Success Manager.