Χτίστε πάνω στο Flowella, με τον δικό σας κώδικα.

Όταν τα εργαλεία χωρίς κώδικα δεν καλύπτουν κάποια λειτουργία, το REST API της Flowella και τα εξερχόμενα webhooks αναλαμβάνουν. Καλέστε το API για να στείλετε μηνύματα WhatsApp, να διαχειριστείτε επαφές και διαγραφές, καθώς και να λάβετε αναλυτικά στοιχεία. Εγγραφείτε στα webhooks για να αντιδράτε σε μηνύματα, παραδόσεις, διαγραφές, επαφές και αλλαγές προτύπων τη στιγμή που συμβαίνουν, χωρίς να απαιτείται συνεχής έλεγχος.

Ξεκινήστε δωρεάν
Βαθμολογία 5/5 στο HubSpot Marketplace (ανοίγει σε νέα καρτέλα)
Δεν απαιτείται ψηφοφορία Η Φλο, η μασκότ της Flowella, συνδέει ένα μεγάλο βύσμα σε μια πρίζα πάνω σε ένα πλωτό πάνελ
Βασική διεύθυνση URL
api.flowella.io/v1
Πιστοποίηση
Ένα κλειδί χωρίς ονομαστικό που αρχίζει με «flo_»
Συμβάντα Webhook
12, το καθένα υπογεγραμμένο με HMAC-SHA256
Παράδοση
3 προσπάθειες, ένα τάιμ-άουτ 10 δευτερολέπτων

Κάλεσέ το, και άφησέ το να σου τηλεφωνήσει.

Δύο κατευθύνσεις, ένας κινητήρας. Η εφαρμογή σας καλεί το REST API για να εκτελέσει τις ενέργειες, ενώ η Flowella αποστέλλει υπογεγραμμένα συμβάντα webhook στο endpoint σας τη στιγμή που συμβαίνει κάτι, ώστε να αντιδράτε αντί να πραγματοποιείτε συνεχείς ελέγχους. Στείλτε ένα πρότυπο και, στη συνέχεια, παρακολουθήστε τα συμβάντα.

Η Φλο συνδέει χρωματιστά καλώδια σε έναν πίνακα διανομής
Η εφαρμογή σαςΚαλεί το API της Flowella
Ενδεικτικά δεδομένα

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

Κεφαλίδες

Authorization
Bearer flo_••••••••••••Το κλειδί API σας, με απόκρυψη
Content-Type
application/json
Idempotency-Key
renewal-2026-10-16-1Αν επαναλάβετε αυτό το κλειδί μέσα σε επτά ημέρες, παίρνετε την ίδια εργασία.

Σώμα

{
  "templateId": "cltemplate00000001",
  "whatsappChannelId": "clchannel000000001",
  "recipients": [
    {
      "phone": "+447700900123",
      "bodyParameters": ["Sam"]
    }
  ]
}
Η απάντηση του Flowella202 Accepted
{
  "id": "v1ts-3f9a07c2b1d4e6a8",
  "status": "accepted"
}

Σε ουρά. Το Flowella το στέλνει στο παρασκήνιο.

Acme ClubΕπαγγελματικός λογαριασμός
Ενδεικτικά δεδομένα

Σήμερα

Γεια σας Sam, Η συνδρομή σου στο Acme Club ανανεώνεται στις 31 Οκτωβρίου. Ανανέωσέ την σε ένα λεπτό, εδώ στο WhatsApp.
Το τερματικό σαςΛαμβάνει τα webhooks της Flowella
Ενδεικτικά δεδομένα

Παραδόσεις

POSThttps://example.com/webhooks/flowella

Content-Type
application/json
X-Flowella-Signature
5c2e91…a07f3bΈγκυρη
{
  "id": "evt_9a4f1d06c3e84b27a5d9e2b70c6f8d14",
  "type": "message.read",
  "created_at": "2026-10-16T09:14:21.000Z",
  "payload_version": "1",
  "data": { … }
}

Στο data: το messageId του μηνύματος.

Το Flowella περιμένει έως και 10 δευτερόλεπτα για έναν κωδικό 2xx και προσπαθεί να πραγματοποιήσει κάθε αποστολή το πολύ 3 φορές, με διαφορά 1 και 2 δευτερολέπτων μεταξύ τους.

Τα message.sent, message.delivered και message.read έφτασαν στο endpoint σας, το καθένα υπογεγραμμένο.

Εγγραφείτε σε οποιαδήποτε από τις 12 εκδηλώσεις.

Επιλέξτε τα συμβάντα που χρειάζεστε στις «Ρυθμίσεις», στην ενότητα «Webhooks». Κάθε συμβάν φτάνει ως υπογεγραμμένη αίτηση POST με το δικό του αναγνωριστικό, τον τύπο του, την ώρα που συνέβη και τα δεδομένα του.

Μηνύματα

message.received
Λαμβάνεται ένα εισερχόμενο μήνυμα WhatsApp από μια επαφή
message.sent
Η Flowella δέχτηκε το μήνυμά σας και το διαβίβασε στη Meta
message.delivered
Η Meta επιβεβαίωσε την παράδοση στη συσκευή του παραλήπτη
message.read
Ο παραλήπτης άνοιξε το μήνυμα
message.failed
Το Meta επέστρεψε σφάλμα για το μήνυμα

Συζητήσεις

conversation.opened
Μια συνομιλία μεταφέρθηκε σε ανοιχτή κατάσταση
conversation.closed
Μια συνομιλία έκλεισε

Δυνατότητες εξαίρεσης

optout.created
Ένας επαφής αποεγράφη από ένα κανάλι

Πρότυπα

template.status_updated
Η Meta άλλαξε την κατάσταση ενός προτύπου: εγκρίθηκε, απορρίφθηκε, τέθηκε σε αναστολή ή απενεργοποιήθηκε

Επαφές

contact.created
Δημιουργήθηκε μια επαφή
contact.updated
Ενημερώθηκε μια επαφή
contact.deleted
Διαγράφηκε μια επαφή

Επιπλέον, το webhook.test, το οποίο αποστέλλεται μόνο όταν πατήσετε το κουμπί «Αποστολή δοκιμής».

Αποστολή, διαχείριση και αναφορά.

Ένα απλό REST API έκδοσης v1 στη διεύθυνση api.flowella.io/v1, με έλεγχο ταυτότητας τύπου «bearer-key» και προβλέψιμη συμπεριφορά.

  • Αποστολή μηνυμάτων και προτύπων

    Στείλτε ένα μήνυμα κειμένου μέσω WhatsApp ή προγραμματίστε την αποστολή ενός προτύπου σε πολλούς παραλήπτες με μία μόνο αίτηση. Προσθέστε το «throttlePerHour» και το Flowella θα ρυθμίσει για εσάς την αποστολή μεγάλου όγκου μηνυμάτων.

  • Επαφές και διαγραφές

    Δημιουργήστε ή ενημερώστε επαφές, περιηγηθείτε σε αυτές και ορίστε ή καταργήστε την επιλογή εξαίρεσης μιας επαφής από το WhatsApp σε ένα κανάλι.

  • Συζητήσεις και αναλυτικά στοιχεία

    Καταγράψτε τις συνομιλίες και τα πρότυπα και ενσωματώστε τα αναλυτικά στοιχεία για τα εξερχόμενα μηνύματα στις δικές σας αναφορές.

  • Πλήκτρα που ελέγχετε

    Οι ιδιοκτήτες και οι διαχειριστές δημιουργούν κλειδιά στην ενότητα «Ρυθμίσεις», «Κλειδιά API». Κάθε κλειδί ξεκινά με «flo_», εμφανίζεται μία φορά και μπορεί να περιοριστεί στα πεδία εφαρμογής που απαιτούνται.

  • Μπορείτε να ξαναδοκιμάσετε με ασφάλεια

    Η αποστολή ενός κλειδιού ιδεμπότενσης (Idempotency-Key) με μια αποστολή βάσει προτύπου και μια επανάληψη εντός επτά ημερών επιστρέφει την ίδια εργασία, οπότε το σύστημα χρονικού ορίου δεν στέλνει ποτέ το ίδιο μήνυμα σε κανέναν δύο φορές.

  • Πρώτα χωρίς κώδικα, κώδικας μόνο όταν τον χρειάζεσαι

    Οι ροές εργασιών του HubSpot στέλνουν ήδη πρότυπα με έως και 20 μεταβλητές ανά επαφή, χωρίς να απαιτείται κώδικας. Χρησιμοποιήστε το API για ό,τι δεν μπορούν να στείλουν, όπως κωδικοί μίας χρήσης και κουμπιά με συνδέσμους ανά επαφή.

Με τα λόγια των πελατών μας.

Μια εξαιρετική πλατφόρμα αλληλεπίδρασης που μεταμόρφωσε τα ποσοστά προσέλκυσης φοιτητών μας, με αύξηση 160% στις αιτήσεις που υποβλήθηκαν την ίδια ημέρα και ποσοστά ανταπόκρισης μέσω WhatsApp 90%.

Peter Hudson Peter HudsonΔιευθυντής Εισαγωγών, Εταιρικής Εικόνας και Καινοτομίας για τους ΠελάτεςΕνσωμάτωση από το HubSpot Marketplace Oaklands CollegeOaklands College

Ένα επαναστατικό εργαλείο για εκστρατείες δωρεών, το οποίο προσφέρει εξατομικευμένη αλληλεπίδραση μέσω WhatsApp με απρόσκοπτη αυτοματοποίηση και σημαντικά υψηλότερα ποσοστά ολοκλήρωσης.

Lawrence Tribe-Endt Lawrence Tribe-EndtΕμπορικός Διευθυντής, Countryside AllianceCustomer.io μέσω του Flowella API Countryside Alliance
Δείτε όλες τις κριτικές στο HubSpot Marketplace (ανοίγει σε νέα καρτέλα) Κριτικές για το G2 (ανοίγει σε νέα καρτέλα)

Ευθείες απαντήσεις.

Οι ερωτήσεις που θέτουν οι προγραμματιστές. Αν η δική σας δεν περιλαμβάνεται εδώ, επικοινωνήστε μαζί μας.

Διαβάστε την αναφορά API

API και webhooks

Πώς μπορώ να πιστοποιήσω την ταυτότητά μου;

Με ένα κλειδί φορέα που ισχύει σε επίπεδο οργανισμού στην κεφαλίδα «Authorization». Οι ιδιοκτήτες και οι διαχειριστές δημιουργούν κλειδιά στην ενότητα «Ρυθμίσεις», «Κλειδιά API». Κάθε κλειδί ξεκινά με «flo_» και εμφανίζεται μόνο μία φορά, οπότε φυλάξτε το με ασφάλεια και αντικαταστήστε το όταν αποχωρούν μέλη της ομάδας.

Διαχείριση κλειδιών API

Τι μπορεί να κάνει το API;

Αποστολή μηνυμάτων και προτύπων WhatsApp, συμπεριλαμβανομένων κωδικών μίας χρήσης και κουμπιών με συνδέσμους ανά επαφή, δημιουργία και ενημέρωση επαφών, ρύθμιση ή κατάργηση επιλογών εξαίρεσης, προβολή λίστας συνομιλιών και προτύπων, καθώς και ανάκτηση στατιστικών στοιχείων για τα εξερχόμενα μηνύματα. Η λίστα των τελικών σημείων προέρχεται από τις προδιαγραφές του OpenAPI, οι οποίες μπορούν να εισαχθούν απευθείας στο Postman ή σε έναν γεννητή κώδικα.

Μπορώ να στείλω κωδικούς μίας χρήσης ή κουμπιά με συνδέσμους για κάθε επαφή;

Ναι, μέσω του API, και μόνο από εκεί. Το κουμπί «Αντιγραφή κώδικα» απαιτεί τον κωδικό του σε κάθε αποστολή, ενώ μόνο το API δημιουργεί ένα κουμπί συνδέσμου για κάθε άτομο: από μια ροή εργασιών του HubSpot, όλοι λαμβάνουν τον ίδιο εφεδρικό σύνδεσμο του προτύπου. Για να στείλετε έναν σύνδεσμο ανά επαφή από το HubSpot, τοποθετήστε τον σε μια μεταβλητή κειμένου, όπου το WhatsApp τον καθιστά ενεργό για πάτημα. Οι κωδικοί μπορούν να έχουν έως 15 χαρακτήρες, ενώ η αποστολή του ίδιου προτύπου στον ίδιο αριθμό εντός 15 δευτερολέπτων απορρίπτεται. Το API επιστρέφει τον κωδικό κατάστασης 202 και πραγματοποιεί την αποστολή αμέσως, εκτός αν έχετε ορίσει το «scheduledAt».

Τι πρέπει να γνωρίζω πριν από την πρώτη μου κλήση;

Η βασική διεύθυνση URL είναι https://api.flowella.io/v1. Οι λίστες χρησιμοποιούν σελιδοποίηση με δείκτη, με όριο από 1 έως 100, τα σφάλματα περιλαμβάνονται σε ένα ενιαίο μήνυμα με σταθερό κωδικό, ενώ για κάθε οργανισμό ισχύει περιορισμός ρυθμού, με κωδικό σφάλματος 429 και κεφαλίδα «Retry-After» σε περίπτωση υπερβολικά γρήγορης πρόσβασης. Δηλώστε τους αριθμούς τηλεφώνου σε μορφή E.164.

Εισαγωγή στο API

Μπορώ να κάνω μαζικές αποστολές;

Ναι. Η κλήση POST /v1/templates/send θέτει την αποστολή σε ουρά και επιστρέφει τον κωδικό απόκρισης 202 Accepted μαζί με ένα αναγνωριστικό εργασίας. Η προσθήκη του παραμέτρου throttlePerHour και του Flowella ρυθμίζει τον ρυθμό παράδοσης από την πλευρά του διακομιστή. Η προσθήκη ενός Idempotency-Key και η επανάληψη εντός επτά ημερών επιστρέφει την ίδια εργασία αντί να πραγματοποιηθεί εκ νέου αποστολή.

Πώς μπορώ να επαληθεύσω ότι ένα webhook είναι γνήσιο;

Κάθε αποστολή περιλαμβάνει το X-Flowella-Signature, ένα εξαδικό άθροισμα HMAC-SHA256 του ακατέργαστου σώματος του μηνύματος, το οποίο δημιουργείται με το μυστικό υπογραφής σας. Υπολογίστε το ίδιο άθροισμα πάνω στα ακατέργαστα byte, πριν από οποιαδήποτε ανάλυση JSON, και συγκρίνετε τα αποτελέσματα. Κατά τη διάρκεια μιας εναλλαγής μυστικού, το X-Flowella-Signature-Previous περιλαμβάνει το άθροισμα που δημιουργήθηκε με το παλιό μυστικό.

Εξερχόμενα webhooks

Τι γίνεται αν το τελικό μου σημείο είναι εκτός λειτουργίας;

Το Flowella περιμένει έως και 10 δευτερόλεπτα για έναν κωδικό κατάστασης 2xx και προσπαθεί να πραγματοποιήσει κάθε αποστολή το πολύ 3 φορές, με διαφορά 1 και 2 δευτερολέπτων μεταξύ τους, οπότε απαντήστε γρήγορα και ασχοληθείτε με το υπόλοιπο μετά. Στην ενότητα «Ρυθμίσεις», στο «Webhooks» εμφανίζονται οι πρόσφατες αποστολές για κάθε τελικό σημείο.

Πώς μπορώ να αποφύγω την επεξεργασία διπλοτύπων;

Μια επανάληψη μπορεί να παραδώσει το ίδιο συμβάν δύο φορές. Κάθε παράδοση φέρει τον αναγνωριστικό του συμβάντος στο ανώτατο επίπεδο, ο οποίος είναι ο ίδιος σε κάθε επανάληψη, οπότε διατηρήστε μια προσωρινή καταγραφή των αναγνωριστικών που έχετε επεξεργαστεί και αντιμετωπίστε τις επαναλήψεις ως «no-ops».

Η μεταβλητή `message.received` περιλαμβάνει το κείμενο του μηνύματος;

Όχι. Περιέχει τους κωδικούς αναγνώρισης του μηνύματος, της συνομιλίας και της επαφής, καθώς και την κατεύθυνση και τον τύπο, αλλά όχι τον αριθμό τηλεφώνου ή το κείμενο του μηνύματος, και το API δεν διαθέτει κλήση για την ανάγνωση ενός μεμονωμένου μηνύματος. Η συνάρτηση `optout.created` περιέχει τον αριθμό τηλεφώνου και τον λόγο.

Η Φλο πηδάει από χαρά με τη γροθιά της υψωμένη και το κινητό στο χέρι

Χτίστε πάνω στον ίδιο κινητήρα, με τον δικό σας τρόπο.

Ξεκινήστε με τα εργαλεία χωρίς κώδικα και, στη συνέχεια, αξιοποιήστε το API και τα webhooks όταν το περιβάλλον σας χρειαστεί περισσότερες δυνατότητες. Η εγκατάσταση του Flowella διαρκεί περίπου 30 λεπτά, ενώ προσφέρεται δωρεάν δοκιμαστική περίοδος 14 ημερών χωρίς να απαιτείται πιστωτική κάρτα.

Ξεκινήστε δωρεάν Δοκιμάστε το στο WhatsApp (ανοίγει σε νέα καρτέλα)
Κλείστε μια επίδειξη του Flowella · 30 λεπτά μέσω του Teams