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)
- 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.
Im Handumdrehen in die Warteschlange gestellt. Es folgen die Ereignisse.
Senden Sie die Anfrage und beobachten Sie dann, wie die Ereignisse zurückkommen. Im Handumdrehen in die Warteschlange gestellt. Es folgen die Ereignisse. Derselbe Schlüssel, derselbe Auftrag. Niemand bekommt ihn zweimal. Eine Antwort enthält IDs, nicht den Wortlaut. Keine Antwort? Insgesamt drei Versuche, dann höre ich auf.
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"]
}
]
}
{
"templateId": "cltemplate00000001",
"whatsappChannelId": "clchannel000000001",
"recipients": [
{
"phone": "+447700900123",
"bodyParameters": ["Maximiliana-Wolfgang"]
}
]
}
{
"id": "v1ts-3f9a07c2b1d4e6a8",
"status": "accepted"
}
{
"id": "v1ts-3f9a07c2b1d4e6a8",
"status": "accepted"
}
In der Warteschlange. Flowella sendet im Hintergrund.
In der Warteschlange. Flowella sendet im Hintergrund. Gleicher Schlüssel, gleicher Job: Nichts wurde doppelt gesendet. Angenommen, aber Maximiliana-Wolfgang hat sich auf diesem Kanal abgemeldet, also sendet Flowella nichts.Heute
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": { … }
}
{
"id": "evt_5b0e2c7d91f64a38b2c6d0e4f7a19c53",
"type": "message.delivered",
"created_at": "2026-10-16T09:14:03.000Z",
"payload_version": "1",
"data": { … }
}
In data: die messageId der Nachricht.
Nicht in data: die Telefonnummer und der Nachrichtentext.
In data: messageId, conversationId, contactId, direction, type und metaMessageId.
Nicht in data: die Telefonnummer und der Nachrichtentext.
In data: die messageId der Nachricht.
In data: die Telefonnummer und der Grund.
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.
Ändern Sie bei Bedarf den Vornamen und senden Sie dann die Anfrage. Die Anfrage wird gesendet. 202 Accepted: Flowella hat den Versand in die Warteschlange gestellt und sofort eine Job-ID zurückgegeben. message.sent, message.delivered und message.read sind an Ihrem Endpunkt angekommen, jeweils signiert. Gleicher Idempotency-Key, also hat Flowella denselben Job zurückgegeben und nichts doppelt gesendet. Die Antwort von Maximiliana-Wolfgang kam als message.received an: IDs, Richtung und Typ, nicht die Worte. STOP hat Maximiliana-Wolfgang abgemeldet: message.received kam an, dann optout.created mit der Telefonnummer und dem Grund. Ihr Endpunkt antwortet nicht, also versucht Flowella es nach 1 Sekunde erneut, dann nach 2. Flowella hat nach 3 Versuchen aufgehört. Schalten Sie Ihren Endpunkt wieder ein und senden Sie mit einem neuen Schlüssel. Ihr Endpunkt hat geantwortet, also kam die Zustellung bei einem neuen Versuch an. 202 Accepted, aber Maximiliana-Wolfgang hat sich mit STOP abgemeldet, also sendet Flowella die Vorlage nicht.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 HudsonLeiterin der Abteilung für Zulassung, Marken- und Kundeninnovation
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-EndtGeschäftsführer, 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-ReferenzAPI 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.
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.
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.
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.
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