Entwickler-Changelog: API, Webhooks, OAuth und MCP

Flow-Lebenszyklus

• GET /v1/flows/{id} gibt den Status des Flows bei Meta (metaStatus), seine Screens, Felder und die Absendeaktion zurück.
• POST /v1/flows/{id}/publish?dry_run=true prüft einen Flow, ohne ihn zu veröffentlichen.
• POST /v1/flows/{id}/deprecate setzt einen Flow bei Meta außer Betrieb. Meta kann das nicht rückgängig machen. Flowella blockiert es, solange Vorlagen den Flow noch verwenden, außer Sie senden force.
• DELETE /v1/flows/{id} gibt 409 HUBSPOT_FLOW_MANAGED für einen Flow zurück, der aus einem HubSpot-Formular erstellt wurde, und 409 FLOW_REFERENCED_BY_TEMPLATES, solange ein Vorlagenentwurf den Flow noch verwendet. Das Löschen eines Flows löscht ihn nie bei Meta: Setzen Sie ihn zuerst außer Betrieb (deprecate), um ihn dort stillzulegen. Das Veröffentlichen eines außer Betrieb gesetzten Flows gibt 409 FLOW_DEPRECATED zurück.
• Wenn Sie eine Vorlage erstellen, kann eine Flow-Schaltfläche mit flowellaFlowId auf einen Flowella-Flow statt auf eine Meta-Flow-ID verweisen.
• Flows, die Sie über die API erstellen, werden mit dem Einstiegsscreen MAIN_FORM veröffentlicht. Früher veröffentlichte Flows funktionieren weiter. Veröffentlichen Sie sie erneut, bevor Sie sie mit flowellaFlowId verwenden.

Webhooks

• Neues Ereignis flow.status_updated, wenn sich der Status eines Flows bei Meta ändert, zum Beispiel wenn er außer Betrieb gesetzt wird. Abonnieren Sie es unter Settings → Webhooks. Ereignistypen

Zugangsdaten

• GET /v1/ping gibt zurück, wie Sie angemeldet sind, welche Scopes Sie haben und bei Apps die Client-ID. Zugangsdaten prüfen
• Wiederholte idempotente Antworten enthalten den Header Idempotent-Replayed: true. Idempotenz

MCP-Server

• KI-Assistenten können sich per Anmeldung mit dem Flowella-MCP-Server verbinden, ohne API-Schlüssel. Die Person wählt eine Organisation und klickt auf dem Zustimmungsbildschirm von Flowella auf Allow access. Verbindungen von Mitgliedern, die nicht Owner oder Admin sind, sind schreibgeschützt. Developer Apps
• Installed apps heißt jetzt AI assistants und hat eine Spalte Last token. Installierte Apps prüfen und widerrufen

• Flowella-MCP-Server. KI-Assistenten, die das Model Context Protocol unterstützen, können Ihre Kanäle, Vorlagen und Flows lesen. Der Server ist schreibgeschützt und verwendet einen API-Schlüssel der Organisation. API-Schlüssel
• GET /v1/flows/{id} akzeptiert die Flowella-Formular-ID. Das Bearbeiten des Schemas eines Flows, der aus einem HubSpot-Formular erstellt wurde, gibt 409 zurück: Nehmen Sie die Änderung in HubSpot vor und synchronisieren Sie erneut. Flowella REST API
• In Flowella erstellte Flows können jede Einsendung an einen Ihrer Webhook-Endpunkte senden, festgelegt im Tab Settings des Flows. Webhooks
• Das Registrieren einer Developer App mit einer ungültigen Redirect-URI gibt einen verständlichen Fehler zurück. Eine App registrieren

Breaking Changes

• API-Version akzeptiert nur 2026-08-11. Jeder andere Wert gibt 400 zurück. Lassen Sie den Header weg, oder senden Sie 2026-08-11. Versionierung
• Webhook-Endpunkte brauchen eine öffentliche HTTPS-URL. Private, Loopback- und Cloud-Metadaten-Adressen werden nicht akzeptiert. Prüfen Sie jeden Endpunkt, bevor Sie aktualisieren. Einen Webhook-Endpunkt hinzufügen
• OAuth-Apps. Prüfen Sie diese Anforderungen, bevor Sie eine App aktualisieren, die auf Flowella OAuth aufbaut:
  • Anfragen ohne Scope erhalten nur Lesezugriff, und unbekannte Scopes werden abgelehnt.
  • Die Endpunkte für Token, Introspect und Revoke erfordern eine Client-Authentifizierung.
  • Die Autorisierungsanfrage erfordert state.
  • Client-Credentials-Grants geben kein Refresh-Token zurück.
  • Das Widerrufen eines Tokens widerruft nur die Token-Familie dieses Tokens.
  Developer Apps

API

• Fehlerantworten enthalten innerhalb von error eine requestId, die Sie dem Support nennen können. Fehler
• Das Erstellen eines Kontakts gibt 201 zurück, das Aktualisieren 200. Eine doppelte externalId gibt 409 zurück, ein gelöschter Kontakt 404.

Webhooks

• Neue Ereignisse contact.created, contact.updated und contact.deleted. Ereignistypen
• Geben Sie jedem Endpunkt mit Name (optional) einen Namen. Der Name erscheint in der Liste über der URL.
• 24 Stunden lang nach dem Rotieren eines Signatur-Secrets signiert Flowella jede Zustellung zusätzlich mit dem alten Secret und sendet diese Signatur in X-Flowella-Signature-Previous, sodass Sie das Secret wechseln können, ohne Ereignisse zu verlieren. Signatur-Secret rotieren
• Ein erneut zugestelltes Ereignis behält seine ursprüngliche Ereignis-ID und seinen Zeitstempel. Zustellungsdatensätze in der API enthalten die Korrelations-ID, die Antwort-Header und den Zeitpunkt des nächsten Versuchs. Ereignisse deduplizieren
• Owner der Organisation erhalten eine einzige Benachrichtigung, wenn Flowella einen fehlerhaften Endpunkt pausiert. Wiederholungsversuche und Wartezeiten

• Verwenden Sie https://api.flowella.io. Anfragen an https://api.flowella.io/v1/... geben JSON zurück. Alte URLs unter https://app.flowella.io/api/v1/..., einschließlich des OpenAPI-Dokuments, leiten dauerhaft auf den API-Host weiter. Aktualisieren Sie Ihre Basis-URL, damit Sie sich nicht auf die Weiterleitung verlassen. Basis-URL
• Der erste Server im OpenAPI-Dokument ist https://api.flowella.io, sodass importierte Collections die richtige Basis-URL aufrufen. OpenAPI-Spezifikation
• Die API lehnt ungültige Vorlagenkomponenten und Vorlagen, die die Einreichungslimits von Meta überschreiten, ab, bevor sie Meta erreichen.
• Sie können Karussell-Vorlagen über die API erstellen und senden. Wenn Sie für eine Karte keine Medien übergeben, verwendet Flowella das genehmigte Beispiel dieser Karte. Karussell-Vorlagen
• Fallback-Werte für Vorlagenvariablen gelten für Versände über die API. Fallback-Werte
• Der Developer hub enthält vollständige Anleitungen und eine Postman-Collection. Developer hub

• Wiederholte Versände derselben Vorlage über die API gehen schneller hinaus.
• Wenn Meta einen Aufruf zur Vorlagenverwaltung drosselt, meldet Flowella das als Ratenlimit, sodass Ihre Wiederholungsversuche richtig zurückfahren. Ratenlimits

• POST /v1/templates/send gibt 202 zurück. Flowella nimmt die Anfrage an, gibt sofort eine Job-ID zurück und stellt die Nachrichten im Hintergrund zu, wobei vorübergehende WhatsApp-Fehler erneut versucht werden. Wenn Ihre Integration auf eine Antwort 200 prüft, passen Sie sie so an, dass sie 202 mit "status": "accepted" erwartet. Verfolgen Sie die Zustellung im Tab Statistics der Vorlage. Massenversand von Vorlagen
• Idempotency-Key. Senden Sie einen Header Idempotency-Key mit POST /v1/templates/send, und Flowella erkennt Wiederholungen derselben Anfrage sieben Tage lang und gibt die ursprüngliche Job-ID zurück, statt erneut zu senden. Idempotenz

• REST v1 ist dokumentiert und wird auf dem eigenen API-Host unter /v1/... bereitgestellt. Flowella REST API