Bauen Sie auf Flowella auf – mit Ihrem eigenen Code.

Wenn die No-Code-Tools eine Funktion nicht abdecken, springen die Flowella-REST-API und ausgehende Webhooks ein. Rufen Sie die API auf, um WhatsApp-Nachrichten zu versenden, Kontakte und Abmeldungen zu verwalten sowie Analysedaten abzurufen. Abonnieren Sie Webhooks, um in Echtzeit auf Nachrichten, Zustellungen, Abmeldungen, Kontakte und Änderungen an Vorlagen zu reagieren – ganz ohne Polling.

Bewertung: 5 von 5 auf dem HubSpot Marketplace (öffnet in einem neuen Tab)
Keine Abfrage erforderlich Flo, das Maskottchen von Flowella, steckt einen großen Stecker in eine Steckdose auf einer schwebenden Platte
Basis-URL
api.flowella.io/v1
Authentifizierung
Ein Inhaberschlüssel, der mit „flo_“ beginnt
Webhook-Ereignisse
12, jeweils mit HMAC-SHA256 signiert
Lieferung
3 Versuche, eine 10-Sekunden-Auszeit

Ruf dort an, und warte, bis man dich zurückruft.

Zwei Richtungen, ein Motor. Ihre App ruft die REST-API auf, um Vorgänge auszulösen, und Flowella sendet signierte Webhook-Ereignisse an Ihren Endpunkt, sobald etwas passiert – so können Sie reagieren, anstatt ständig abzufragen. Senden Sie eine Vorlage und verfolgen Sie anschließend die Ereignisse zurück.

Flo steckt farbige Kabel in eine Schalttafel
Deine AppRuft die Flowella-API auf
Beispieldaten

POSThttps://api.flowella.io/v1/templates/send

Header

Authorization
Bearer flo_••••••••••••Ihr API-Schlüssel, maskiert
Content-Type
application/json
Idempotency-Key
renewal-2026-10-16-1Wiederholungen dieses Schlüssels innerhalb von sieben Tagen liefern denselben Job.

Body

{
  "templateId": "cltemplate00000001",
  "whatsappChannelId": "clchannel000000001",
  "recipients": [
    {
      "phone": "+447700900123",
      "bodyParameters": ["Sam"]
    }
  ]
}
Antwort von Flowella202 Accepted
{
  "id": "v1ts-3f9a07c2b1d4e6a8",
  "status": "accepted"
}

In der Warteschlange. Flowella sendet im Hintergrund.

Acme ClubGeschäftskonto
Beispieldaten

Heute

Hallo Sam, Deine Mitgliedschaft im Acme Club verlängert sich am 31. Oktober. Verlängere sie in nur einer Minute – direkt hier in WhatsApp.
Ihr EndpunktEmpfängt die Webhooks von Flowella
Beispieldaten

Zustellungen

POSThttps://example.com/webhooks/flowella

Content-Type
application/json
X-Flowella-Signature
5c2e91…a07f3bGültig
{
  "id": "evt_9a4f1d06c3e84b27a5d9e2b70c6f8d14",
  "type": "message.read",
  "created_at": "2026-10-16T09:14:21.000Z",
  "payload_version": "1",
  "data": { … }
}

In data: die messageId der Nachricht.

Flowella wartet bis zu 10 Sekunden auf einen 2xx-Code und versucht jede Übertragung höchstens dreimal im Abstand von jeweils 1 und 2 Sekunden.

message.sent, message.delivered und message.read sind an Ihrem Endpunkt angekommen, jeweils signiert.

Melden Sie sich für eine der 12 Veranstaltungen an.

Wählen Sie unter „Einstellungen“ > „Webhooks“ die gewünschten Ereignisse aus. Jedes Ereignis wird als signierter POST-Request mit einer eigenen ID, dem Typ, dem Zeitpunkt des Ereignisses und den zugehörigen Daten übermittelt.

Nachrichten

message.received
Es geht eine WhatsApp-Nachricht von einem Kontakt ein
message.sent
Flowella hat Ihre Nachricht entgegengenommen und an Meta weitergeleitet.
message.delivered
Meta hat die Zustellung auf das Gerät des Empfängers bestätigt
message.read
Der Empfänger hat die Nachricht geöffnet
message.failed
Meta hat für die Nachricht einen Fehler zurückgegeben

Gespräche

conversation.opened
Eine Unterhaltung wurde in den Status „offen“ versetzt
conversation.closed
Ein Gespräch wurde beendet

Abmeldeoptionen

optout.created
Ein Kontakt hat sich von einem Kanal abgemeldet

Vorlagen

template.status_updated
Meta hat den Status einer Vorlage geändert: genehmigt, abgelehnt, pausiert oder deaktiviert

Ansprechpartner

contact.created
Ein Kontakt wurde angelegt
contact.updated
Ein Kontakt wurde aktualisiert
contact.deleted
Ein Kontakt wurde gelöscht

Außerdem „webhook.test“, das nur gesendet wird, wenn Sie auf „Test senden“ klicken.

Versenden, verwalten und auswerten.

Eine unkomplizierte REST-API der Version 1 unter api.flowella.io/v1 mit Bearer-Key-Authentifizierung und vorhersehbarem Verhalten.

  • Nachrichten und Vorlagen versenden

    Senden Sie eine WhatsApp-Nachricht oder stellen Sie eine Vorlage in einer einzigen Anfrage für mehrere Empfänger in die Warteschlange. Fügen Sie „throttlePerHour“ hinzu, und Flowella regelt den Versand großer Mengen für Sie.

  • Kontakte und Abmeldungen

    Erstellen oder bearbeiten Sie Kontakte, blättern Sie durch die Liste und aktivieren oder deaktivieren Sie die WhatsApp-Abmeldung eines Kontakts in einem Kanal.

  • Gespräche und Analysen

    Listen Sie Konversationen und Vorlagen auf und integrieren Sie die Analysen zu ausgehenden Nachrichten in Ihre eigenen Berichte.

  • Tasten, die du steuerst

    Besitzer und Administratoren erstellen Schlüssel unter „Einstellungen“ > „API-Schlüssel“. Jeder Schlüssel beginnt mit „flo_“, wird nur einmal angezeigt und kann auf die erforderlichen Bereiche beschränkt werden.

  • Man kann es ruhig noch einmal versuchen

    Das Senden eines Idempotenz-Schlüssels mit einem Vorlagensendevorgang und einer Wiederholung innerhalb von sieben Tagen führt zum selben Auftrag, sodass ein Timeout niemals dazu führt, dass jemand zweimal benachrichtigt wird.

  • Zuerst ohne Code, Code nur bei Bedarf

    HubSpot-Workflows versenden bereits Vorlagen mit bis zu 20 Variablen pro Kontakt – ganz ohne Programmierkenntnisse. Nutzen Sie die API für alles, was nicht versendet werden kann, wie beispielsweise Einmalcodes und Link-Schaltflächen pro Kontakt.

Das sagen unsere Kunden.

Eine außergewöhnliche Engagement-Plattform, die unsere Konversionsrate bei Studierenden grundlegend verändert hat – mit einem Anstieg der Bewerbungen am selben Tag um 160 % und einer WhatsApp-Antwortquote von 90 %.

Peter Hudson Peter HudsonLeiterin der Abteilung für Zulassung, Marken- und KundeninnovationIntegration aus dem HubSpot Marketplace Oaklands CollegeOaklands College

Ein bahnbrechendes Tool für Spendenkampagnen, das eine persönliche Interaktion über WhatsApp mit nahtloser Automatisierung und deutlich höheren Abschlussquoten ermöglicht.

Lawrence Tribe-Endt Lawrence Tribe-EndtGeschäftsführer, Countryside AllianceCustomer.io über die Flowella API Countryside Alliance

Direkte Antworten.

Fragen, die Entwickler stellen. Sollte Ihre Frage hier nicht dabei sein, melden Sie sich bitte bei uns.

Lesen Sie die API-Referenz

API und Webhooks

Wie kann ich mich authentifizieren?

Mit einem organisationsweiten Bearer-Schlüssel im „Authorization“-Header. Eigentümer und Administratoren erstellen Schlüssel unter „Einstellungen“ > „API-Schlüssel“. Jeder Schlüssel beginnt mit „flo_“ und wird nur einmal angezeigt. Bewahren Sie ihn daher sicher auf und ersetzen Sie ihn, wenn Teammitglieder das Unternehmen verlassen.

API-Schlüssel verwalten

Was kann die API leisten?

Versenden Sie WhatsApp-Nachrichten und -Vorlagen, einschließlich Einmalcodes und Link-Schaltflächen pro Kontakt, erstellen und aktualisieren Sie Kontakte, legen Sie Opt-outs fest oder heben Sie diese auf, listen Sie Unterhaltungen und Vorlagen auf und rufen Sie Analysedaten zu ausgehenden Nachrichten ab. Die Endpunktliste stammt aus der OpenAPI-Spezifikation, die sich direkt in Postman oder einen Codegenerator einbinden lässt.

Kann ich Einmalcodes oder Link-Schaltflächen für einzelne Kontakte versenden?

Ja, über die API, und zwar ausschließlich dort. Eine Schaltfläche zum Kopieren des Codes benötigt bei jedem Versand einen neuen Code, und nur die API legt pro Person eine Link-Schaltfläche fest: Über einen HubSpot-Workflow erhält jeder den einzigen Fallback-Link der Vorlage. Um einen kontaktbezogenen Link aus HubSpot zu versenden, fügen Sie ihn in eine Body-Variable ein, wo WhatsApp ihn anklickbar macht. Codes dürfen bis zu 15 Zeichen lang sein, und die gleiche Vorlage an dieselbe Nummer innerhalb von 15 Sekunden wird verworfen. Die API gibt den Status 202 zurück und versendet die Nachricht sofort, sofern Sie „scheduledAt“ nicht festgelegt haben.

Was sollte ich vor meinem ersten Anruf wissen?

Die Basis-URL lautet https://api.flowella.io/v1. Listen verwenden eine Cursor-Paginierung mit einer Begrenzung von 1 bis 100, Fehler werden in einem gemeinsamen Envelope mit einem festen Code übermittelt, und für jede Organisation gilt eine Ratenbegrenzung; bei zu schnellem Zugriff werden ein 429-Status und ein „Retry-After“-Header zurückgegeben. Geben Sie Telefonnummern im E.164-Format an.

Einführung in die API

Kann ich umfangreiche Massensendungen durchführen?

Ja. Der POST-Aufruf an /v1/templates/send stellt den Versand in die Warteschlange und gibt den Status 202 Accepted mit einer Job-ID zurück. Durch Hinzufügen von „throttlePerHour“ und „Flowella“ wird die Zustellung serverseitig gedrosselt. Durch Hinzufügen eines Idempotency-Keys wird bei einer Wiederholung innerhalb von sieben Tagen derselbe Job zurückgegeben, anstatt ihn erneut zu versenden.

Wie kann ich überprüfen, ob ein Webhook echt ist?

Jede Übertragung enthält „X-Flowella-Signature“, einen HMAC-SHA256-Hex-Digest des Rohdatentextes, der mit Ihrem Signaturschlüssel erstellt wurde. Berechnen Sie denselben Digest über die Rohdaten (vor jeglicher JSON-Auswertung) und vergleichen Sie ihn. Während einer Schlüsselrotation enthält „X-Flowella-Signature-Previous“ den mit dem alten Schlüssel erstellten Digest.

Ausgehende Webhooks

Was ist, wenn mein Endpunkt ausgefallen ist?

Flowella wartet bis zu 10 Sekunden auf einen 2xx-Status und versucht jede Übermittlung maximal dreimal im Abstand von 1 bzw. 2 Sekunden. Antworten Sie daher schnell und erledigen Sie die Arbeit anschließend. Unter „Einstellungen“ > „Webhooks“ werden die letzten Übermittlungen für jeden Endpunkt aufgelistet.

Wie vermeide ich die Verarbeitung von Duplikaten?

Bei einem erneuten Versuch kann dasselbe Ereignis zweimal übermittelt werden. Jede Übermittlung enthält auf oberster Ebene die ID des Ereignisses, die bei jedem erneuten Versuch identisch ist. Speichere daher die IDs der bereits verarbeiteten Ereignisse vorübergehend und behandle Wiederholungen als „No-Ops“.

Enthält „message.received“ den Text der Nachricht?

Nein. Es enthält IDs für die Nachricht, die Unterhaltung und den Kontakt sowie die Richtung und den Typ, jedoch weder die Telefonnummer noch den Wortlaut, und die API bietet keinen Aufruf zum Auslesen einer einzelnen Nachricht. „optout.created“ enthält hingegen die Telefonnummer und den Grund.

Flo springt vor Freude in die Luft, die Faust in die Höhe gereckt und das Handy in der Hand

Bauen Sie auf derselben Engine auf – ganz nach Ihren Vorstellungen.

Beginnen Sie mit den No-Code-Tools und greifen Sie dann auf die API und Webhooks zurück, wenn Ihr Stack mehr benötigt. Die Einrichtung von Flowella dauert etwa 30 Minuten; es gibt eine kostenlose 14-tägige Testversion, für die keine Kreditkartendaten erforderlich sind.

Eine Flowella-Demo buchen · 30 Minuten über Teams