> ## 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

> Fehlende HubSpot-Formulare, blockierte Workflow-Aktionen, dedupliziert unterdrückte Vorlagen-Sendungen und fehlende Kontakteigenschaften diagnostizieren.

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

<Steps>
  <Step title="Öffnen Sie Einstellungen → HubSpot">
    Gehen Sie in der Flowella-App zu **Einstellungen → HubSpot**.
  </Step>

  <Step title="Lesen Sie die Statusplakette">
    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.
  </Step>

  <Step title="Bei Bedarf neu verbinden">
    Klicken Sie auf **Wiederverbinden** und führen Sie HubSpot OAuth erneut durch. Versuchen Sie dann erneut, die fehlgeschlagene Aktion auszuführen.
  </Step>
</Steps>

<Info>
  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.
</Info>

## 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/flows) 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). |
| `DUPLICATE_TEMPLATE_SEND_SUPPRESSED` | Dieselbe Vorlage wurde bereits an dieselbe Telefonnummer innerhalb des Deduplizierungsfensters von Flowella gesendet. Dies ist ein bewusster Schutzmechanismus, kein Zustellfehler. Siehe [Template send suppressed as duplicate](#template-send-suppressed-as-duplicate). |

### Template send suppressed as duplicate

Wenn HubSpot eine Aktion **WhatsApp-Vorlage senden** anzeigt, die mit dem Fehlergrund `DUPLICATE_TEMPLATE_SEND_SUPPRESSED` abgeschlossen wurde, hat Flowella den Versand absichtlich übersprungen, weil dieselbe Vorlage bereits an dieselbe Telefonnummer innerhalb des Deduplizierungsfensters gesendet wurde.

Der häufigste Auslöser sind **zwei HubSpot-Kontakte, die sich eine Telefonnummer teilen** — zum Beispiel ein privater und ein beruflicher Datensatz oder ein Haushalt mit einer WhatsApp-Nummer — die sich innerhalb weniger Sekunden voneinander in denselben Workflow einschreiben. Nur der erste Versand geht an WhatsApp; der zweite wird unterdrückt, damit der Kontakt dieselbe Nachricht nicht zweimal erhält.

Zuvor blieb die zweite Workflow-Aktion etwa eine Stunde lang auf **Pending**, bis das Callback-Timeout von HubSpot griff. Flowella schließt den Callback jetzt sofort als Fehler ab, sodass der angemeldete Kontakt ohne Wartezeit zum nächsten Schritt (oder in den „action failed"-Zweig) weitergeht.

**So unterscheiden Sie es von einem echten Fehler:**

* **Als Duplikat unterdrückt** — der Fehlergrund lautet genau `DUPLICATE_TEMPLATE_SEND_SUPPRESSED`. Die Vorlage wurde an diese Telefonnummer gesendet, nur über einen anderen angemeldeten Kontakt. Keine Aktion erforderlich.
* **Echter Sendefehler** — der Fehler enthält einen spezifischen Grund wie `Template not approved`, `Phone number invalid`, `Contact opted out` oder einen Meta-Graph-Fehlercode. Folgen Sie der Zeile in der Tabelle oben.

Wenn Sie legitim dieselbe Vorlage zweimal an dieselbe Nummer senden müssen (zum Beispiel eine erneute Bestätigung nach einer langen Verzögerung), verteilen Sie die Anmeldungen über das Deduplizierungsfenster hinaus oder verwenden Sie eine andere Vorlage.

### 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?

<Note>
  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
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.