> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.
# HubSpot Sync-Fehler
> Diagnostizieren Sie fehlende Formularübermittlungen, blockierte Workflow-Aktionen und Kontaktaktualisierungen, die HubSpot nicht erreichen.
Die meisten HubSpot-Probleme lassen sich in einen von drei Bereichen einordnen: Die **Integration wurde getrennt**, eine **Feldzuordnung ist falsch** oder eine **Workflow-Aktion ist falsch konfiguriert**. Auf dieser Seite gehen wir sie der Reihe nach durch.
Für die Ersteinrichtung siehe [HubSpot-Einrichtung](/de/hubspot/setup). Für Workflow-Aktionen, siehe [Workflow-Aktionen](/de/hubspot/workflow-actions).
## 1. Prüfen Sie die Verbindung
Gehen Sie in der Flowella-App zu **Einstellungen → HubSpot**.
Ein grünes **Verbunden**-Badge bedeutet, dass der OAuth-Token gültig ist. Ein rotes **Reconnect**-Banner bedeutet, dass der Token widerrufen wurde oder abgelaufen ist.
Klicken Sie auf **Wiederverbinden** und führen Sie HubSpot OAuth erneut durch. Versuchen Sie dann erneut, die fehlgeschlagene Aktion auszuführen.
Häufige Ursachen für das Scheitern einer HubSpot-Verbindung:
* Der Benutzer HubSpot, der Flowella autorisiert hat, wurde aus dem Portal entfernt.
* HubSpot hat den Token gedreht, weil er in letzter Zeit nicht verwendet wurde.
* Ein Super Admin hat die Integration von Flowella in den App-Einstellungen von HubSpot deaktiviert.
## 2. Formulareinreichungen erscheinen nicht in HubSpot
Wenn ein Kontakt ein WhatsApp Flow ausfüllt, aber Sie können die Übermittlung nicht in HubSpot sehen:
### Die Feldzuordnung stimmt nicht überein
Der Flow enthält möglicherweise ein Feld, das nicht mit einer HubSpot-Eigenschaft eines kompatiblen Typs übereinstimmt. Öffnen Sie das Formular auf der Seite [Formulare](/de/app/forms) und überprüfen Sie die Zuordnung für jedes Feld.
### Erforderliches Feld ist leer
Wenn ein HubSpot-Formularfeld als erforderlich gekennzeichnet ist und WhatsApp Flow dem Benutzer erlaubt, es zu überspringen, wird die Übermittlung von HubSpot abgelehnt. Machen Sie das Feld in HubSpot optional oder im Flow erforderlich.
### Format der Telefonnummer
HubSpot ist streng, was das Format der Telefonnummer angeht. Siehe [Telefonnummernformat](/de/hubspot/phone-number-format) - die meisten Probleme mit "fehlenden Kontakten" hängen mit dem E.164-Format und dem nationalen Format zusammen.
### Die Suche erfolgt nach der Ausführung der Workflow-Aktion.
Wenn Ihr HubSpot-Workflow sofort nach dem Absenden des Formulars ausgeführt wird, können Race Conditions dazu führen, dass der Workflow ausgelöst wird, bevor Flowella den Kontakt geschrieben hat. Fügen Sie eine kurze Verzögerung (1-2 Minuten) beim Start des Workflows hinzu, oder lösen Sie die Änderung der Kontakteigenschaft aus, anstatt die Übermittlung des Formulars.
## 3. Workflow-Aktionen werden blockiert oder schlagen fehl
Wenn ein HubSpot-Workflow, der eine Flowella-Aktion enthält, stecken bleibt:
### Öffnen Sie den Aktionsverlauf des Workflows
Suchen Sie in HubSpot den Kontakt, scrollen Sie zu **Workflowverlauf** und klicken Sie auf den fehlgeschlagenen Lauf. HubSpot zeigt die Antwort, die Flowella für jede Aktion zurückgegeben hat.
### Allgemeine Fehlerantworten
| Fehler | Was ist zu tun |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Channel not found` | Der Arbeitsablauf verweist auf einen Kanal, der nicht mehr existiert. Bearbeiten Sie die Aktion und wählen Sie einen aktuellen Kanal. Siehe [Multi-Channel](/de/essentials/multi-channel). |
| `Template not approved` | Die Vorlage, auf die verwiesen wird, hat ihren Status in `REJECTED`, `PAUSED` oder `DISABLED` geändert. Siehe [Vorlage abgelehnt](/de/troubleshooting/template-rejected). |
| `Contact opted out` | Der Kontakt hat sich für diesen Kanal abgemeldet. Respektieren Sie die Abmeldung - umgehen Sie sie nicht. |
| `Phone number invalid` | Das Telefon des Kontakts ist nicht in E.164. Siehe [Rufnummernformat](/de/hubspot/phone-number-format). |
| `Subscription required` | Ihr Flowella-Tarif umfasst diese Aktion nicht, oder Ihr Abonnement ist abgelaufen. Siehe [Abrechnung](/de/account/billing). |
### Aktion existiert, bewirkt aber nichts
Wenn der Workflow ohne Fehler abläuft, aber keine Nachricht ankommt, überprüfen Sie dies noch einmal:
* Die Aktion ist aktiviert (nicht pausiert).
* Der Empfänger wurde im richtigen Schritt in den Workflow aufgenommen.
* Die Anmeldekriterien von HubSpot stimmen noch mit dem Kontakt überein.
## 4. Verwirrung bei der Synchronisierungsrichtung
Die Synchronisierung von Flowella ist **bidirektional, aber teilweise**:
* WhatsApp Flow Übermittlungen → schreiben Kontakteigenschaften in HubSpot.
* HubSpot-Workflow-Aktionen → senden WhatsApp-Nachrichten und Vorlagen.
* Eingehende WhatsApp-Antworten → protokollieren in der Zeitleiste des Kontakts (aktualisiert nicht automatisch die Eigenschaften).
Wenn Sie erwarten, dass eine Freiform-WhatsApp-Antwort eine Eigenschaft aktualisiert, ist ein zusätzlicher Schritt auf Ihrer Seite erforderlich - ein HubSpot-Workflow, der auf das Konversationsereignis wartet und die Antwort analysiert, oder eine benutzerdefinierte Integration über die [API](/de/api-reference/introduction).
## Stecken Sie immer noch fest?
Erfassen Sie das Folgende, bevor Sie sich an [support](https://flowella.io/support) wenden:
* Den Zeitstempel der **letzten Synchronisierung** aus **Einstellungen → HubSpot**.
* Die genaue Fehlermeldung (oder Screenshot), die Flowella oder HubSpot zurückgegeben hat
* Die betroffene Kontakt-ID und Workflow-ID