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

# Onboarding dell'Operatore

> Cosa fa un proprietario di workspace nel prodotto per preparare la piattaforma al traffico WhatsApp live.

# Onboarding dell'Operatore

L'app dell'operatore ha ora una route dedicata `Setup` su `/setup` per la configurazione al primo avvio.

Usala per il lavoro di connessione al primo avvio.
Usa `Settings` su `/settings` per la manutenzione continua dopo che il workspace è live.

## Cosa Copre Setup

Il flusso di setup è progettato per rispondere a quattro domande:

1. Il profilo del workspace è utilizzabile?
2. Un canale WhatsApp è collegato al workspace?
3. I segreti del provider sono memorizzati in modo sicuro?
4. La piattaforma ha validato abbastanza della connessione per iniziare test controllati?

## Flusso di Prodotto Previsto

1. Accedi come primo proprietario del workspace.
2. Apri `Setup`.
3. Rivedi l'identità del workspace e del canale.
4. Inserisci i segreti del provider gestiti dal workspace.
5. Valida la configurazione del provider.
6. Apri l'inbox ed esegui un test di invio controllato.

## Segreti e Storage

Il prodotto distingue tra due classi di segreti:

* **Segreti di piattaforma/bootstrap**: valori posseduti dal deployment come le credenziali server di Supabase e gli URL di base. Rimangono configurazione dell'ambiente di runtime.
* **Segreti gestiti dal workspace**: credenziali del provider specifiche per tenant inserite tramite il prodotto. Vengono scritte lato server e memorizzate in Supabase Vault, con solo lo stato mascherato e i metadati di validazione esposti nella UI.

La UI non restituisce i valori dei segreti decriptati dopo la scrittura.

## Checklist di Prontezza

La checklist di setup è completa quando:

* il profilo del workspace è impostato
* l'identità del canale è presente
* il token di accesso Meta è memorizzato
* il segreto di firma del webhook è memorizzato
* il token di verifica Meta è memorizzato
* la validazione Meta non segnala più un token non valido

## Note Operative

* I segreti del provider basati su variabili d'ambiente continuano a funzionare come fallback di bootstrap.
* Una volta che esiste un segreto Vault gestito dal workspace, questo ha priorità sul fallback d'ambiente per quel workspace.
* Le scritture nelle impostazioni sono limitate a owner/admin/developer.

## Onboarding di un ulteriore Account WhatsApp Business

I passaggi sopra descrivono il primo WABA che un workspace collega. Un workspace non è più limitato a un solo WABA — il flusso `/welcome` può anche presentare un **selettore a tre percorsi** (porta il tuo token, fai l'onboarding con noi tramite Meta Embedded Signup, oppure migra un account WhatsApp esistente) quando il feature flag di Embedded Signup è abilitato. Ogni WABA aggiuntivo ottiene il proprio slot di token di accesso isolato, quindi un secondo numero onboardato non sovrascrive mai le credenziali del primo WABA.

Vedi [Meta Embedded Signup e Multi-WABA](/it/platform/embedded-signup) per il flusso completo, i prerequisiti del feature flag e come funziona la risoluzione del token per WABA al momento dell'invio.

## Leggi anche

* [Meta Embedded Signup e Multi-WABA](/it/platform/embedded-signup)
* [Collega WhatsApp](/it/platform/connect-whatsapp)
* [Piano di Migrazione](/it/platform/migration)
* [Operazioni sui Webhook](/it/operations/webhooks)