- Klicken Sie auf die Registerkarte Authentifizierung, um Ihre Client-ID und das Client-Geheimnis sowie die der App zugewiesenen Bereiche anzuzeigen. Sie benötigen diese Informationen beim Initiieren einer OAuth-Verknüpfung zwischen Ihrer App und HubSpot.
- Klicken Sie auf der Registerkarte Authentifizierung unten auf der Seite auf das Dropdown-Menü Bereiche, um neue Bereiche zu Ihrer App hinzuzufügen. Diese erforderlichen Bereiche müssen im
scope=-Parameter Ihrer Autorisierungs-URL berücksichtigt werden oder Benutzer erhalten einen Fehler, wenn Sie versuchen, Ihre App zu autorisieren. Weitere Informationen zum Erstellen Ihrer Autorisierungs-URL und zur Verwendung von Bereichen finden Sie in der OAuth-Dokumentation.
- Beachten Sie das Feld Weiterleitungs-URL. Dorthin gelangen Benutzer, nachdem Ihrer App Zugriff auf deren HubSpot-Account gewährt wurde. Wenn Sie keine Weiterleitungs-URL berücksichtigen, erhalten Benutzer einen Verbindungsfehler. Weiterleitungs-URLs müssen HTTPS verwenden, es sei denn, sie sind auf localhost.
Mit der erstellten App können Sie nun den Installationsprozess durchlaufen.
Die Installation einer App kann in zwei Schritte unterteilt werden: Autorisierung und Token-Generierung.
Ihre App mit einem Kunden-Account autorisieren
- Um Ihre App mit einem HubSpot-Account zu autorisieren, müssen Sie eine Autorisierungs-URL erstellen. Rufen Sie dazu die Client-ID für Ihre App ab und initiieren Sie den OAuth-Prozess.
- Wenn Ihre URL bereit ist, öffnen Sie sie in Ihrem BVrowser, um eine Liste aller Ihrer HubSpot-Accounts anzuzeigen. Dies ist auch, was Benutzer sehen, sobald Sie sie zu dieser URL weiterleiten.
- Wählen Sie den Account aus, in dem Sie Ihre App installieren möchten.
- Nachdem Sie einen Account ausgewählt haben, wird Ihnen eine Liste von Bereichen basierend auf den Parametern
&scope=und&optional_scope=, die Sie für die Autorisierungs-URL festgelegt haben, angezeigt.
- Klicken Sie auf Zugriff gewähren, um die Verknüpfung zu autorisieren.
- Nachdem Sie Zugriff gewährt haben, werden Sie basierend auf dem
&redirect_uri=-Parameter in der ursprünglichen Autorisierungs-URL weitergleitet und ein?code=-Parameter wird an die URL angehängt. Verwenden Sie diesen Code im nächsten Schritt, um ein Zugriffstoken zu generieren.
Die OAuth-Token für den erstmaligen Zugriff generieren
Um Ihre Token für den erstmaligen Zugriff und die Aktualisierung zu generieren, benötigen Sie den Code vom ?code=-Parameter der Autorisierungs-URL, redirect_url, die Client-ID und das Client-Geheimnis. Detaillierte Anweisungen finden Sie hier.
Nachdem Sie Ihre App autorisiert haben und die Token für den erstmaligen Zugriff generiert haben, ist die Installation abgeschlossen. Sie wird auf Ihrer Seite Verknüpfte Apps gelistet und Sie erhalten jetzt Anfragen zum Abrufen von Webhooks und CRM-Karten.
Sie können die ID einer öffentlichen App in Ihrem App-Entwickler-Account auf eine der folgenden Arten finden:
- Gehen Sie in Ihrem Entwickler-Account in der Hauptnavigationsleiste zu Apps und zeigen Sie dann die App-ID an, die unter dem Namen Ihrer App aufgeführt ist.
- Gehen Sie in Ihrem Entwickler-Account in der Hauptnavigationsleiste zu Apps und klicken Sie dann auf den Namen der App. Klicken Sie auf der Seite Grundlegende Informationen auf die Registerkarte Authentifizierung und zeigen Sie dann die App-ID an.
HubSpot protokolliert alle Anfragen, die an oder von einer verknüpften App vorgenommen werden, einschließlich eingehender Anfragen mithilfe eines OAuth-Zugriffstokens oder ausgehender Anfragen für Webhooks oder CRM-Karten.
So zeigen Sie dieses Anfrageprotokoll an:
- Gehen Sie in Ihrem Entwickler-Account in der Hauptnavigationsleiste zu Apps.
- Klicken Sie auf den Namen der App.
- Gehen Sie in der linken Seitenleiste zu Monitoring.
- Verwenden Sie die Registerkarten, um verschiedene Typen von Anfragen anzuzeigen, die an die oder von der App vorgenommen werden. Beim Anzeigen dieser Protokolle können Sie auf eine einzelne Anfrage klicken, um weitere Informationen zu dieser anzuzeigen, einschließlich:
- bei erfolgreichen Anfragen die Anfragemethode, der Pfad und die Uhrzeit der Anfrage.
- bei nicht erfolgreichen Anfragen zusätzliche Fehlerinformationen wie Antwort-Header und -Text.
Im Folgenden erfahren Sie mehr über die einzelnen Registerkarten der Seite Monitoring.
- API-Aufrufe: Die Registerkarte API-Aufrufe zeigt alle Anfragen an, die mithilfe eines OAuth-Zugriffstokens an Ihre App durchgeführt wurden. Es kann nach HTTP-Methode, Antwortcode, Zeitrahmen oder Anfrage-URL gefiltert werden.
- Webhooks: Die Registerkarte Webhooks zeigt HubSpot-Anfragen für alle Webhook-Abonnements Ihrer App an. Filtern Sie nach Antwort (einschließlich Timeouts und Verknüpfungsfehler), Status (Erfolg, erneuter Versuch wird vorgenommen oder Fehler), Abonnementtyp, Zeitrahmen, Versuch, Batch, Event oder Account-ID.
Wenn HubSpot-Benutzer eine App installieren, stimmen sie zu, dem Entwickler der App Zugriff auf seine Account-Daten zu gewähren. Die Identität und der Ruf des Entwicklers spielen jeweils eine wichtige Rolle bei der Entscheidung eines Benutzers, mit der Installation fortzufahren. Um die vollständige Zustimmung der Benutzer bei der Installation einer App zu gewährleisten, zeigt HubSpot auf dem App-Installationsbildschirm eine Meldung an, in der die Verifizierungsstufe der App und das Listing im App Marketplace angezeigt werden:
- Wenn eine App nicht über eine verifizierte Domain verfügt, zeigt HubSpot auf dem Installationsbildschirm ein Banner an, das besagt, dass die App nicht verifiziert wurde.
- Wenn die App über eine verifizierte Domain verfügt, aber nicht im App Marketplace gelistet ist, zeigt HubSpot die verifizierte Domain zusammen mit einem Banner auf dem Installationsbildschirm an, das besagt, dass die App nicht von HubSpot überprüft oder genehmigt wurde.
- Wenn eine App im App Marketplace gelistet wurde und den App-Überprüfungsprozess von HubSpot bestanden hat, zeigt HubSpot keines der oben genannten Banner an. Sie müssen die Domain nicht verifizieren, wenn Ihre App im App Marketplace gelistet ist.
Eine verifizierte Domain hinzufügen
Um eine verifizierte Domain zur App hinzuzufügen, müssen Sie zuerst die Domain zu den Einstellungen der App hinzufügen und dann einen TXT-Eintrag zu den DNS-Einstellungen der Domain hinzufügen:
- Gehen Sie in Ihrem App-Entwickler-Account zu Apps.
- Klicken Sie auf den Namen der App.
- Gehen Sie in der linken Seitenleiste zu Kontakt & Support.
- Geben Sie im Feld Unternehmensdomain Ihre Domain ein und klicken Sie dann auf Speichern. Unterhalb der Unternehmensdomain wird eine Meldung angezeigt, dass die Domain noch nicht verifiziert wurde.
- Klicken Sie auf Verifizieren, um den Verifizierungsvorgang zu starten.
- Bestätigen Sie im rechten Bereich, dass die Domain korrekt eingegeben wurde, und klicken Sie dann auf Weiter.
- Kopieren Sie den erforderlichen TXT-Eintragswert, indem Sie in der Spalte Wert auf Kopieren klicken.
- Erstellen Sie bei Ihrem DNS-Anbieter einen TXT-Eintrag mit dem kopierten Wert. Nachfolgend finden Sie Anweisungen für einige gängige DNS-Anbieter:
- Nachdem Sie Ihre DNS-Einstellungen aktualisiert haben, gehen Sie zurück zu HubSpot und klicken Sie im rechten Bereich auf Weiter. Die Aktualisierung von DNS-Einträgen kann bis zu 48 Stunden dauern, sodass HubSpot die Änderung möglicherweise nicht sofort erkennt. Sie können jederzeit zu diesem Bildschirm zurückkehren, indem Sie die Option Jetzt verifizieren auf der Seite mit den Einstellungen für Unternehmensdetails erneut auswählen.
- Nach der Verifizierung sehen Sie im Feld Unternehmensdomain eine Erfolgsstatusanzeige.
Zusätzliche Anmerkungen
- Um das weitere Eigentum an der Domain sicherzustellen, überprüft HubSpot weiterhin regelmäßig, ob der TXT-Eintrag vorhanden ist. Die Installationswarnung wird zurückgegeben, wenn der TXT-Eintrag entfernt oder geändert wird.
- Derzeit können Sie nur eine verifizierte Domain pro Entwickler-Account haben. Alle Apps in einem Account teilen die verifizierte Domain. Die Domain auf der Installationsseite verlinkt zu Ihrer Root-Domain.
- Wenn Sie Ihre verifizierte Domain löschen, erhalten alle Apps in Ihrem Entwickler-Account erneut die Installationswarnung. Sie können eine andere Domain verifizieren, der Vorgang dauert jedoch einige Stunden.