> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.userbot.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.userbot.ai/_mcp/server. # Pubblicare una Mini App Una Mini App ha sempre due facce: la **bozza**, su cui lavori nel costruttore, e la **versione pubblicata**, quella che usano i colleghi in chat e gli agenti. Pubblicare serve a decidere quando una modifica è pronta per gli altri, così puoi provare senza disturbare chi la sta già usando. | | Bozza | Versione pubblicata | | ------------ | ---------------------------------------------------- | --------------------------------------------------------- | | Dove la vedi | Nell'**Anteprima** del costruttore | In chat, quando la Mini App si apre in conversazione | | Chi la usa | Chi lavora nel costruttore | I colleghi in chat e gli agenti | | Come cambia | A ogni richiesta all'AI e a ogni modifica del codice | Solo quando premi **Pubblica**, o ripristini una versione | Finché una Mini App non è mai stata pubblicata, nessun agente la può usare. ## Pubblicare #### Premi Pubblica È il pulsante in alto a destra nel costruttore. Il numero accanto conta le modifiche della bozza rispetto all'ultima versione pubblicata. Lo vedono il Proprietario e gli Editor. ![Il pulsante Pubblica evidenziato in alto a destra nel costruttore, con il numero 9 delle modifiche non pubblicate](/_fern-img/2b0937be49180865dbb31221ea22c0e484b3681f09bae4bb765ef48f85b8e839.webp) #### Controlla le modifiche Si apre il pannello **Pubblica Mini App**: in alto il numero della **Nuova versione**, sotto l'elenco delle **Modifiche** (i file aggiunti, cambiati o tolti, e se sono cambiati nome, descrizione o tipo). Se non c'è niente da pubblicare, il pannello lo dice: «Nessuna modifica rispetto all'ultima versione pubblicata.» ![Il pannello Pubblica Mini App aperto sotto il pulsante Pubblica: il numero della nuova versione, il campo Descrizione obbligatorio, l'elenco delle modifiche e il pulsante Pubblica in fondo](/_fern-img/d4a8bf97c971c76ffb06ed76c578ef00dc483bbe4ce964fcc6d97b751de6a917.webp) #### Scrivi una descrizione La **Descrizione** è obbligatoria. Scrivi cosa cambia per chi usa la Mini App: *«aggiunta la categoria Outlet»*, *«corretto l'arrotondamento del totale»*. È quello che leggerete fra tre mesi per capire cosa è successo. #### Premi Pubblica nel pannello Da quel momento la nuova versione è quella in uso, in chat e negli agenti, e il contatore si azzera. ![Nel costruttore si preme Pubblica, si scorre l'elenco delle modifiche, si scrive la descrizione della versione e si arriva al pulsante Pubblica del pannello](/_fern-files/userbot-035249.docs.buildwithfern.com/786af33ef8796224ec855818a83813506488e034be2e3b08de44a0beca89dc7b/docs/assets/animazioni/miniapp-pubblicare.gif) > **Info** > > La pubblicazione viene bloccata se nel codice c'è `eval` o `new Function`, o > qualcosa che sembra una chiave segreta o una password scritta in chiaro. Chiedi > in chat di toglierli e riprova. ## Il pannello Versioni **Versioni**, sopra l'anteprima, raccoglie la storia della Mini App in due schede. Ognuna mostra al massimo le 20 voci più recenti. ![Il pannello Versioni aperto accanto all'anteprima, con l'elenco delle versioni della Mini App](/_fern-img/9ed30bcfaf7d3e9e56e9aedbf93f77905dde21c7e5db13553847cda8fae23d74.webp) ### Modifiche: i punti di ripristino della bozza Qui stanno gli stati della bozza che puoi recuperare. Nascono in due modi: | Da cosa nasce | Come compare | | ----------------------------------------------------------------- | ---------------------------------------- | | Prima di ogni modifica dell'AI, in automatico | **auto**. Se ne conservano gli ultimi 10 | | **Salva versione**, premuto da te, con un'**Etichetta opzionale** | **salvata** | **Salva versione** serve a mettere un segnalibro su uno stato di cui ti fidi, prima di provare qualcosa di rischioso. Scrivi un'etichetta che ti farà capire cos'era (*«con soglia 200 pezzi»*, *«prima del campo categoria»*). Se hai modificato il codice a mano e non sei ancora uscito dal campo, il pulsante resta spento con «Salva le modifiche al codice prima di creare un checkpoint.» Accanto a ogni voce: * **Ripristina** riporta la **bozza** a quello stato. La versione pubblicata non cambia: chi usa la Mini App non se ne accorge finché non pubblichi. * **Pubblica** mette in uso direttamente quello stato. ### Pubblicate: le versioni che sono state in uso Qui c'è la versione **pubblicata** adesso e quelle **sostituite** prima di lei. * **Anteprima** apre quella versione al posto della bozza, con il banner «Stai vedendo vN». **Esci dall'anteprima** torna alla bozza. * **Ripristina** riporta indietro sia la bozza sia la versione pubblicata. Chiede conferma, perché le modifiche non pubblicate della bozza vanno perse, e con **Ripristina e pubblica** crea una nuova versione pubblicata uguale a quella scelta. > **Warning** > > **Ripristina e pubblica** sovrascrive la bozza. Se ci stavi lavorando, prima > premi **Salva versione** nella scheda **Modifiche**: è l'unico modo per > ritrovare quel lavoro dopo. ## I dati salvati non passano da una versione all'altra Se la Mini App salva dati con le [funzioni server](/miniapp-server), quei dati non sono legati alla Mini App in generale ma alla singola versione: * la bozza ha un suo archivio, separato da quello della versione pubblicata, e pubblicare non copia i dati della bozza; * ogni pubblicazione, anche quella che nasce da un ripristino, parte con un archivio vuoto: i dati salvati quando era in uso la versione precedente non si vedono nella nuova. Tienine conto prima di ripubblicare una Mini App che raccoglie dati in uso. ## Copie **Duplica**, dal menu **⋯**, crea una copia con la sola bozza: nessuna versione e nessuna pubblicazione. Prima che un agente possa usarla va pubblicata. → [Usarla e condividerla](/condividere-miniapp)