Sviluppare su Flowella in modo programmatico.
Quando gli strumenti no-code non coprono una determinata funzionalità, ci pensano l'API REST di Flowella e i webhook in uscita. Chiama l'API per inviare messaggi WhatsApp, gestire i contatti e le cancellazioni e recuperare i dati analitici. Iscriviti ai webhook per reagire in tempo reale a messaggi, consegne, cancellazioni e modifiche ai modelli, senza bisogno di effettuare polling.
Chiamalo, e lascia che ti richiami.
Due direzioni, un unico motore. La tua applicazione chiama l'API REST per eseguire le operazioni: inviare un modello, aggiornare un contatto, recuperare i dati analitici. Nella direzione opposta, Flowella invia eventi webhook firmati al tuo endpoint nel momento stesso in cui si verifica un evento, consentendoti di reagire istantaneamente invece di ricorrere al polling. Insieme, ti permettono di sviluppare tutto ciò di cui il tuo stack ha bisogno basandoti sullo stesso motore di WhatsApp e HubSpot.
Invia, gestisci e genera report
Un'API REST v1 semplice, con autenticazione tramite chiave bearer e un comportamento prevedibile.
L'API REST è alla versione v1, disponibile all'indirizzo https://app.flowella.io/api/v1. Ogni richiesta include una chiave bearer a livello di organizzazione nell'intestazione Authorization, creata da un proprietario o amministratore nella sezione Impostazioni > Chiavi API e visualizzata una sola volta. Gli endpoint di elenco utilizzano l'impaginazione con cursore con un limite compreso tra uno e cento, gli errori vengono restituiti in un formato coerente con un campo codice stabile e le richieste sono limitate in base alla frequenza per organizzazione con un codice 429 quando si procede troppo velocemente. I numeri di telefono vengono trasmessi preferibilmente in formato E.164 e una specifica OpenAPI leggibile da macchina viene inserita direttamente in Postman o in un generatore di codice.
Per gli invii in blocco di grandi dimensioni, l'endpoint di invio dei modelli accetta un parametro di limitazione oraria, in modo che Flowella regoli la velocità di consegna lato server, invece che sia l'utente a dover regolare le richieste.
Reagire agli eventi in tempo reale
Iscriviti agli eventi che ti interessano e Flowella invierà una notifica non appena si verificheranno.
| Evento | Quando viene attivato |
|---|---|
| message.received | Arriva un messaggio WhatsApp in entrata da un contatto |
| message.sent | Flowella ha accettato il tuo messaggio in uscita e lo ha inviato a Meta |
| message.delivered | Meta ha confermato la consegna sul dispositivo del destinatario |
| message.read | Il destinatario ha aperto il messaggio |
| message.failed | Meta ha restituito un errore per il messaggio |
| conversazione.aperta / chiusa | Lo stato di una conversazione è cambiato |
| optout.created | Un contatto si è disiscritto da un canale |
| template.status_updated | Meta ha modificato lo stato di un modello |
Ogni richiesta è firmata con un digest esadecimale HMAC-SHA256 del corpo grezzo, quindi verifica la firma prima dell'elaborazione. Flowella attende fino a dieci secondi per un 2xx, riprova fino a tre volte con backoff e disabilita automaticamente un endpoint dopo dieci fallimenti consecutivi. Poiché i tentativi possono ripetere un evento, usa l'ID dell'evento come chiave di idempotenza e tratta i duplicati come operazioni nulle.
Prima il no-code, poi il codice quando serve.
L'API amplia le funzionalità del prodotto. Non sostituisce le parti che funzionano già senza codice.
Iniziare da qui per i lavori più comuni.
La maggior parte delle esigenze dei team, come l'invio di modelli, l'acquisizione delle risposte del flusso, l'attivazione dell'automazione, sono già coperte senza toccare l'API. Cercate il codice solo quando avete bisogno di qualcosa di più.
- Da modulo a flusso, sincronizzazione nativa con HubSpot
- Azioni del flusso di lavoro e casella di posta
- Nessun codice da scrivere
Cercate un codice quando vi serve di più.
Quando avete bisogno di collegare WhatsApp a un sistema personalizzato, di sincronizzarvi con uno strumento che non dispone di un connettore nativo o di reagire agli eventi nel vostro backend, l'API e i webhook vi danno il pieno controllo.
- Applicazioni personalizzate e integrazioni su misura
- Reagire agli eventi senza polling
- Invio massivo con strozzatura lato server
- ⏱️ 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
Risposte dirette.
Le domande che si pongono gli sviluppatori.
Come si effettua l'autenticazione?
Una chiave bearer a livello di organizzazione, creata da un proprietario o da un amministratore nella sezione "Impostazioni", "Chiavi API". Viene visualizzata una sola volta al momento della creazione, quindi conservala in un luogo sicuro e sostituiscila quando un membro del team lascia l'organizzazione.
Cosa può fare l'API?
Invia messaggi e modelli WhatsApp, gestisci i contatti e le richieste di cancellazione, crea elenchi e invia modelli in blocco, ed estrai i dati analitici. L'elenco completo degli endpoint viene generato automaticamente dalle specifiche OpenAPI.
Posso effettuare grandi invii in blocco?
Sì. Utilizza l'endpoint di invio dei modelli con il parametro "throttle-per-hour" e Flowella gestirà la limitazione della frequenza a livello di server, quindi non dovrai occuparti personalmente dei limiti di tempo o di frequenza.
Come posso verificare che un webhook sia autentico?
Ogni webhook è firmato con un digest HMAC-SHA256 del corpo della richiesta non elaborato. Calcola lo stesso digest utilizzando la tua chiave di firma e confronta i risultati, applicando la firma ai byte non elaborati prima di qualsiasi analisi JSON.
Cosa succede se il mio endpoint non funziona?
Flowella effettua fino a tre tentativi con un intervallo di attesa e disattiva automaticamente l'endpoint dopo dieci tentativi falliti consecutivi. Una volta risolto il problema, riattivalo da Impostazioni, Webhook.
Come posso evitare di elaborare i duplicati?
Utilizza l'ID dell'evento come chiave di idempotenza, mantieni una cache temporanea delle chiavi elaborate e considera le ripetizioni come operazioni inerti. I tentativi di ripetizione implicano che lo stesso evento possa verificarsi più di una volta.
Leggi la documentazione per gli sviluppatori
Tutto ciò che è riportato in questa pagina, compresi i riferimenti completi e gli esempi di codice, è disponibile nella documentazione.
La guida completa per gli sviluppatori è disponibile nella knowledge base.
L'introduzione all'API tratta l'URL di base, l'autenticazione, gli errori, l'impaginazione, i limiti di frequenza e le specifiche OpenAPI.
La sezione Webhook in uscita tratta la configurazione di un webhook, l'elenco completo degli eventi, la verifica della firma, i tentativi e l'idempotenza, con esempi di codice.
Parti dallo stesso motore, ma a modo tuo.
