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

# Flow-JSON-Versionen: Einfrieren und Ablauf

> Wie WhatsApp Flow JSON, Data API und Flow-Nachrichten versioniert, was eingefroren und abgelaufen für Flows bedeutet und welche Versionen Flowella nutzt.

Jeder WhatsApp Flow gibt an, in welcher Version von Flow JSON er geschrieben ist, und Endpoint-Flows geben zusätzlich eine Data-API-Version an. Meta fügt Funktionen in neuen Versionen hinzu und stellt alte in zwei Schritten ein: Eine **eingefrorene** Version kann nicht mehr veröffentlicht werden, und eine **abgelaufene** Version kann weder gesendet noch geöffnet werden. Damit Flows weiter funktionieren, müssen sie auf einer unterstützten Version bleiben.

> [!NOTE]
>
> **In Flowella.** Unterstützt. Flowella schreibt jeden Flow in Flow JSON **7.3**, der neuesten Version, und Flows aus HubSpot-Formularen verwenden Data API **3.0**. Flowella stellt veröffentlichte Flows nicht selbst auf eine neue Version um: Ein Flow verwendet die Version, die Flowella schreibt, wenn Sie ihn das nächste Mal synchronisieren oder veröffentlichen.

## Die drei Versionen

| Version | Format | Steuert |
| - | - | - |
| **Flow JSON** | `major.minor`, zum Beispiel `7.3` | Welche Komponenten und Eigenschaften der Flow verwenden kann und wie sie sich verhalten |
| **Data API** | `major.minor`, zum Beispiel `3.0` | Wie ein Endpoint-Flow seine Anfragen verschlüsselt und formatiert. Nur bei Endpoint-Flows. |
| **Nachricht** | Eine ganze Zahl, derzeit `3` | Das Format einer interaktiven Flow-Nachricht |

Eine Änderung der ersten Zahl ist eine Breaking Change, ein Flow muss für den Wechsel also möglicherweise angepasst werden. Eine Änderung der zweiten Zahl fügt Funktionen hinzu, ohne etwas zu beeinträchtigen. Auf `1.9` folgt `1.10`, nicht `2.0`.

## Eingefroren und abgelaufen

| Status | Veröffentlichen | Senden und Öffnen |
| - | - | - |
| **Unterstützt** | Erlaubt | Erlaubt |
| **Eingefroren** | Abgelehnt. Sie können keinen Flow in dieser Version erstellen oder aktualisieren. | Weiterhin erlaubt |
| **Abgelaufen** | Abgelehnt | Abgelehnt. Kunden können Flows in dieser Version nicht öffnen, auch keine, die sie bereits erhalten haben. |

Meta kündigt das Einfrieren oder den Ablauf einer Version meist etwa 90 Tage vorher an und veröffentlicht die Termine im Flows-Changelog. Aus Sicherheitsgründen kann Meta schneller handeln und den Schritt des Einfrierens auch ganz überspringen.

## Stand der Versionen

| Version | Veröffentlicht | Status im Changelog von Meta |
| - | - | - |
| 7.3 | September 2025 | Neueste, nicht eingefroren |
| 7.2, 7.1, 7.0 | März bis Juli 2025 | Nicht eingefroren |
| 6.0 bis 6.3 | November 2024 bis Januar 2025 | Nicht eingefroren |
| 5.1 | September 2024 | Nicht eingefroren |
| 5.0 | August 2024 | Eingefroren seit 10. September 2025 |
| 4.0, 3.1, 3.0, 2.1 | 2023 bis 2024 | Eingefroren seit 8. April 2025 |

Das Flows-Changelog von Meta wurde zuletzt am 11. November 2025 aktualisiert. Prüfen Sie es, bevor Sie eine Migration planen.

Data API **4.0**, veröffentlicht im November 2025, fügt eine optionale Signatur hinzu, die belegt, dass jede Endpoint-Anfrage von jemandem stammt, der die Flow-Nachricht erhalten hat. Data API 3.0 wird weiterhin unterstützt.

## Wichtige Breaking Changes

| Wechsel auf | Was sich geändert hat |
| - | - |
| 4.0 | Kontrollkästchen- und Optionsfeldgruppen brauchen ein Label. Namen von Eingabefeldern dürfen nicht leer sein. |
| 5.0 | Datumsauswahlen übertragen Datumsangaben als `YYYY-MM-DD`, unabhängig von Zeitzonen |
| 6.0 | Textwerte dürfen nicht leer sein oder nur aus Leerzeichen bestehen. Bilder in Optionen dürfen höchstens 100 KB groß sein. |
| 7.0 | Die Auswahl einer Option führt ihre Aktion nicht mehr erneut aus, wenn ein Screen wieder geöffnet wird |

## Was Sie tun sollten, wenn Meta ein Einfrieren ankündigt

* **In Flowella erstellte Flows** verwenden die Version, die Flowella schreibt. Wenn Flowella auf eine neuere Version wechselt, synchronisieren oder veröffentlichen Sie jeden Flow erneut, um ihn umzustellen.
* **Im WhatsApp Manager oder einem anderen Tool erstellte Flows** müssen dort aktualisiert werden, bevor die Version abläuft. Meta zeigt Warnungen in seinem Flow-Builder an und sendet Webhooks mit Versionswarnungen.
* **Bevor eine Version abläuft**, ersetzen Sie jede Vorlage, deren Flow noch auf dieser Version ist. Sonst können Kunden, die auf die Schaltfläche tippen, den Flow nicht öffnen.

## Verwandt

> [card] [WhatsApp Flows im Überblick](https://knowledge.flowella.io/de/whatsapp/flows/flows-overview.md)
>
> Wie Flows und ihre Status funktionieren.

> [card] [Flow-Komponenten und Limits](https://knowledge.flowella.io/de/whatsapp/flows/flow-components-and-limits.md)
>
> Was jede Version anzeigen kann.

> [card] [Flow-Endpoints und Sicherheit](https://knowledge.flowella.io/de/whatsapp/flows/flow-endpoints-and-security.md)
>
> Data-API-Versionen in der Praxis.

> [card] [Plattformänderungen](https://knowledge.flowella.io/de/whatsapp/platform-changes.md)
>
> Anstehende Änderungen von Meta, die Flowella betreffen.

Abgeglichen mit der Dokumentation von Meta am 18. November 2026: [Versioning](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/versioning) und dem [WhatsApp Flows changelog](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/changelog).


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