Skip to main content

​
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 per il flusso completo, i prerequisiti del feature flag e come funziona la risoluzione del token per WABA al momento dell’invio.

​
Leggi anche