> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Token di accesso e autorizzazioni WhatsApp in Flowella

> Token di accesso e autorizzazioni dietro ogni richiesta alla WhatsApp Business Platform, cosa gestisce Flowella e cosa fare se l'accesso si interrompe.

Ogni richiesta alla WhatsApp Business Platform contiene un **token di accesso**, e le **autorizzazioni** concesse con quel token determinano cosa può fare la richiesta. Un'azienda che chiama l'API dalla propria app crea il proprio token. Un software collegato da molte aziende, come Flowella, riceve un token per ciascuna azienda quando questa completa il popup di registrazione di Meta. Con Flowella non dovete mai creare, copiare o incollare un token di Meta.

> [!NOTE]
>
> **In Flowella.** Supportato. Nel popup di Meta concedete a Flowella quattro autorizzazioni. Flowella conserva il token ricevuto in forma crittografata, non lo mostra mai e verifica ogni ora che funzioni ancora. Quando il token smette di funzionare o sta per scadere, Flowella invia agli owner e agli admin della vostra organizzazione un'email con un link per ricollegarvi. Le chiavi della [REST API di Flowella](https://knowledge.flowella.io/it/settings/api-keys.md) sono distinte dai token di Meta.

## I tipi di token di Meta

| Token | Chi lo usa | Quanto dura |
| - | - | - |
| **System user token** | Un'azienda che chiama l'API con la propria app, per i propri account | Di lunga durata. Scegliete la scadenza quando lo generate in **Business settings → System users**. |
| **Business integration system user token** ("business token") | Società di software che agiscono per conto delle aziende collegate tramite Embedded Signup. Ogni token è limitato a una sola azienda. | Di lunga durata, così le attività automatiche non richiedono all'azienda di accedere di nuovo |
| **User token** | Sviluppatori che fanno test dall'App Dashboard o dal Graph API Explorer | Breve. Meta stessa consiglia di passare a un system user token o a un business token. |

Quando completate il popup, Meta restituisce un codice a Flowella, che lo scambia con un token di lunga durata per la vostra azienda. Consultate [Il popup di registrazione di Meta](https://knowledge.flowella.io/it/whatsapp/accounts/embedded-signup.md).

## Autorizzazioni

Meta regola l'accesso a ogni endpoint tramite le autorizzazioni. Flowella le richiede tutte e quattro.

| Autorizzazione | A cosa serve per Meta |
| - | - |
| `whatsapp_business_management` | Dettagli dell'account, template, numeri di telefono, statistiche e webhook a livello di account |
| `whatsapp_business_messaging` | Inviare qualsiasi messaggio e ricevere i messaggi in arrivo e gli stati di consegna |
| `business_management` | Leggere direttamente il portfolio aziendale, ad esempio lo stato di verifica |
| `whatsapp_business_manage_events` | Inviare eventi a Meta, che Flowella usa per segnalare i lead degli [annunci Click to WhatsApp](https://knowledge.flowella.io/it/campaigns/click-to-whatsapp-ads.md) |

Per sapere cosa permette di fare a Flowella ciascuna autorizzazione, consultate [Le autorizzazioni che concedete](https://knowledge.flowella.io/it/whatsapp/accounts/embedded-signup.md#the-permissions-you-grant). Accettate tutte le autorizzazioni che Meta elenca nel popup. Se ne manca una, le funzionalità che ne dipendono non funzionano.

Prima che i clienti possano concedere un'autorizzazione all'app di una società di software, Meta deve aver approvato quell'app per l'**Advanced access** tramite App Review. Questa è responsabilità di Flowella. La vostra azienda non ha bisogno di App Review per usare Flowella.

## Le persone nel vostro portfolio aziendale

L'accesso dei vostri colleghi a WhatsApp Manager è separato dall'accesso di Flowella. Meta ora divide ogni account in un **WhatsApp account** e un **Messaging account**, e in Meta Business Suite date accesso alle persone per ciascuno dei due.

1. In [Meta Business Suite](https://business.facebook.com), aprite le **Settings** del vostro portfolio aziendale.
2. Andate in **Accounts → WhatsApp accounts**, selezionate l'account, aprite **People** e selezionate **Add people**.
3. Ripetete in **Accounts → Messaging accounts**. Meta Business Suite non copia l'accesso dall'uno all'altro.

Per sapere chi può fare cosa in Flowella, consultate [Team](https://knowledge.flowella.io/it/settings/team.md). Per i due tipi di account, consultate [Messaging accounts e WhatsApp accounts](https://knowledge.flowella.io/it/whatsapp/accounts/whatsapp-business-account.md#messaging-accounts-and-whatsapp-accounts).

## Quando l'accesso smette di funzionare

Flowella perde l'accesso quando il suo token scade, quando Meta lo revoca o quando qualcuno rimuove in Meta l'accesso di Flowella o un'autorizzazione. Nel frattempo Flowella può continuare a mostrare WhatsApp come **Connected**.

| Cosa vedete | Cosa significa | Cosa fare |
| - | - | - |
| Un'email di Flowella che vi chiede di ricollegare WhatsApp | Il controllo orario di Flowella ha rilevato che il token non funziona più o scadrà a breve | [Ricollegate il numero](https://knowledge.flowella.io/it/troubleshooting/whatsapp-connection.md#reconnect-the-number) |
| Il banner "WhatsApp needs reconnecting. Template sends are held until the connection is restored." | Flowella trattiene gli invii di template finché l'accesso non viene ripristinato | [Ricollegate il numero](https://knowledge.flowella.io/it/troubleshooting/whatsapp-connection.md#reconnect-the-number). Flowella invia poi ciò che aveva trattenuto. |
| Errore `190` | Il token è scaduto o è stato revocato | [Ricollegate il numero](https://knowledge.flowella.io/it/troubleshooting/whatsapp-connection.md#reconnect-the-number) |
| Errore `3`, `10` o da `200` a `299` | Un'autorizzazione necessaria a Flowella non è stata concessa o è stata rimossa | In Meta Business Settings, aprite **Connected apps** e selezionate **Flowella** per vedere a quali risorse può accedere. Poi ricollegatevi e accettate tutte le autorizzazioni. |

> [!WARNING]
>
> Non rimuovete il numero in Flowella per risolvere un problema di collegamento. La rimozione di un numero elimina in Flowella le sue conversazioni, le note e l'elenco degli opt-out.

Consultate [Errori di accesso e autorizzazioni](https://knowledge.flowella.io/it/whatsapp/errors/error-codes.md#access-and-permissions) per l'elenco completo.

## Rimuovere l'accesso di Flowella

Esistono due livelli, con effetti diversi.

| Azione | Dove | Cosa succede |
| - | - | - |
| Smettere di usare un numero | **Remove** in **Settings → WhatsApp (Meta)** | Flowella elimina le conversazioni, le note e l'elenco degli opt-out di quel numero. L'accesso di Flowella in Meta resta e il numero rimane registrato. Consultate [Rimuovere un numero](https://knowledge.flowella.io/it/account/meta-integration.md#remove-a-number). |
| Revocare completamente l'accesso di Flowella | Meta Business Settings, **Connected apps**, **Flowella** | Flowella non può più inviare né ricevere messaggi sull'account. Le conversazioni e i contatti restano in Flowella finché non rimuovete i numeri o chiedete a Flowella di eliminare i vostri dati. |

Se lasciate Flowella, conservate una copia di ciò che vi serve, rimuovete i numeri in Flowella e poi revocate l'accesso in Meta. Per far eliminare il resto dei dati, contattate l'[assistenza Flowella](https://flowella.io/support). Consultate [Conservazione ed eliminazione dei dati](https://knowledge.flowella.io/it/security/data-security.md#data-retention-and-deletion).

## Correlati

> [card] [Il popup di registrazione di Meta](https://knowledge.flowella.io/it/whatsapp/accounts/embedded-signup.md)
>
> Ogni schermata del popup e le autorizzazioni che concedete.

> [card] [Problemi di collegamento WhatsApp](https://knowledge.flowella.io/it/troubleshooting/whatsapp-connection.md)
>
> I segnali di un collegamento interrotto e come ricollegarsi.

> [card] [Sicurezza dei dati](https://knowledge.flowella.io/it/security/data-security.md)
>
> Cosa conserva Flowella e come lo protegge.

> [card] [Chiavi API](https://knowledge.flowella.io/it/settings/api-keys.md)
>
> Le chiavi per la REST API di Flowella.

Verificato rispetto alla documentazione di Meta il 18 novembre 2026: [Access tokens](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens) e [Permissions](https://developers.facebook.com/documentation/business-messaging/whatsapp/permissions).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.