Auf Flowella aufbauen, programmgesteuert.
Wenn die No-Code-Tools eine Funktion nicht abdecken, übernehmen dies die Flowella-REST-API und ausgehende Webhooks. 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 und Änderungen an Vorlagen zu reagieren – ganz ohne Abfrage.
Ruf einfach an, und es wird dich zurückrufen.
Zwei Richtungen, eine Engine. Ihre Anwendung ruft die REST-API auf, um Vorgänge auszulösen: eine Vorlage senden, einen Kontakt aktualisieren, Analysedaten abrufen. In der anderen Richtung sendet Flowella signierte Webhook-Ereignisse an Ihren Endpunkt, sobald etwas passiert, sodass Sie sofort reagieren können, anstatt ständig abzufragen. Zusammen ermöglichen sie es Ihnen, auf Basis derselben WhatsApp- und HubSpot-Engine alles zu entwickeln, was Ihr Stack benötigt.
Versenden, verwalten und Berichte erstellen
Eine unkomplizierte REST-API der Version 1 mit Bearer-Key-Authentifizierung und vorhersehbarem Verhalten.
Die REST-API ist in Version 1 unter https://app.flowella.io/api/v1 verfügbar. Jede Anfrage enthält im „Authorization“-Header einen organisationsspezifischen Bearer-Schlüssel, der von einem Eigentümer oder Administrator unter „Einstellungen“ > „API-Schlüssel“ erstellt und nur einmal angezeigt wird. Listen-Endpunkte verwenden Cursor-Paginierung mit einer Begrenzung von eins bis hundert, Fehler werden in einem einheitlichen Format mit einem stabilen Code-Feld zurückgegeben, und Anfragen sind pro Organisation rate-begrenzt, wobei bei zu schnellem Zugriff ein 429-Fehler ausgegeben wird. Telefonnummern sollten am besten im E.164-Format übergeben werden, und eine maschinenlesbare OpenAPI-Spezifikation lässt sich direkt in Postman oder einen Code-Generator einfügen.
Für große Massenversendungen akzeptiert der Endpunkt „Senden von Vorlagen“ einen Parameter für die stündliche Drosselung, sodass Flowella die Zustellung serverseitig steuert, anstatt dass Sie die Anfragen selbst drosseln müssen.
In Echtzeit auf Ereignisse reagieren
Abonnieren Sie die Ereignisse, die Sie interessieren, und Flowella sendet Ihnen in Echtzeit signierte Datenpakete.
| Ereignis | Wenn sie ausgelöst wird |
|---|---|
| message.received | Eine eingehende WhatsApp-Nachricht von einem Kontakt trifft ein |
| message.sent | Flowella hat Ihre ausgehende Nachricht angenommen und an Meta übermittelt |
| message.delivered | Meta hat die Zustellung an das Gerät des Empfängers bestätigt |
| message.read | Der Empfänger hat die Nachricht geöffnet |
| message.failed | Meta hat einen Fehler für die Nachricht zurückgegeben |
| conversation.opened / closed | Der Status einer Konversation hat sich geändert |
| optout.created | Ein Kontakt hat sich von einem Kanal abgemeldet |
| template.status_updated | Meta hat den Status einer Vorlage geändert |
Jede Anfrage ist mit einem HMAC-SHA256-Hex-Digest des Rohtextes signiert; überprüfen Sie daher die Signatur vor der Verarbeitung. Flowella wartet bis zu zehn Sekunden auf einen 2xx-Status, versucht es bis zu dreimal mit Backoff und deaktiviert einen Endpunkt automatisch nach zehn aufeinanderfolgenden Fehlern. Da Wiederholungsversuche ein Ereignis duplizieren können, verwenden Sie die Ereignis-ID als Idempotenzschlüssel und behandeln Sie Duplikate als No-Ops.
Zuerst ohne Programmierung, Programmieren erst, wenn es nötig ist.
Die API erweitert das Produkt. Sie ersetzt nicht die Teile, die bereits ohne Programmierung funktionieren.
Beginnen Sie hier mit den üblichen Stellen.
Das meiste, was Teams benötigen, wie das Senden von Vorlagen, das Erfassen von Flow-Antworten und das Auslösen von Automatisierungsvorgängen, ist bereits abgedeckt, ohne dass die API berührt werden muss. Greifen Sie nur dann zum Code, wenn Sie etwas darüber hinaus benötigen.
- Form to Flow, native HubSpot-Synchronisierung
- Workflow-Aktionen und der Posteingang
- Kein Code zu schreiben
Greifen Sie nach dem Code, wenn Sie mehr brauchen.
Wenn Sie WhatsApp in ein benutzerdefiniertes System einbinden, mit einem Tool ohne nativen Anschluss synchronisieren oder auf Ereignisse in Ihrem eigenen Backend reagieren müssen, geben Ihnen die API und Webhooks die volle Kontrolle.
- Individuelle Anwendungen und maßgeschneiderte Integrationen
- Reagieren auf Ereignisse ohne Polling
- Massensendungen mit serverseitiger Drosselung
- ⏱️ 30 seconds · Card on file
- 👤 With · Membership team
- 📩 Receipt sent here after renewal
Choose your plan
- 🏆 Annual · £49 ✓
- 🎯 Quarterly · £15 ✓
- 📅 Monthly · £6 ✓
Powered by Flowella · Secure renewal
Direkte Antworten.
Fragen, die Entwickler stellen.
Wie kann ich mich authentifizieren?
Ein organisationsweiter Bearer-Schlüssel, der von einem Eigentümer oder Administrator unter „Einstellungen“ > „API-Schlüssel“ erstellt wird. Er wird nur einmal bei der Erstellung angezeigt; bewahren Sie ihn daher sicher auf und ersetzen Sie ihn, wenn Teammitglieder das Unternehmen verlassen.
Was kann die API leisten?
WhatsApp-Nachrichten und Vorlagen versenden, Kontakte und Abmeldungen verwalten, Vorlagen auflisten und als Massen-SMS versenden sowie Analysedaten abrufen. Die vollständige Liste der Endpunkte wird automatisch aus der OpenAPI-Spezifikation generiert.
Kann ich umfangreiche Massensendungen durchführen?
Ja. Verwenden Sie den Endpunkt „send“ der Vorlagen mit dem Parameter „throttle-per-hour“, und Flowella sorgt serverseitig für die Einhaltung der Rate, sodass Sie sich nicht selbst um die Zeit- oder Zugriffsbeschränkungen kümmern müssen.
Wie kann ich überprüfen, ob ein Webhook echt ist?
Jeder Webhook wird mit einem HMAC-SHA256-Digest des rohen Anfragetextes signiert. Berechnen Sie denselben Digest mit Ihrem Signaturschlüssel und vergleichen Sie die Ergebnisse, wobei Sie die rohen Bytes vor der JSON-Analyse signieren.
Was ist, wenn mein Endpunkt ausgefallen ist?
Flowella unternimmt bis zu drei Wiederholungsversuche mit Backoff und deaktiviert den Endpunkt automatisch nach zehn aufeinanderfolgenden Fehlversuchen. Aktivieren Sie ihn erneut unter „Einstellungen“, „Webhooks“, sobald Ihr Endpunkt repariert ist.
Wie vermeide ich die Verarbeitung von Duplikaten?
Verwende die Ereignis-ID als Idempotenzschlüssel, speichere verarbeitete Schlüssel in einem kurzlebigen Cache und behandle Wiederholungen als No-Ops. Wiederholungsversuche bedeuten, dass dasselbe Ereignis mehrmals eintreffen kann.
Lies die Entwicklerdokumentation
Alle Inhalte dieser Seite, einschließlich der vollständigen Referenz und der Code-Beispiele, finden Sie in der Dokumentation.
Die vollständige Entwicklerreferenz finden Sie in der Wissensdatenbank.
Die API-Einführung behandelt die Basis-URL, Authentifizierung, Fehler, Paginierung, Ratenbegrenzungen und die OpenAPI-Spezifikation.
Ausgehende Webhooks behandelt die Konfiguration eines Webhooks, die vollständige Ereignisliste, die Signaturüberprüfung, Wiederholungsversuche und Idempotenz, einschließlich Code-Beispielen.
Bauen Sie auf derselben Basis auf – ganz nach Ihren Vorstellungen.
