Chi può usarlo
API base URL
Questa scheda mostra l’indirizzo della REST API. Nella vostra integrazione, usatehttps://api.flowella.io/v1 come URL di base, anche se la scheda mostra un indirizzo che termina con /api/v1. Consultate Base URL per sapere perché.
Richieste API recenti
Questa scheda elenca le 25 richieste API più recenti effettuate alla vostra organizzazione con chiavi API o access token OAuth, dalla più recente.
Le richieste che Flowella rifiuta prima di eseguirle non sono elencate. Tra queste rientrano le richieste con un token mancante o non valido, uno scope mancante, un’intestazione
API-Version non supportata o oltre il limite di frequenza.
Per vedere tutto ciò che è collegato a una richiesta, come gli eventi, i job e le consegne webhook che ha generato, chiamate GET /v1/requests/{requestId} con il Request id. Richiede lo scope account:read. Consultate Request IDs.
API sandbox
La scheda API sandbox contiene un interruttore a livello di organizzazione per effettuare test senza inviare nulla a WhatsApp. Il badge mostra Active quando la sandbox è attiva e Off quando è disattivata. Sandbox guide apre la guida alla sandbox nell’app. Per attivare la sandbox, un Owner o un Admin seleziona la casella in fondo alla scheda. Deselezionatela per disattivare la sandbox. La modifica si applica subito all’intera organizzazione. Potete anche leggere e modificare l’impostazione conGET /v1/sandbox e PATCH /v1/sandbox, usando il corpo { "enabled": true } o { "enabled": false }. Entrambi richiedono lo scope sandbox:manage.
API sandbox e chiavi sandbox
Esistono due modi per usare la sandbox. La API sandbox a livello di organizzazione copre ogni richiesta, mentre una chiave sandbox copre solo le richieste effettuate con quella chiave.Cosa cambia nella sandbox
Quando la sandbox copre una richiesta:POST /v1/messagesmemorizza il messaggio nella conversazione e restituisce"sandbox": trueconmetaMessageIdimpostato anull. Nulla arriva a WhatsApp e non viene attivato alcun webhookmessage.sent.- L’invio di un modello con
POST /v1/templates/{id}/submitnon raggiunge Meta. Il modello viene approvato subito, oppure rifiutato se il nome contienereject_. Un’intestazione multimediale il cui esempio è solo un indirizzo web viene rifiutata con400 INVALID_TEMPLATE_COMPONENTS. La decisione compare nell’API e nel feed degli eventi, ma la pagina Templates nell’app non cambia. - La sandbox funziona nella vostra organizzazione reale. I contatti, le conversazioni e i messaggi creati durante i test vengono memorizzati come tutti gli altri e compaiono nell’app.
Strumenti di test della sandbox
Questi endpoint vi aiutano a simulare attività. Richiedono lo scopesandbox:manage e funzionano indipendentemente dal fatto che la sandbox sia attiva, quindi usateli solo con dati di test.
Gli strumenti di test scrivono solo nel feed degli eventi (
GET /v1/events). Non inviano webhook e non modificano il messaggio stesso.
Guide rapide
La scheda Quickstarts rimanda a guide passo per passo. Ciascuna si apre come file Markdown in una nuova scheda.Link
Risorse correlate
Introduzione all'API
Autenticazione, scope, limiti di frequenza ed errori.
Chiavi API
Create chiavi live e sandbox.
App per sviluppatori
Registrate un’app OAuth e gestite le app installate.
Riferimento webhook
Tipi di eventi, payload e verifica delle firme.