Αναπτύξτε εφαρμογές πάνω στο Flowella, μέσω προγραμματισμού.
Όταν τα εργαλεία χωρίς κώδικα δεν καλύπτουν κάποια λειτουργία, το REST API της Flowella και τα εξερχόμενα webhooks αναλαμβάνουν. Χρησιμοποιήστε το API για να στέλνετε μηνύματα WhatsApp, να διαχειρίζεστε επαφές και διαγραφές, καθώς και να λαμβάνετε αναλυτικά στοιχεία. Εγγραφείτε στα webhooks για να αντιδράτε σε μηνύματα, παραδόσεις, διαγραφές και αλλαγές προτύπων σε πραγματικό χρόνο, χωρίς να απαιτείται συνεχής έλεγχος.
Κάλεσέ το, και άφησέ το να σου τηλεφωνήσει.
Δύο κατευθύνσεις, ένας κινητήρας. Η εφαρμογή σας καλεί το REST API για να εκτελέσει διάφορες λειτουργίες: αποστολή προτύπου, ενημέρωση επαφής, λήψη αναλυτικών στοιχείων. Από την άλλη πλευρά, το Flowella στέλνει υπογεγραμμένα συμβάντα webhook στο endpoint σας τη στιγμή που συμβαίνει κάτι, ώστε να μπορείτε να αντιδράσετε άμεσα αντί να κάνετε συνεχή έλεγχο. Μαζί, σας επιτρέπουν να δημιουργήσετε ό,τι χρειάζεται το stack σας, βασιζόμενοι στον ίδιο κινητήρα WhatsApp και HubSpot.
Αποστολή, διαχείριση και αναφορά
Ένα απλό REST API έκδοσης 1 με έλεγχο ταυτότητας τύπου «bearer-key» και προβλέψιμη συμπεριφορά.
Το REST API είναι της έκδοσης v1 και βρίσκεται στη διεύθυνση https://app.flowella.io/api/v1. Κάθε αίτημα περιλαμβάνει ένα κλειδί bearer με εύρος ισχύος σε επίπεδο οργανισμού στην κεφαλίδα Authorization, το οποίο δημιουργείται από τον Ιδιοκτήτη ή τον Διαχειριστή στην ενότητα «Ρυθμίσεις, Κλειδιά API» και εμφανίζεται μόνο μία φορά. Τα τελικά σημεία λίστας χρησιμοποιούν σελιδοποίηση με δρομέα με όριο από ένα έως εκατό, τα σφάλματα επιστρέφονται σε ένα συνεπές φάκελο με ένα σταθερό πεδίο κωδικού και τα αιτήματα περιορίζονται ανά οργανισμό με ένα 429 όταν προχωράτε πολύ γρήγορα. Οι αριθμοί τηλεφώνου μεταφέρονται καλύτερα σε μορφή E.164 και μια προδιαγραφή OpenAPI αναγνώσιμη από μηχανή εισάγεται απευθείας στο Postman ή σε έναν γεννητή κώδικα.
Για μαζικές αποστολές μεγάλου όγκου, το endpoint αποστολής προτύπων δέχεται μια παράμετρο περιορισμού ανά ώρα, ώστε η Flowella να ρυθμίζει τον ρυθμό παράδοσης από την πλευρά του διακομιστή, αντί να ρυθμίζετε εσείς οι ίδιοι τις αιτήσεις.
Ανταπόκριση σε γεγονότα σε πραγματικό χρόνο
Εγγραφείτε στις εκδηλώσεις που σας ενδιαφέρουν και η Flowella θα σας στέλνει ειδοποιήσεις τη στιγμή που αυτές πραγματοποιούνται.
| Εκδήλωση | Όταν ενεργοποιείται |
|---|---|
| message.received | Ένα εισερχόμενο μήνυμα WhatsApp φτάνει από μια επαφή |
| message.sent | Το Flowella δέχτηκε το εξερχόμενο μήνυμά σας και το υπέβαλε στο Meta |
| message.delivered | Η Meta επιβεβαίωσε την παράδοση στη συσκευή του παραλήπτη |
| message.read | Ο παραλήπτης άνοιξε το μήνυμα |
| message.failed | Το Meta επέστρεψε σφάλμα για το μήνυμα |
| συνομιλία.άνοιξε / έκλεισε | Η κατάσταση μιας συνομιλίας άλλαξε |
| optout.created | Μια επαφή αποχώρησε από ένα κανάλι |
| template.status_updated | Το Meta άλλαξε την κατάσταση ενός προτύπου |
Κάθε αίτημα υπογράφεται με ένα εξάγωνο HMAC-SHA256 του ακατέργαστου σώματος, οπότε επαληθεύστε την υπογραφή πριν από την επεξεργασία. Το Flowella περιμένει έως και δέκα δευτερόλεπτα για ένα 2xx, επαναλαμβάνει έως και τρεις φορές με backoff και απενεργοποιεί αυτόματα ένα τελικό σημείο μετά από δέκα συνεχόμενες αποτυχίες. Επειδή οι επαναλήψεις μπορούν να επαναλάβουν ένα συμβάν, χρησιμοποιήστε το αναγνωριστικό συμβάντος ως κλειδί ιδεμπότενσης και αντιμετωπίστε τα διπλότυπα ως no-ops.
Πρώτα χωρίς κώδικα, κώδικας μόνο όταν τον χρειάζεσαι.
Το API επεκτείνει τις δυνατότητες του προϊόντος. Δεν αντικαθιστά τα τμήματα που λειτουργούν ήδη χωρίς κώδικα.
Ξεκινήστε από εδώ για τις κοινές θέσεις εργασίας.
Τα περισσότερα από αυτά που χρειάζονται οι ομάδες, αποστολή προτύπων, καταγραφή απαντήσεων ροής, ενεργοποίηση αυτοματοποίησης, καλύπτονται ήδη χωρίς να αγγίξετε το API. Φτάνετε στον κώδικα μόνο όταν χρειάζεστε κάτι πέρα από αυτόν.
- Φόρμα σε Flow, εγγενής συγχρονισμός HubSpot
- Ενέργειες ροής εργασιών και εισερχόμενα
- Δεν χρειάζεται να γράψετε κώδικα
Πιάστε τον κωδικό όταν χρειάζεστε περισσότερα.
Όταν πρέπει να συνδέσετε το WhatsApp σε ένα προσαρμοσμένο σύστημα, να συγχρονίσετε με ένα εργαλείο χωρίς εγγενή σύνδεσμο ή να αντιδράσετε σε συμβάντα στο δικό σας backend, το API και τα webhooks σας δίνουν τον πλήρη έλεγχο.
- Προσαρμοσμένες εφαρμογές και ενσωμάτωση κατά παραγγελία
- Αντιδράστε σε συμβάντα χωρίς δημοσκοπήσεις
- Μαζικές αποστολές με περιορισμό από την πλευρά του διακομιστή
- ⏱️ 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
Ευθείες απαντήσεις.
Οι ερωτήσεις που θέτουν οι προγραμματιστές.
Πώς μπορώ να πιστοποιήσω την ταυτότητά μου;
Ένα κλειδί φορέα με εύρος ισχύος σε επίπεδο οργανισμού, το οποίο δημιουργείται από τις «Ρυθμίσεις», στην ενότητα «Κλειδιά API» από έναν ιδιοκτήτη ή διαχειριστή. Εμφανίζεται μόνο μία φορά κατά τη δημιουργία του, οπότε φροντίστε να το αποθηκεύσετε σε ασφαλές μέρος και να το αντικαθιστάτε όταν αποχωρούν μέλη της ομάδας.
Τι μπορεί να κάνει το API;
Αποστολή μηνυμάτων και προτύπων WhatsApp, διαχείριση επαφών και διαγραφών, καταχώριση και μαζική αποστολή προτύπων, καθώς και ανάκτηση αναλυτικών στοιχείων. Ο πλήρης κατάλογος των τελικών σημείων δημιουργείται αυτόματα από τις προδιαγραφές του OpenAPI.
Μπορώ να κάνω μαζικές αποστολές;
Ναι. Χρησιμοποιήστε το σημείο τερματισμού αποστολής προτύπων με την παράμετρο «throttle-per-hour» και η Flowella θα εφαρμόσει τον ρυθμό από την πλευρά του διακομιστή, οπότε δεν χρειάζεται να διαχειρίζεστε εσείς οι ίδιοι τα όρια χρονισμού ή συχνότητας αιτήσεων.
Πώς μπορώ να επαληθεύσω ότι ένα webhook είναι γνήσιο;
Κάθε webhook υπογράφεται με ένα σύνολο HMAC-SHA256 του ακατέργαστου σώματος του αιτήματος. Υπολογίστε το ίδιο σύνολο χρησιμοποιώντας το μυστικό υπογραφής σας και συγκρίνετε τα αποτελέσματα, υπογράφοντας τα ακατέργαστα byte πριν από οποιαδήποτε ανάλυση JSON.
Τι γίνεται αν το τελικό μου σημείο είναι εκτός λειτουργίας;
Το Flowella πραγματοποιεί έως και τρεις επαναληπτικές προσπάθειες με χρονική καθυστέρηση και απενεργοποιεί αυτόματα το σημείο τερματισμού μετά από δέκα συνεχόμενες αποτυχίες. Ενεργοποιήστε το ξανά από τις «Ρυθμίσεις», στην ενότητα «Webhooks», μόλις επιλυθεί το πρόβλημα με το σημείο τερματισμού.
Πώς μπορώ να αποφύγω την επεξεργασία διπλοτύπων;
Χρησιμοποιήστε το αναγνωριστικό του συμβάντος ως κλειδί ιδεμπότερίας, διατηρήστε μια προσωρινή προσωρινή μνήμη των επεξεργασμένων κλειδιών και αντιμετωπίστε τις επαναλήψεις ως μη ενεργές λειτουργίες. Οι επαναλήψεις σημαίνουν ότι το ίδιο συμβάν μπορεί να εμφανιστεί περισσότερες από μία φορές.
Διαβάστε την τεκμηρίωση για προγραμματιστές
Όλα όσα περιλαμβάνονται σε αυτή τη σελίδα, μαζί με τις πλήρεις αναφορές και τα δείγματα κώδικα, βρίσκονται στην τεκμηρίωση.
Η πλήρης αναφορά για προγραμματιστές βρίσκεται στη βάση γνώσεων.
Η εισαγωγή στο API καλύπτει τη βασική διεύθυνση URL, την πιστοποίηση, τα σφάλματα, τη σελιδοποίηση, τα όρια συχνότητας και τις προδιαγραφές OpenAPI.
Τα εξερχόμενα webhooks καλύπτουν τη διαμόρφωση ενός webhook, τον πλήρη κατάλογο συμβάντων, την επαλήθευση υπογραφής, τις επαναλήψεις και την ιδιότητα της ιδεμπότητας, με δείγματα κώδικα.
Χτίστε πάνω στον ίδιο κινητήρα, με τον δικό σας τρόπο.
