Die meisten Probleme mit der HubSpot-Verbindung zeigen sich an einer von drei Stellen: im Feld Verbindungsstatus unter Einstellungen, dann Integrationen, auf der Installationsseite oder im Verlauf des HubSpot-Workflows, der einen MemberArea-Schritt ausgeführt hat. Dieser Artikel geht sie in dieser Reihenfolge durch.
Das Feld zum Verbindungsstatus
Öffnen Sie Einstellungen, dann Integrationen, und klicken Sie auf die HubSpot-Zeile. Der Dialog zeigt das Feld Verbindungsstatus mit einem Badge für den Zustand der Verbindung.
| Badge | Was er bedeutet | Was zu tun ist |
|---|---|---|
| Aktiv | HubSpot hat geantwortet, und der Zugriff, den MemberArea hält, ist gültig | Nichts |
| Neu verbinden nötig | HubSpot akzeptiert diesen Zugriff nicht mehr, zum Beispiel weil die App in HubSpot entfernt wurde | Klicken Sie im Feld auf Erneut verbinden |
| Falsches Portal | Der Zugriff antwortet für ein anderes HubSpot-Konto als das hier gespeicherte | Klicken Sie im Feld auf Erneut verbinden |
| Nicht erreichbar | HubSpot hat auf die Prüfung nicht geantwortet | Klicken Sie gleich noch einmal auf Erneut prüfen |
Unter dem Badge nennt das Feld das verbundene Konto und seine Portal-ID und listet dann jede Berechtigung auf, die das Konto erteilt hat. Darunter können diese Hinweise erscheinen:
- Die HubSpot-Verbindung ist abgelaufen: HubSpot akzeptiert den Zugriff, den MemberArea hält, nicht mehr. Kontakte werden nicht abgeglichen, und die MemberArea-Schritte in Ihren Workflows laufen nicht, bis Sie neu verbinden.
- Es fehlen Berechtigungen: Eine nötige Berechtigung fehlt, und der Hinweis nennt jede einzelne. Teile des Abgleichs bleiben aus, bis Sie neu verbinden und die angefragten Berechtigungen bestätigen.
- Workflow-Aktionen sind aus: Die optionale Berechtigung für die Automatisierung wurde nicht erteilt, deshalb erscheinen die MemberArea-Schritte nicht in Ihren HubSpot-Workflows. Alles andere funktioniert weiter.
Jeder dieser Hinweise hat eine Schaltfläche Erneut verbinden. HubSpot fragt die Berechtigungen erneut ab, und Sie kommen zurück zu Integrationen.
Das Ergebnis wird 15 Minuten aufbewahrt, deshalb zeigt die Zeile unten im Feld meist die Uhrzeit der letzten Prüfung. Erneut prüfen fragt HubSpot sofort. Drei frische Prüfungen pro Minute sind erlaubt. Danach meldet das Feld Gerade eben geprüft, angezeigt wird das letzte Ergebnis.
Wurde die Verbindung unterbrochen, steht die HubSpot-Zeile in Integrationen auf Getrennt, und der Dialog meldet Diese Verbindung wurde unterbrochen. Verbinden Sie sie erneut, damit die Daten synchron bleiben. Klicken Sie dort auf Erneut verbinden. Nichts, was HubSpot schon erreicht hat, geht verloren.
"Das Konto konnte nicht verbunden werden."
Dieser rote Hinweis erscheint oben auf Integrationen, wenn Sie ohne Verbindung von HubSpot zurückkommen. Die Zeile darunter nennt den Grund:
| Grund | Was zu tun ist |
|---|---|
| HubSpot authorisation was cancelled. | Der HubSpot-Dialog wurde geschlossen oder abgelehnt. Verbinden Sie erneut und bestätigen Sie ihn. |
| HubSpot account … is already connected to another MemberArea business. | Ein HubSpot-Konto gehört zu einem Workspace. Trennen Sie es zuerst im anderen Workspace. |
| HubSpot did not tell us which account was connected. | Verbinden Sie erneut und wählen Sie im HubSpot-Dialog ein Konto. |
| Missing OAuth state or code. | HubSpot hat Sie ohne Ergebnis zurückgeschickt. Verbinden Sie erneut. |
| HubSpot did not return an access token. | HubSpot hat die Verbindung nicht abgeschlossen. Verbinden Sie gleich noch einmal. |
Vergehen im HubSpot-Dialog mehr als 15 Minuten, landen Sie stattdessen auf der Liste Ihrer Workspaces, und nichts ist verbunden. Öffnen Sie Ihren Workspace und verbinden Sie erneut.
Auf der Installationsseite
Diese Meldungen erscheinen, wenn Sie die App über einen Installationslink installieren.
"Dieser Installationslink ist nicht mehr gültig. Links bleiben 15 Minuten offen." Mehr als 15 Minuten sind vergangen, oder Sie haben die Seite in einem anderen Browser geöffnet als dem, in dem Sie die Installation begonnen haben. Der Link funktioniert nur in dem Browser, der durch den HubSpot-Dialog gegangen ist. Öffnen Sie den Installationslink erneut in einem Browser und schließen Sie ihn dort ab.
"Dieses HubSpot-Konto ist bereits verbunden": Das Konto gehört zu einem Workspace, auf den Sie keinen Zugriff haben. Bitten Sie den Inhaber dieses Workspace, es dort zu trennen.
"HubSpot account … is already connected to another MemberArea workspace.": Das Konto gehört zu einem anderen Ihrer Workspaces. Trennen Sie es zuerst in diesem Workspace und installieren Sie dann erneut.
"Confirm that HubSpot account … may be disconnected before this one takes its place.": Der gewählte Workspace hat bereits ein anderes HubSpot-Konto. Haken Sie Aktuelles Konto ersetzen an, um es auszutauschen, oder wählen Sie einen anderen Workspace.
"Erstellen Sie einen Workspace, um die Installation abzuschließen": Ihr Konto hat noch keinen Workspace. Klicken Sie auf Workspace erstellen und öffnen Sie dann den Installationslink erneut.
Ein HubSpot-Schritt in einer Automation ist fehlgeschlagen
Öffnen Sie die Automation und sehen Sie in ihre Durchläufe. Ein Durchlauf mit einem fehlgeschlagenen HubSpot-Schritt steht auf Fehlgeschlagen und nennt den Grund:
| Grund | Was zu tun ist |
|---|---|
| Bei diesem Schritt ist keine HubSpot-Verbindung ausgewählt. Wählen Sie eine im Editor aus. | Öffnen Sie den Schritt und wählen Sie die Verbindung unter Integration. |
| Die HubSpot-Verbindung ist abgelaufen. | Klicken Sie unter Einstellungen, dann Integrationen auf Erneut verbinden. |
| HubSpot hat den Kontakt nicht angenommen. | Prüfen Sie die E-Mail-Adresse des Mitglieds und die Berechtigungen im Verbindungsstatus. Prüfen Sie bei Kontakteigenschaft setzen, ob der Wert zur Eigenschaft passt, zum Beispiel der interne Wert einer Dropdown-Option. |
| HubSpot hat den Kontakt nicht zur Liste hinzugefügt. | Prüfen Sie, ob die Liste in HubSpot noch existiert und eine statische Liste ist. |
| HubSpot hat den Kontakt nicht von der Liste entfernt. | Prüfen Sie, ob die Liste in HubSpot noch existiert und eine statische Liste ist. |
Ein Mitglied ohne E-Mail-Adresse, ein Listenschritt ohne gewählte Liste oder ein Schritt Kontakteigenschaft setzen ohne gewählte Eigenschaft lässt den Durchlauf nicht scheitern. Der Schritt endet mit einem Hinweis, dass nichts gesendet wurde, zum Beispiel In diesem Schritt ist keine HubSpot-Eigenschaft ausgewählt.
Ein MemberArea-Schritt in einem HubSpot-Workflow ist fehlgeschlagen
Kann eine MemberArea-Aktion ihre Arbeit nicht tun, wird der Schritt im HubSpot-Workflow als fehlgeschlagen markiert, mit einem Code und einem Satz, der sagt, was zu tun ist. Der Workflow macht mit dem nächsten Schritt weiter, damit ein Kontakt nicht alle hinter ihm aufhält. Hat MemberArea selbst einen kurzen Ausfall, versucht HubSpot den Schritt später erneut.
| Code | Was passiert ist | Was zu tun ist |
|---|---|---|
PORTAL_NOT_CONNECTED |
Das HubSpot-Konto ist mit keinem Workspace verbunden | Verbinden Sie HubSpot in dem Workspace, zu dem es gehört, unter Einstellungen, dann Integrationen |
WORKSPACE_MISSING |
Der Workspace hinter dem HubSpot-Konto existiert nicht mehr | Verbinden Sie das HubSpot-Konto mit einem bestehenden Workspace |
EMAIL_MISSING |
Der Kontakt hat keine E-Mail-Adresse | Ergänzen Sie eine beim Kontakt oder füllen Sie im Schritt Email address aus |
MEMBER_LIMIT_REACHED |
Der Tarif hat seine Mitgliederzahl erreicht | Wechseln Sie in einen größeren Tarif und führen Sie den Schritt erneut aus |
MEMBER_NOT_CREATED |
Das Mitglied konnte nicht angelegt werden | Prüfen Sie die E-Mail-Adresse beim Kontakt |
COURSE_MISSING |
Der Schritt hat keine Kurs-ID | Füllen Sie Course ID aus |
COURSE_NOT_FOUND |
Kein Kurs mit dieser ID in diesem Workspace | Kopieren Sie die ID erneut aus der Adresse des Kurses |
COURSE_NOT_PUBLISHED |
Der Kurs ist ein Entwurf | Veröffentlichen Sie den Kurs |
PRODUCT_MISSING |
Der Schritt hat keine Produkt- oder Bundle-ID | Füllen Sie die ID aus |
PRODUCT_NOT_FOUND |
Kein Produkt oder Bundle mit dieser ID in diesem Workspace | Kopieren Sie die ID erneut aus der Adresse des Produkts oder Bundles |
PRODUCT_NOT_PURCHASABLE |
Create checkout link: Das Produkt ist inaktiv oder hat keinen kaufbaren Preis | Aktivieren Sie das Produkt und geben Sie ihm einen Preis |
PRICE_NOT_FOUND |
Create checkout link: Der Preis gehört zu einem anderen Produkt oder ist nicht mehr aktiv | Lassen Sie Price ID für den Standardpreis leer oder wählen Sie einen Preis dieses Produkts |
WORKSPACE_DOMAIN_MISSING |
Create checkout link: Der Workspace hat keine Webadresse | Legen Sie die Domain unter Einstellungen fest |
GROUP_MISSING |
Der Schritt hat keine Gruppen-ID | Füllen Sie Group ID aus |
GROUP_NOT_FOUND |
Keine Gruppe mit dieser ID in diesem Workspace | Kopieren Sie die ID erneut aus der Adresse der Gruppe |
GROUP_IS_SYSTEM |
Der Schritt zeigt auf die automatische Gruppe "Alle Mitglieder" | Wählen Sie eine andere Gruppe |
GROUP_FULL |
Die Gruppe hat ihre Mitgliedergrenze erreicht | Erhöhen Sie die Grenze unter Kontakte, dann Gruppen |
TAG_MISSING |
Der Schritt hat keinen Tag | Füllen Sie Tag aus |
TAG_NOT_FOUND |
Remove tag: Kein Tag mit diesem Namen in diesem Workspace | Prüfen Sie die Schreibweise des Tag-Namens |
FIELD_MISSING |
Der Schritt hat kein Mitgliederfeld | Füllen Sie Member field aus |
FIELD_NOT_FOUND |
Kein Mitgliederfeld mit diesem Namen in diesem Workspace | Vergleichen Sie die Schreibweise mit Kontakte, Tab Felder |
FIELD_TYPE_NOT_SUPPORTED |
Das Feld ist eine Mehrfachauswahl oder ein Upload-Feld | Wählen Sie ein Feld eines anderen Typs |
INVALID_VALUE |
Der Wert passt nicht zum Feld, zum Beispiel Text in einem Zahlenfeld | Korrigieren Sie den Wert oder die HubSpot-Eigenschaft, aus der er stammt |
AUTOMATION_MISSING |
Der Schritt hat keine Automations-ID | Füllen Sie Automation ID aus |
AUTOMATION_NOT_FOUND |
Keine Automation mit dieser ID in diesem Workspace | Kopieren Sie die ID erneut aus der Adresse der Automation |
AUTOMATION_DISABLED |
Die Automation ist ausgeschaltet | Schalten Sie sie unter Automationen ein |
AUTOMATION_NOT_PUBLISHED |
Die Automation wurde nie veröffentlicht | Veröffentlichen Sie sie |
AUTOMATION_NO_TRIGGER |
Die Automation hat keinen Auslöser | Fügen Sie den Auslöser Aus einem HubSpot-Workflow gestartet hinzu und veröffentlichen Sie erneut |
Wo Sie die IDs finden, beschreibt MemberArea-Aktionen in einem HubSpot-Workflow nutzen.
Eine Automation startet nicht aus HubSpot
Gehen Sie diese Punkte der Reihe nach durch:
- Die Automation ist unter Automationen veröffentlicht und eingeschaltet.
- Die Verbindung steht im Verbindungsstatus auf Aktiv. Solange sie ein Erneut verbinden braucht, kommt aus HubSpot nichts an, und Änderungen aus dieser Zeit starten auch danach nichts.
- Bei HubSpot-Kontakteigenschaft geändert: Gemeldet werden nur die
Lebenszyklusphase und der Lead-Status. Neuer Wert muss der interne Wert
sein, etwa
customer, genau so geschrieben wie in HubSpot. - Bei Aus einem HubSpot-Workflow gestartet: Sehen Sie in den Verlauf des
HubSpot-Workflows. Ein fehlgeschlagener Schritt Start automation nennt den
Grund mit einem der
AUTOMATION_-Codes oben.
Wie die Auslöser funktionieren, beschreibt Automationen aus HubSpot starten.
Der Zugang ist nach dem Entziehen zurückgekommen
Er war nie weg. Zugang, für den das Mitglied bezahlt hat, übersteht Revoke access: Eine Bestellung für das Produkt behält, was sie freigeschaltet hat. Erstatten oder stornieren Sie die Bestellung, wenn der Zugang wirklich wegfallen muss.