Erstellen von Apps – Übersicht
Mit Apps können Sie API-Aufrufe für Ihren HubSpot-Account authentifizieren, Events mit Webhooks abonnieren und die HubSpot-UI erweitern, z. B. mit benutzerdefinierten Karten. HubSpot bietet je nach den Anforderungen Ihrer Integration verschiedene Typen von Apps und Erweiterungen an. Im Folgenden erfahren Sie mehr über die Typen von Apps und Erweiterungen, die Sie mit HubSpot erstellen können, wie Sie mit der Erstellung beginnen und wie Sie sie in HubSpot verwalten.
Je nach Art der Integration, die Sie erstellen möchten, müssen Sie den richtigen App-Typ auswählen. Im Folgenden erfahren Sie mehr über die Typen von Apps, die Sie erstellen können, und die Funktionen, die sie unterstützen.
Für um Erstellen von Erweiterungen finden Sie in der folgenden Referenztabelle eine kurze Übersicht darüber, welche Erweiterungen mit welchen Typen von Apps erstellt werden können.
Private Apps können für einen einzelnen HubSpot-Account erstellt werden und eignen sich am besten für einmalige Skripts oder Einzelfallerweiterungen. Sie können beispielsweise eine private App für Ihren HubSpot-Account erstellen, um:
- Ein neues benutzerdefiniertes Objekt über die API zu erstellen.
- CRM-Datensätze von einer CSV-Datei zu importieren.
- API-Anfragen in benutzerdefinierten Automatisierungsaktionen und Chat-Bots zu authentifizieren.
- Webhook-Abonnements zu erstellen und zu bearbeiten.
Im Allgemeinen sind private Apps einfacher zu implementieren als öffentliche Apps. Private Apps authentifizieren sich über Zugriffstoken und können nicht im HubSpot App Marketplace gelistet werden. Erfahren Sie mehr darüber, wann Sie private Apps erstellen sollten.
Wenn diese Art von App Ihren Anforderungen entspricht, erstellen Sie eine private App in Ihrem HubSpot-Account.
Private Apps, die in Projekten erstellt wurden, ermöglichen es Ihnen, UI-Erweiterungen in CRM-Datensätzen zu erstellen. Der Unterschied beim Erstellen einer privaten App mit dieser Methode besteht darin, dass Projekte nur das Erstellen von UI-Erweiterungen unterstützen, die private Apps außerhalb von Projekten nicht erstellen können.
Wenn diese Art von App Ihren Anforderungen entspricht, lesen Sie sich die Schnellanleitung zu Projekten durch, um mit der Erstellung einer privaten App und eines Projekts mithilfe des CLI zu beginnen.
Öffentliche Apps können in mehreren Accounts installiert werden. Neben den Typen von Erweiterungen, die Sie mit einer privaten App erstellen können, unterstützen öffentliche Apps erweiterte Funktionen, z. B.:
- Account-übergreifende Events mithilfe der Webhooks-API abonnieren.
- Benutzerdefinierte Chronik-Events in CRM-Datensätzen mithilfe der Chronik-Events-API erstellen.
- Benutzerdefinierte App-Einstellungsseiten in HubSpot erstellen.
Öffentliche Apps authentifizieren sich über OAuth und können im HubSpot App Marketplace gelistet werden. Erfahren Sie mehr darüber, wann Sie öffentliche Apps erstellen sollten.
Wenn dieser Ap-Typ Ihren Bedürfnissen entspricht, erstellen Sie eine öffentliche App in Ihrem App-Entwickler-Account.
App-Typ | Unterstützte Erweiterungen |
---|---|
Private App | |
Öffentliche App |
|
Private App mit Projekten erstellt (BETA) |
App-Entwickler- und Test-Accounts arbeiten zwar zusammen, dienen jedoch einem jeweils anderen Zweck.
- App-Entwickler-Accounts dienen zum Erstellen und Listen von Apps im App Marketplace.
- In Test-Accounts können Sie die APIs und Apps, die Sie erstellen, testen, ohne die Daten in einem echten HubSpot-Account zu beeinträchtigen. Dies ist getrennt von einem Sandbox-Account, den Sie innerhalb von Standard-HubSpot-Accounts erstellen können.
Erfahren Sie mehr über die Account-Typen von HubSpot.
Wenn Sie eine benutzerdefinierte Integration mit einem einzelnen HubSpot-Account erstellen möchten, können Sie eine private App erstellen und deren Zugriffstoken zum Authentifizieren von API-Aufrufen verwenden oder Sie können OAuth mit einer öffentlichen App verwenden. Jede App, die für die Installation durch mehrere HubSpot-Accounts oder für ein Listing im App Marketplace entwickelt wurde, muss OAuth verwenden.
Bitte beachten: seit dem 30. November 2022 sind HubSpot-API-Schlüssel veraltet und werden nicht mehr unterstützt. Die fortgesetzte Verwendung von HubSpot API-Schlüsseln stellt ein Sicherheitsrisiko für Ihren Account und Ihre Daten dar. Während dieser Phase bis zur endgültigen Einstellung kann HubSpot Ihren Schlüssel jederzeit deaktivieren.
Sie sollten sich stattdessen mit einem Zugriffstoken für private Apps oder über OAuth authentifizieren. Erfahren Sie mehr über diese Änderung und wie Sie eine API-Schlüssel-Integration migrieren, um stattdessen eine private App zu verwenden.
Wenn Sie Webhooks abonnieren oder OAuth für Ihre App einrichten möchten, sollten Sie einen Entwickler-Account erstellen. Mit Entwickler-Accounts können Sie außerdem Ihre Apps im App Marketplace listen oder einen Test-Account erstellen.
API-Schlüssel für Entwickler-Accounts
Um Ihre App-Einstellungen über die API zu verwalten, können Sie einen Entwickler-API-Schlüssel verwenden. Dieser API-Schlüssel ist getrennt von Standard-API-Schlüsseln, die veraltet sind. App-Entwickler-Schlüssel können für das Verwalten von Abonnements für die Webhooks-API und das Erstellen oder Aktualisieren von Event-Typen für das Chronik-Events-Feature verwendet werden. Alle anderen API-Aufrufe müssen mit dem Zugriffstoken einer privaten App oder OAuth vorgenommen werden.
So greifen Sie auf den API-Schlüssel Ihres App-Entwickler-Accounts zu:
- Gehen Sie in Ihrem App-Entwickler-Account in der oberen Navigationsleiste zu Apps.
- Klicken Sie oben rechts auf HubSpot-API-Schlüssel abrufen.
- Klicken Sie im Dialogfeld auf Schlüssel anzeigen. Der Schlüssel wird offengelegt, und Sie können dann neben dem Schlüssel auf Kopieren klicken.
- Sie können auch den vorherigen API-Schlüssel deaktivieren und einen neuen generieren, indem Sie auf Schlüssel neu generieren klicken.
Sie können API-Entwickler-Accounts löschen, wenn sie keine Apps mit Installationen oder aktiven Marketplace-Listings enthalten. Wenn Ihr Account über Apps mit Installationen oder aktiven Marketplace-Listings verfügt und Sie Ihren Account löschen möchten, wenden Sie sich bitte an den Support.
Nachdem Sie Ihren Account gelöscht haben, können Sie nicht mehr auf diesen Account zugreifen. Wenn Sie zwischen mehreren HubSpot-Accounts wechseln können, wird der gelöschte Account nicht mehr angezeigt.
Klicken Sie in Ihrem HubSpot-API-Entwickler-Account oben rechts auf Ihren Account-Namen und klicken Sie dann auf Account.
Klicken Sie auf Account löschen. Wenn Ihr Account über Apps mit Installationen oder aktiven Marketplace-Listings verfügt, wird diese Schaltfläche deaktiviert.
Geben Sie im Dialogfeld Ihre Account-ID ein und klicken Sie auf Entwickler-Account löschen