So funktioniert die Integration
Bevor Sie beginnen
- Eine Flowella-Organisation mit einer verbundenen WhatsApp-Nummer. Siehe Einrichtungsreihenfolge.
- Eine freigegebene WhatsApp-Vorlage in Flowella. Siehe Vorlagen.
- Die Rolle Owner oder Admin in Flowella, um einen API-Schlüssel und für die eingehende Synchronisierung einen Webhook zu erstellen. Siehe Team und Rollen.
- Ein Customer.io-Workspace, in dem Sie Kampagnen oder Automatisierungen mit Webhook-Aktionen erstellen können.
- Die WhatsApp-Nummer jeder Person im internationalen Format in ihrem Customer.io-Profil, etwa
+447700900123. Siehe Telefonnummernformat. - Die Zustimmung jeder Person, WhatsApp-Nachrichten von Ihnen zu erhalten. Meta verlangt ein Opt-in, bevor Sie jemandem schreiben. Siehe Metas Hinweise zum Opt-in.
Eine WhatsApp-Vorlage aus Customer.io senden
Einen Flowella-API-Schlüssel erstellen
Customer.io production. Kopieren Sie ihn sofort: Flowella zeigt ihn nur einmal an. Siehe API-Schlüssel.Vorlagen- und Kanal-IDs ermitteln
GET /v1/templates?status=APPROVED auf. Notieren Sie die id und wabaId der Vorlage und die whatsappChannelId der Nummer, von der Sie senden möchten. Siehe Mehrere Kanäle, wenn Sie mehrere Nummern haben.Ihrer Kampagne eine Webhook-Aktion hinzufügen
Die Anfrage festlegen
POST und die URL auf https://api.flowella.io/v1/templates/send. Fügen Sie diese Header hinzu:Den Anfrage-Body schreiben
customer.phone in das Attribut, das die WhatsApp-Nummer der Person enthält.bodyParameters füllt die Textvariablen der Vorlage der Reihe nach: Der erste Wert kommt in {{1}}, der zweite in {{2}} und so weiter. Lassen Sie die Liste leer, [], wenn die Vorlage keine Textvariablen hat.Die Aktion testen
Idempotency-Key mit einem Wert hinzu, den Sie noch nicht verwendet haben, etwa test-2026-11-11-01, und ändern Sie ihn bei jedem Test. Siehe Wiederholte Sendungen und Idempotenz.Eine Antwort 202 mit "status": "accepted" bedeutet, dass Flowella den Versand in die Warteschlange gestellt hat. Sie bestätigt keine Zustellung: Prüfen Sie das Ergebnis auf dem Tab Statistics der Vorlage in Flowella.Den Test-Header entfernen und die Kampagne starten
Idempotency-Key, den Sie zum Testen verwendet haben, oder ersetzen Sie ihn durch einen Wert, der für jede Person anders ist. Starten Sie dann die Kampagne.Vorlagenoptionen pro Person
Der Anfrage-Body akzeptiert für jeden Empfänger diese Felder. Die API-Einführung und das OpenAPI-Dokument beschreiben die vollständige Anfrage.headerMedia.url einen öffentlichen Dateilink angeben.
Wiederholte Sendungen und Idempotenz
POST /v1/templates/send schützt Sie davor, dieselbe Nachricht zweimal zu senden. Das ist wichtig, weil Customer.io eine Webhook-Aktion wiederholt, wenn es keine Antwort 2xx erhält:
- Ohne Header
Idempotency-Keyverwendet Flowella einen Hash des Anfrage-Bodys als Schlüssel. Ein byte-identischer Body innerhalb von 7 Tagen gibt die ursprünglicheidzurück und sendet nichts. Da der Body jeder Person ihre eigene Nummer enthält, sendet eine normale Kampagne an alle genau einmal. - Mit einem Header
Idempotency-Keygibt jede Anfrage mit demselben Schlüssel innerhalb von 7 Tagen die ursprünglicheidzurück und sendet nichts, auch wenn sich der Body geändert hat. - Unabhängig davon überspringt Flowella einen zweiten Versand derselben Vorlage an dieselbe Nummer innerhalb von 15 Sekunden.
Idempotency-Key jedes Mal.
An ein großes Segment senden
Jede Anfrage von Customer.io stellt einen Versand in die Warteschlange. Flowella stellt ihn im Hintergrund zu und wiederholt ihn bei vorübergehenden WhatsApp-Fehlern. Für große Kampagnen gelten zwei Limits:- Metas Messaging-Limit. Meta begrenzt, wie viele Personen Sie innerhalb von gleitenden 24 Stunden außerhalb des 24-Stunden-Fensters anschreiben können. Siehe Messaging-Limits.
- Das Ratenlimit Ihres API-Schlüssels. Anfragen über dem Limit geben
429mit einem HeaderRetry-Afterzurück. Siehe Ratenlimits.
Eingehende WhatsApp-Nachrichten an Customer.io (optional)
Dieser Teil sendet jede WhatsApp-Nachricht, die ein Kontakt Ihnen schickt, an Customer.io, damit Sie die Person aktualisieren oder daraus weitere Kampagnen starten können.Eine per Webhook ausgelöste Automatisierung in Customer.io erstellen
Einen ausgehenden Webhook in Flowella hinzufügen
message.received. Siehe Webhooks.Beispieldaten senden
message.received erhält, aus dem Sie den Workflow aufbauen. Jedes Ereignis sieht so aus:webhook.test, das keinen Kontakt hat. Filtern Sie es daher im nächsten Schritt heraus.Nur echte eingehende Nachrichten behalten
type des Auslösers message.received ist.Den Kontakt in Flowella nachschlagen
GET, der URL https://api.flowella.io/v1/contacts/{{trigger.data.contactId}} und demselben Header Authorization wie zuvor hinzu. Die Antwort enthält id, phone, waId, name, email, externalId, isOptedOut, createdAt und updatedAt des Kontakts.Um die Nachricht selbst zu speichern, fügen Sie eine weitere Anfrage an GET /v1/messages/{{trigger.data.messageId}} hinzu. Ihr Feld body enthält den Nachrichtentext und kann leer sein.Die Person aktualisieren
Sicherheit des eingehenden Webhooks
Flowella signiert jede Anfrage mit dem HeaderX-Flowella-Signature. Eine per Webhook ausgelöste Automatisierung in Customer.io kann diese Signatur nicht prüfen. Daher kann jeder, der die Customer.io-Webhook-URL kennt, Daten daran senden. Halten Sie die URL geheim und verwenden Sie die eingehende Synchronisierung nicht, um Einwilligungs- oder Abrechnungsattribute zu ändern. Siehe Signaturen prüfen, wenn Sie Ereignisse zuerst über Ihren eigenen Endpunkt leiten.
Opt-outs
Wenn ein KontaktSTOP oder ein anderes Opt-out-Schlüsselwort sendet, erfasst Flowella das Opt-out für diese WhatsApp-Nummer und blockiert jeden späteren Versand von dieser Nummer an ihn, auch Sendungen aus Customer.io. Siehe Opt-outs.
Um Opt-outs nach Customer.io zu übertragen, verlassen Sie sich nicht auf das Ereignis optout.created: Es wird derzeit beim ersten Opt-out eines Kontakts für eine Nummer nicht ausgelöst. Listen Sie Opt-outs stattdessen mit GET /v1/opt-outs auf. Der Endpunkt akzeptiert die Filter createdAfter und phone.

