Vai al contenuto principale
La pagina API keys che elenca due chiavi solo per nome e prefisso, una contrassegnata come Sandbox, con le date di creazione e di ultimo utilizzo, le azioni Revoke e il pulsante Create key
Una chiave API consente ai vostri script, strumenti no-code e servizi backend di chiamare la Flowella REST API per la vostra organizzazione. Questa pagina spiega come creare, usare, sostituire e revocare le chiavi.

​
Prima di iniziare

  • Serve il ruolo Owner o Admin. Gli altri ruoli vedono API keys nel menu, ma per loro l’elenco non si carica. Consultate Team e ruoli.
  • Decidete dove conserverete la chiave, ad esempio in un gestore di secret o nell’archivio delle credenziali del vostro strumento. Flowella mostra la chiave completa una sola volta.
State creando un’app che altri clienti Flowella installeranno? Usate un’app OAuth invece di una chiave API. Consultate Registrare un’app partner con OAuth.

​
Creare una chiave API

1

Aprite API keys

Andate su Settings, poi selezionate API keys nel gruppo Developer.
2

Avviate una nuova chiave

Selezionate Create key. Si apre la finestra di dialogo Create API key.
3

Assegnate un nome alla chiave

In Name, inserite qualcosa che indichi dove viene usata la chiave, ad esempio n8n production. I nomi possono avere fino a 120 caratteri. Flowella mostra il nome solo in questo elenco; non viene inviato con le richieste API.
4

Scegliete una chiave live o sandbox

Lasciate Sandbox key non selezionato per una chiave live. Selezionatelo per una chiave che non invia mai nulla a WhatsApp. Consultate Chiavi sandbox.
5

Create e copiate la chiave

Selezionate Create. La finestra di dialogo Save your API key mostra la chiave completa. Selezionate Copy, conservate la chiave, poi selezionate Done.
Flowella mostra la chiave completa una sola volta e non può mostrarla di nuovo. Se la perdete, revocate la chiave e createne una nuova. Trattate le chiavi come password: non salvatele mai nel controllo del codice sorgente e non incollatele in chat o in documenti condivisi.

​
Cosa può fare una chiave

Nell’app non potete limitare una chiave ad alcuni scope. Se un’integrazione deve avere un accesso più ristretto, registrate un’app OAuth con i soli scope necessari.

​
Usare una chiave

Inviate la chiave come bearer token nell’intestazione Authorization di ogni richiesta. Per verificare che una chiave funzioni, chiamate l’endpoint ping:
Una risposta 200 con "ok": true indica che la chiave è valida. Selezionate View API docs in cima alla schermata per aprire il riferimento API interattivo, dove potete incollare la chiave e provare le richieste.

​
Chiavi sandbox

Una chiave sandbox vi consente di provare un’integrazione senza inviare nulla a WhatsApp. Le richieste effettuate con una chiave sandbox si comportano così:
  • POST /v1/messages memorizza il messaggio in Flowella e restituisce "sandbox": true con metaMessageId impostato a null. Nulla arriva a WhatsApp.
  • L’invio di un modello lo approva subito, oppure lo rifiuta se il nome del modello contiene reject_. Meta non lo vede mai.
  • Gli invii di prova dei modelli vengono saltati.
Una chiave sandbox non blocca gli invii massivi tramite POST /v1/templates/send. Quei messaggi vengono inviati davvero. Per provare gli invii massivi in sicurezza, attivate invece la API sandbox a livello di organizzazione nel Developer hub. Finché è attiva, vengono saltati anche gli invii massivi dall’app.
Le chiavi sandbox funzionano sulla vostra organizzazione reale. I contatti, le conversazioni e i messaggi che creano vengono memorizzati come tutti gli altri e compaiono nell’app. Le chiavi sandbox mostrano un badge Sandbox accanto al nome nell’elenco.

​
L’elenco delle chiavi API

Per vedere quali chiamate ha effettuato di recente una chiave, aprite Recent API requests nel Developer hub.

​
Revocare una chiave

  1. Nell’elenco, selezionate Revoke nella riga della chiave.
  2. Confermate il messaggio Revoke this API key? It will stop working immediately.
Da quel momento, le richieste che usano la chiave non riescono con 401 e il messaggio Invalid or expired API key. La riga resta nell’elenco con un badge Revoked. Non potete annullare una revoca: create una nuova chiave se vi serve di nuovo l’accesso.

​
Sostituire una chiave

Non esiste un pulsante di rotazione. Per sostituire una chiave senza interruzioni:
  1. Create una nuova chiave con un nome chiaro, ad esempio n8n production 2026.
  2. Aggiornate la vostra integrazione per usare la nuova chiave.
  3. Verificate che l’orario Last used della nuova chiave cambi.
  4. Revocate la vecchia chiave.

​
Risoluzione dei problemi

Solo Owner e Admin possono visualizzare e gestire le chiavi API. Chiedete a un Owner o a un Admin di creare la chiave per voi. I ruoli non possono essere modificati nell’app: consultate Change someone’s role.
Verificate che l’intestazione sia esattamente Authorization: Bearer seguita dalla chiave completa, senza spazi o interruzioni di riga all’interno della chiave. Il messaggio Invalid or expired API key significa che la chiave è stata revocata o digitata male. Missing bearer token significa che l’intestazione non è arrivata: alcuni client HTTP la eliminano quando seguono un reindirizzamento, quindi chiamate direttamente https://api.flowella.io/v1.
Revocatela subito, poi create una sostituta e aggiornate la vostra integrazione. Controllate Recent API requests nel Developer hub per individuare chiamate che non riconoscete.

​
Risorse correlate

Introduzione all'API

Autenticazione, scope, limiti di frequenza ed errori.

Developer hub

Richieste API recenti, la API sandbox e le guide rapide.

App per sviluppatori

Usate OAuth quando altre organizzazioni installano la vostra app.

Webhook

Ricevete eventi invece di interrogare periodicamente l’API.
Ultima modifica il 24 ottobre 2026