WhatsApp-Ereignisse, die Ihre n8n-Workflows steuern.

Die signierten Webhooks von Flowella starten Ihre n8n-Workflows über den n8n-eigenen Webhook-Trigger, und der HTTP-Request-Knoten sendet WhatsApp-Vorlagen über die Flowella-API zurück.

Kostenlos loslegen API-Referenz

Funktioniert heuteÜber die Flowella-API und Webhooks
In Kürze verfügbarEin Flowella-Knoten für n8n

Flo, das Maskottchen von Flowella, steckt ein Kabel in den letzten der drei farbigen Knoten, um diese miteinander zu verbinden

Löse ein Ereignis aus, verfolge die Nutzdaten.

Hier ist ein n8n-Workflow, der im Flowella-Stil dargestellt ist. Wählen Sie ein Beispielereignis aus und senden Sie es, dann verfolgen Sie den Weg von Knoten zu Knoten: Der „Switch“-Knoten leitet jedes Ereignis weiter, und ein „HTTP Request“-Knoten benachrichtigt Ihr Team, aktualisiert Ihre Mailingliste oder sendet eine WhatsApp-Vorlage über die Flowella-API zurück. Wählen Sie einen beliebigen Knoten aus, um genau zu sehen, was er empfangen oder gesendet hat.

Flo zeigt auf einen der drei Pfeile auf dem Wegweiser, so wie ein Workflow-Zweig einen Pfad auswählt

Nur die eigenen Knoten von n8n

Beispielveranstaltung

Ada antwortetmessage.received Ada schreibt „STOP“optout.created Ihre Vorlage wurde genehmigttemplate.status_updated

Acme ClubGeschäftskonto

Beispieldaten

Heute

Hallo Ada, deine Mitgliedschaft im Acme Club verlängert sich am 31. Oktober. Wenn du Fragen hast, antworte bitte hier.09:30

Flowella-Veranstaltungenn8n-Workflow

Beispieldaten

Was Flowella an den Webhook gesendet hat Beispieldaten

POST/webhook/flowella-events

Content-Type: application/json
X-Flowella-Signature: Wird unterzeichnet, wenn ein Ereignis eintritt

Sende eine Veranstaltung, um die Beiträge von Flowella hier zu sehen.

POST/webhook/flowella-events

Content-Type: application/json
X-Flowella-Signature: 5d2c9f1a…e19a

{
  "id": "6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10",
  "type": "message.received",
  "created_at": "2026-10-16T08:41:07.000Z",
  "payload_version": "1",
  "data": {
    "messageId": "clsamplemsg00000000000043",
    "conversationId": "clsampleconv0000000000007",
    "contactId": "clsamplecontact0000000003",
    "direction": "INBOUND",
    "type": "TEXT",
    "metaMessageId": "wamid.sample00000000000043"
  }
}

POST/webhook/flowella-events

Content-Type: application/json
X-Flowella-Signature: 5d2c9f1a…e19a

{
  "id": "6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10",
  "type": "optout.created",
  "created_at": "2026-10-16T08:41:07.000Z",
  "payload_version": "1",
  "data": {
    "contactId": "clsamplecontact0000000003",
    "conversationId": "clsampleconv0000000000007",
    "phone": "+447700900123",
    "reason": "USER_KEYWORD"
  }
}

POST/webhook/flowella-events

Content-Type: application/json
X-Flowella-Signature: 5d2c9f1a…e19a

{
  "id": "6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10",
  "type": "template.status_updated",
  "created_at": "2026-10-16T08:41:07.000Z",
  "payload_version": "1",
  "data": {
    "metaTemplateId": "1234567890123456",
    "templateName": "autumn_fair_invite",
    "status": "APPROVED",
    "language": "en_GB"
  }
}

Jede Zustellung hat denselben Umschlag, und die veranstaltungsspezifischen Felder befinden sich im letzten Schlüssel: id type created_at payload_version data

Überprüfen Sie „X-Flowella-Signature“, bevor Sie fortfahren: Dabei handelt es sich um einen HMAC-SHA256-Hex-Digest des Rohtextes, der mit Ihrem Signaturschlüssel verschlüsselt wurde.

Switch: Bei jedem Ereignis wird die erste Regel ausgewählt, deren Bedingungen alle erfüllt sind.

Diese Veranstaltung: Noch nicht geprüft type: message.received data.type: TEXT type: optout.created type: template.status_updated data.status: APPROVED

Das Team benachrichtigen {{ $json.body.type }} ist gleich message.received {{ $json.body.data.type }} ist gleich TEXT
Die Mailingliste aktualisieren {{ $json.body.type }} ist gleich optout.created
Kampagne versenden {{ $json.body.type }} ist gleich template.status_updated {{ $json.body.data.status }} ist gleich APPROVED

Warten auf eine Veranstaltung.

Regel 1 trifft zu, daher wird im Rahmen des Vorfalls eine Warnung an das Team ausgegeben.

Regel 2 trifft zu, daher wird im nächsten Schritt die Mailingliste aktualisiert.

Regel 3 trifft zu, daher geht der Vorgang weiter mit „Kampagne senden“.

Der Switch leitet das Ereignis unverändert weiter, sodass auch der nächste Knoten $json.body auslesen kann.

Was der Knoten „HTTP-Anfrage“ gesendet hat Beispieldaten

POSThttps://alerts.example.com/hooks/whatsapp-replies

Content-Type: application/json

Dieser Knoten wird nur ausgeführt, wenn Regel 1 zutrifft.

POSThttps://alerts.example.com/hooks/whatsapp-replies

Content-Type: application/json

conversationId aus {{ $json.body.data.conversationId }}contactId aus {{ $json.body.data.contactId }}

{
  "conversationId": "clsampleconv0000000000007",
  "contactId": "clsamplecontact0000000003"
}

200 OK

POSThttps://alerts.example.com/hooks/whatsapp-replies

Content-Type: application/json

Nicht ausgeführt. Der Switch hat dieses Ereignis an einen anderen Ausgang weitergeleitet.

Da bei der Nachricht eine ID angegeben ist und nicht die Antwort selbst, eröffnet Ihr Team die Konversation im Flowella-Posteingang und beantwortet sie dort.

Was der Knoten „HTTP-Anfrage“ gesendet hat Beispieldaten

POSThttps://lists.example.com/v1/unsubscribes

Content-Type: application/json

Dieser Knoten wird nur ausgeführt, wenn Regel 2 zutrifft.

POSThttps://lists.example.com/v1/unsubscribes

Content-Type: application/json

phone aus {{ $json.body.data.phone }}reason aus {{ $json.body.data.reason }}

{
  "phone": "+447700900123",
  "reason": "USER_KEYWORD"
}

200 OK

POSThttps://lists.example.com/v1/unsubscribes

Content-Type: application/json

Nicht ausgeführt. Der Switch hat dieses Ereignis an einen anderen Ausgang weitergeleitet.

„optout.created“ ist das Ereignis, das eine Telefonnummer enthält, sodass auch Ihre anderen Tools keine Nachrichten mehr an sie senden können.

Was der Knoten „HTTP-Anfrage“ gesendet hat Beispieldaten

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

Authorization: Bearer flo_(verdeckt)Aus Ihren n8n-Anmeldedaten
Content-Type: application/json

Dieser Knoten wird nur ausgeführt, wenn Regel 3 zutrifft.

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

Authorization: Bearer flo_(verdeckt)Aus Ihren n8n-Anmeldedaten
Content-Type: application/json
Idempotency-Key: 6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10

templateId aus {{ $json.body.data.metaTemplateId }}Idempotency-Key aus {{ $json.body.id }}, Eine erneute Zustellung erfolgt also niemals zweimal.recipients aus der Mitgliederliste, die n8n führt

{
  "templateId": "1234567890123456",
  "whatsappChannelId": "clsamplechannel0000000001",
  "recipients": [
    { "phone": "+447700900123", "bodyParameters": ["Ada"] },
    { "phone": "+447700900456", "bodyParameters": ["Ben"] }
  ]
}

202 Accepted{ "id": "v1ts-0123456789abcdef", "status": "accepted" }

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

Authorization: Bearer flo_(verdeckt)Aus Ihren n8n-Anmeldedaten
Content-Type: application/json

Nicht ausgeführt. Der Switch hat dieses Ereignis an einen anderen Ausgang weitergeleitet.

Speichern Sie den API-Schlüssel in einer n8n-Anmeldeinformation, niemals im Workflow selbst. „202 Accepted“ bedeutet, dass Flowella den Versand in die Warteschlange gestellt hat und ihn im Hintergrund ausführt.

Wählen Sie ein Beispielereignis aus und senden Sie es. Jeder Knoten leuchtet auf, sobald die Nutzlast ihn erreicht. Das Ereignis durchläuft gerade den Workflow. „message.received“ enthält IDs und nicht den Wortlaut der Antwort, daher leitet der Switch die Nachricht an „Alert“ weiter, um das Team über die Konversations-ID zu informieren. Ihr Team antwortet im Flowella-Posteingang. „optout.created“ enthält Adas Telefonnummer, sodass der Switch diese an „Update the mailing list“ weiterleitet, wodurch sie aus Ihrer Liste entfernt wird. „template.status_updated“ lautet „APPROVED“, daher leitet der Switch die Vorlage an „Kampagne versenden“ weiter, wodurch die Vorlage über die Flowella-API an die Nummern auf Ihrer Liste gesendet wird.

Richten Sie es in drei Schritten ein.

Sie benötigen ein Flowella-Konto, das mit WhatsApp verknüpft ist, eine von Meta genehmigte Vorlage und einen n8n-Workflow. Dann:

Schritt 1: Webhook-Auslöser hinzufügen

Starten Sie den Workflow mit dem Webhook-Knoten von n8n, stellen Sie ihn auf „POST“ ein und kopieren Sie dessen Produktions-URL.

Webhook-KnotenBeispieldaten

Verfahren
POST

Pfad
flowella-events

URL
https://n8n.example.com/webhook/flowella-events

Zuhören
Ausgehende Webhooks
Schritt 2: Bei Flowella abonnieren

Fügen Sie unter „Einstellungen“ → „Webhooks“ diese URL hinzu, wählen Sie die gewünschten Ereignisse aus und speichern Sie das Signaturgeheimnis. Mit „Test senden“ wird ein „webhook.test“-Ereignis ausgelöst. Sie benötigen die Rolle „Eigentümer“ oder „Administrator“.

WebhooksBeispieldaten

Endpunkt
https://n8n.example.com/webhook/flowella-events

Veranstaltungen
message.received, optout.created, template.status_updated

Signaturgeheimnis
Gespeichert

Test gesendet
Webhook-Einstellungen
Schritt 3: Mit HTTP-Anfrage zurücksenden

Fügen Sie einen HTTP-Request-Knoten hinzu, der eine POST-Anfrage an /v1/templates/send sendet, wobei Ihr Flowella-API-Schlüssel in den Header-Anmeldeinformationen angegeben ist.

HTTP-Anfrage-KnotenBeispieldaten

Verfahren
POST

URL
https://api.flowella.io/v1/templates/send

Zugangsdaten
Header: Authorization

202 Angenommen
API-Referenz

Was heute schon funktioniert und was noch in Vorbereitung ist.

All das läuft über die Flowella-API und Webhooks, die bereits verfügbar sind. Ein Flowella-Knoten für n8n wird in Kürze verfügbar sein.

In Kürze verfügbar

Ein Flowella-Knoten für n8n

Wir werden hier veröffentlichen, wie es funktioniert, sobald es fertig ist. Bis dahin erfüllen der Webhook-Trigger und der HTTP-Request-Knoten von n8n diesen Zweck.

Gut zu wissen

Überprüfen Sie die UnterschriftJede Anfrage enthält „X-Flowella-Signature“, einen HMAC-SHA256-Hex-Digest des Rohtextes. Überprüfen Sie diesen, bevor Sie weitere Schritte unternehmen. Während Sie den geheimen Schlüssel rotieren, enthält „X-Flowella-Signature-Previous“ auch die Signatur des alten Schlüssels.
Antworten Sie innerhalb von 10 SekundenFlowella wartet bis zu 10 Sekunden auf einen 2xx-Code und versucht die Übermittlung höchstens dreimal im Abstand von jeweils 1 und 2 Sekunden. Reagiere zuerst und führe erst danach zeitaufwändige Aufgaben aus.
Es sind Wiederholungen zu erwartenEine erneut versendete Sendung hat dieselbe Umschlag-ID. Behalten Sie daher die bereits verarbeiteten IDs bei und behandeln Sie eine Wiederholung als „No-Op“.
IDs, keine Wörter„message.received“ enthält IDs, die Richtung und den Typ der Nachricht, jedoch niemals deren Text. Ihr Team liest die Antworten im Flowella-Posteingang und beantwortet sie dort.

Kostenlos loslegen

Ab heute erhältlich Funktioniert heute

Kompatibel mit jedem Tool, das HTTP-Anfragen sendet und empfängt, einschließlich n8n.

Webhook-Ereignisse, die Sie ab sofort abonnieren können

message.received
message.sent
message.delivered
message.read
message.failed
conversation.opened
conversation.closed
optout.created
template.status_updated
contact.created
contact.updated
contact.deleted

Außerdem „webhook.test“, das von „Send Test“ auf Abruf ausgelöst wird.

WhatsApp-Ereignisse, die Ihre n8n-Workflows steuern.

Löse ein Ereignis aus, verfolge die Nutzdaten.

Richten Sie es in drei Schritten ein.

Schritt 1: Webhook-Auslöser hinzufügen

Schritt 2: Bei Flowella abonnieren

Schritt 3: Mit HTTP-Anfrage zurücksenden

Was heute schon funktioniert und was noch in Vorbereitung ist.

Ein Flowella-Knoten für n8n

Beginnen Sie mit Flowella und n8n zu entwickeln.