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

# FAQ

> Domande frequenti su Macaly

## Per iniziare

<AccordionGroup>
  <Accordion title="Che tipo di progetti posso creare con Macaly?">
    Macaly è pensato per creare siti web di marketing, landing page, portfolio, blog, app web (moduli di contatto, pagine di prenotazione, sistemi di archiviazione dati), semplici app e giochi 3D, contenuti visivi e prototipi o MVP. Dà il meglio con siti dal design professionale e dal caricamento veloce.
  </Accordion>

  <Accordion title="Per che tipo di progetti Macaly non è adatto?">
    Macaly non è lo strumento giusto per app enterprise complesse, app mobile native per iOS o Android, software desktop o progetti che richiedono PHP, backend Python, WordPress o Supabase. Lavora esclusivamente con Next.js (React) e con Convex come database.
  </Accordion>

  <Accordion title="Posso creare il mio progetto in una lingua diversa dall'inglese?">
    Sì, Macaly funziona pienamente in qualsiasi lingua. Basta dare all'agente le istruzioni nella lingua che preferisci (italiano, francese, tedesco, spagnolo e così via) e i contenuti del progetto verranno generati in quella lingua. Se ti servono pagine multilingua, descrivi chiaramente quali sezioni devono comparire in quale lingua.
  </Accordion>

  <Accordion title="Macaly supporta l'autenticazione e l'accesso degli utenti?">
    Sì. Macaly può impostare l'autenticazione tramite OTP (password monouso inviata via email) oppure un classico sistema di accesso con email e password. Descrivi che cosa ti serve e l'agente lo implementa.
  </Accordion>

  <Accordion title="Posso modificare testi e fare piccole modifiche di design senza consumare crediti?">
    Sì. Le [modifiche visive](/docs/it/features/visual-edits) ti permettono di fare clic direttamente su testi, immagini e altri elementi nell'anteprima e di cambiarli senza inviare un messaggio all'agente. Queste modifiche vengono scritte nel progetto quando salvi e non consumano crediti. Le eccezioni sono **Riscrivi con l’IA** e **Genera con l’IA**, che consumano crediti e ti mostrano il prezzo prima di eseguirli.
  </Accordion>

  <Accordion title="Posso usare Macaly dal telefono o devo scaricare un'app?">
    Macaly funziona benissimo nel browser mobile, quindi puoi creare e gestire i tuoi progetti direttamente dal telefono. L'unica eccezione sono le Modifiche visive, disponibili solo su dispositivi con schermo più grande.
  </Accordion>
</AccordionGroup>

## Aggiornamento dei prezzi: ottobre 2026

<AccordionGroup>
  <Accordion title="Cosa è cambiato con l'aggiornamento dei prezzi di ottobre 2026?">
    L'8 ottobre 2026 Macaly ha introdotto il piano **Starter** (€8,80/mese) e ha stabilito limiti chiari per il piano Gratuito: app pubblicate, spazio per i file, traffico del sito incluso e 100 Cloud actions al mese. Il piano **Hosting** non è più offerto ai nuovi clienti. Il piano Pro resta invariato. Consulta [Piani e crediti](/docs/it/welcome/pricing) per vedere cosa include ogni piano.
  </Accordion>

  <Accordion title="Cos'è il piano Starter e a chi è rivolto?">
    Starter costa €8,80/mese (\$10 o 210 Kč, a seconda della valuta di fatturazione) e prevede solo la fatturazione mensile. È pensato per pubblicare un'app sul tuo dominio personalizzato, senza il badge Macaly. Include:

    * 1M crediti al mese
    * 1 app pubblicata sul tuo dominio personalizzato (l'acquisto del dominio viene addebitato a parte)
    * 5 GiB di spazio per i file
    * 5 GiB di utilizzo del database
    * 5 GB di traffico del sito incluso
    * Nessun limite mensile di Cloud actions
    * Assistenza via email e 3 mesi di conservazione dei dati di Analytics

    Starter non include l'integrazione con GitHub. Se ti servono più crediti o più spazio, scegli [Pro](/docs/it/welcome/pricing).
  </Accordion>

  <Accordion title="Ho il piano Hosting. Cosa cambia per me?">
    Non cambia nulla. Mantieni il tuo piano Hosting, il suo prezzo e le sue funzionalità. Puoi ancora gestirlo o annullarlo da **Fatturazione**.
  </Accordion>

  <Accordion title="Posso ancora acquistare il piano Hosting?">
    No. Hosting non è più offerto ai nuovi clienti. Per tenere online un sito sul tuo dominio, scegli Starter.
  </Accordion>

  <Accordion title="Ho il piano Gratuito con più app pubblicate. Cosa succede?">
    Il piano Gratuito include 1 app pubblicata. Se ne hai di più, mandiamo prima un'email a proprietari e amministratori del workspace e ti diamo il tempo di scegliere quale resta online (l'email indica la data esatta). Puoi anche passare a un piano che include più app pubblicate. Dopo la scadenza, le altre app vengono rimosse dalla pubblicazione. I tuoi progetti e i tuoi dati restano, e puoi pubblicarli di nuovo dopo l'upgrade o quando rientri nel limite del tuo piano. Le app rimosse dalla pubblicazione vengono tolte anche dalla galleria della community.

    Fino ad allora, per pubblicare una nuova app serve uno slot libero. Per liberare uno slot, rimuovi un'app dalla pubblicazione: lo slot torna disponibile in pochi minuti. Bozze e anteprime non contano per il limite. Vedi [App pubblicate oltre il limite](/docs/it/account/workspaces/usage#app-pubblicate-oltre-il-limite).
  </Accordion>

  <Accordion title="Cosa sono le Cloud actions e cosa viene conteggiato?">
    Le Cloud actions sono le operazioni che gli agenti AI esterni, come ChatGPT, Claude o altri client MCP, eseguono tramite [Macaly Cloud](/docs/it/integrations/macaly-cloud). Vengono conteggiate:

    * Creare o duplicare un'app
    * Scrivere, modificare o eliminare file
    * Eseguire comandi
    * Caricare file
    * Pubblicare
    * Collegare un dominio

    Leggere file, elencarli e le anteprime sono gratuiti. Chattare con Macaly dentro l'app non usa Cloud actions.
  </Accordion>

  <Accordion title="Chi ha un limite di Cloud actions e quando si azzera?">
    Il piano Gratuito include 100 Cloud actions al mese. I piani a pagamento non hanno un limite mensile di Cloud actions. La soglia del piano Gratuito è condivisa dall'intero workspace e si azzera il 1° di ogni mese (UTC). Le Cloud actions non usate non si accumulano.
  </Accordion>

  <Accordion title="Cosa succede quando finisco le Cloud actions?">
    Le ulteriori azioni conteggiate vengono rifiutate. Il messaggio mostra la data in cui la soglia si azzera e un link a **Fatturazione**. La lettura dei file, le app già online e la chat con Macaly dentro l'app continuano a funzionare.
  </Accordion>

  <Accordion title="Posso passare da Pro a Starter? E se supero i limiti di Starter?">
    Sì. I passaggi a un piano inferiore hanno effetto alla fine del periodo di fatturazione in corso. In **Fatturazione**, programma il passaggio a Starter oppure scegli Starter quando annulli Pro. Pro e i suoi crediti restano fino alla data di rinnovo.

    Al rinnovo, Macaly controlla il workspace. Se ha più di 1 app pubblicata o più di 5 GiB di file, il passaggio viene annullato e Pro si rinnova. Questo controllo non rimuove mai nulla dalla pubblicazione né elimina nulla. Puoi annullare un passaggio programmato con **Mantieni Pro**.
  </Accordion>

  <Accordion title="Come passo da Gratuito a Starter o Pro?">
    Apri **Fatturazione** e scegli il piano. I passaggi a un piano superiore hanno effetto immediato: paghi il prezzo intero del nuovo piano, ricevi tutti i suoi crediti e il periodo di fatturazione riparte.
  </Accordion>

  <Accordion title="Cosa succede quando lo spazio per i file è pieno?">
    I nuovi caricamenti, e la copia di un database, vengono rifiutati finché non liberi spazio. I file esistenti restano leggibili e le app pubblicate restano online.
  </Accordion>

  <Accordion title="Il traffico del sito è limitato?">
    Oggi no. Il dato sul traffico di ogni piano è solo una soglia indicativa: non viene misurato, applicato né addebitato.
  </Accordion>

  <Accordion title="Dove posso vedere il mio utilizzo?">
    **Fatturazione** e **Impostazioni → Utilizzo e limiti** (vedi [Utilizzo e limiti](/docs/it/account/workspaces/usage)) mostrano le tue Cloud actions (piano Gratuito), le app pubblicate, lo spazio per i file e il traffico del sito incluso.
  </Accordion>

  <Accordion title="Cos'è la barra in alto in Macaly?">
    Sui piani Gratuito e Starter, una barra in alto nella schermata iniziale e nelle chat ti avvisa quando il tuo workspace è vicino a un limite del piano o l'ha superato. È ambra all'80% e rossa quando un limite viene raggiunto o superato (le app pubblicate diventano rosse solo quando hai più app online di quelle incluse nel tuo piano). Serve solo a informare: non può essere chiusa e da sola non rimuove nulla dalla pubblicazione. Vedi [Avvisi sui limiti del piano](/docs/it/account/workspaces/usage#avvisi-sui-limiti-del-piano).
  </Accordion>

  <Accordion title="I crediti sono cambiati?">
    I nuovi workspace Gratuiti ricevono 1 milione di crediti al mese. Per il resto, crediti e ricariche funzionano come prima.
  </Accordion>

  <Accordion title="Come funzionano i blocchi di utilizzo extra del database su Starter, Pro e Agenzie?">
    Starter include 5 GiB di utilizzo del database al mese e Pro ne include 10 GiB. Su Starter, Pro e Agenzie, ogni 1 GiB aggiuntivo iniziato in un mese di calendario costa 200K crediti. Se a metà mese passi a un piano superiore dal piano Gratuito o Hosting, la soglia del piano a pagamento parte dal passaggio e l'utilizzo precedente non viene mai addebitato. Consulta [Piani e crediti](/docs/it/welcome/pricing) per la tabella completa.
  </Accordion>
</AccordionGroup>

## Piani e crediti

<AccordionGroup>
  <Accordion title="Come funziona il sistema di crediti?">
    I crediti vengono consumati ogni volta che invii un prompt all'agente Macaly. La quantità dipende dalla complessità dell'attività. Gli utenti del piano Gratuito ricevono 1 milione di crediti al mese. I crediti dei piani a pagamento sono validi per 30 giorni. Chi ha un piano a pagamento (Starter o Pro) può anche acquistare ricariche di crediti una tantum, valide per 60 giorni.
  </Accordion>

  <Accordion title="I crediti si trasferiscono al mese successivo?">
    No. Ogni periodo di fatturazione inizia con una nuova serie di crediti e i crediti non utilizzati scadono alla fine del periodo. Puoi acquistare ricariche di crediti una tantum, valide per 60 giorni dalla data di acquisto.
  </Accordion>

  <Accordion title="Posso acquistare crediti extra senza passare a un piano superiore?">
    Sì. Se hai un piano a pagamento (Starter o Pro), puoi acquistare una ricarica di crediti una tantum su macaly.com/billing. I crediti della ricarica sono validi per 60 giorni, più a lungo del periodo di fatturazione standard di 30 giorni. Se hai il piano Gratuito e ti servono più crediti, dovrai prima passare a un piano a pagamento.
  </Accordion>

  <Accordion title="Posso passare a un piano superiore o inferiore in qualsiasi momento?">
    Sì. I passaggi a un piano superiore hanno effetto immediato: ti viene addebitato l'importo intero, ricevi tutti i crediti e il tuo ciclo di fatturazione viene azzerato. Il saldo dei crediti può impiegare qualche istante ad aggiornarsi, di solito basta ricaricare la pagina. I crediti non utilizzati del piano precedente restano disponibili fino alla fine del periodo in corso. I passaggi a un piano inferiore, compreso il passaggio da Pro a Starter o al piano Gratuito, hanno effetto alla fine del tuo attuale periodo di fatturazione.
  </Accordion>

  <Accordion title="Cosa succede se esaurisco i crediti?">
    Se hai il piano Starter, puoi acquistare una ricarica di crediti una tantum oppure passare a Pro. Se hai il piano Pro, puoi acquistare una ricarica di crediti una tantum oppure passare a un piano superiore. Se hai il piano Gratuito, dovrai passare a un piano superiore per continuare a usare l'agente. Tutti i tuoi progetti rimangono attivi e il tuo lavoro non viene influenzato.
  </Accordion>

  <Accordion title="Perché ho 0 crediti se non ne ho usato nessuno?">
    Gli utenti del piano Gratuito ricevono 1 milione di crediti per ogni ciclo di fatturazione mensile. Se il tuo saldo mostra 0 e non hai usato crediti, [contatta l'assistenza](mailto:support@macaly.com). Il team può verificare il tuo account. I crediti dei piani a pagamento vengono aggiunti all'inizio di ogni ciclo di fatturazione di 30 giorni.
  </Accordion>

  <Accordion title="Macaly ha avuto un problema e ha consumato i miei crediti. Posso ottenere un rimborso?">
    Dipende dalla situazione. Se si è verificato un problema confermato a livello di piattaforma (per esempio l'agente bloccato, un crash del sandbox o un'interruzione del servizio), [contatta l'assistenza](mailto:support@macaly.com) allegando il link alla chat interessata: il team esaminerà il caso e restituirà i crediti quando appropriato.

    Se invece l'agente rispondeva normalmente ma ha avuto bisogno di più tentativi per correggere qualcosa, questo è il comportamento previsto con gli agenti IA. Per ottenere i risultati migliori ed evitare consumi inutili di crediti, fornisci all'agente più contesto possibile, inclusi screenshot e descrizioni chiare, invece di inviare ripetuti comandi di correzione. Se l'agente non riesce a risolvere un problema nemmeno con il contesto completo, [contatta l'assistenza](mailto:support@macaly.com) e il team analizzerà il caso singolarmente.
  </Accordion>

  <Accordion title="Come applico un codice promozionale o di sconto?">
    Se stai effettuando il tuo primo acquisto, puoi inserire il codice promozionale durante il pagamento nella pagina di fatturazione. Se hai già un piano a pagamento attivo, i codici promozionali non possono essere inseriti direttamente. [Contatta l'assistenza](mailto:support@macaly.com) indicando il tuo codice e il team applicherà lo sconto al tuo account manualmente.
  </Accordion>

  <Accordion title="Cosa succede se ho un vecchio piano Pro, Plus o Ultra?">
    Con l'aggiornamento dei prezzi, tutti i vecchi piani Pro, Plus e Ultra ora includono le stesse funzionalità dell'attuale piano Pro. I tuoi messaggi rimanenti sono stati convertiti a un tasso di 1 messaggio = 100.000 crediti. Puoi continuare a usare il tuo piano attuale finché non termina, ma d'ora in poi potrai passare solo a uno dei nuovi piani.
  </Accordion>
</AccordionGroup>

## Fatturazione e abbonamenti

<AccordionGroup>
  <Accordion title="Come annullo il mio abbonamento?">
    Vai su macaly.com/billing, clicca su **Gestisci** accanto al tuo piano attuale e seleziona **Annulla abbonamento**. Dopo l'annullamento, l'accesso continua fino alla fine del periodo di fatturazione in corso. Il piano Gratuito include 1 app pubblicata. Se ne hai di più, ti mandiamo prima un'email e ti diamo il tempo di scegliere quale resta. Le altre vengono rimosse dalla pubblicazione; i tuoi progetti e i tuoi dati restano e puoi pubblicarli di nuovo dopo l'upgrade o quando rientri nel limite del tuo piano.
  </Accordion>

  <Accordion title="In quali valute posso essere fatturato?">
    Macaly supporta la fatturazione in USD, EUR e CZK. Usa il selettore della valuta in alto a destra nella pagina Fatturazione per scegliere. La tua scelta determina la valuta in cui vieni effettivamente addebitato, non solo il modo in cui i prezzi vengono mostrati.
  </Accordion>

  <Accordion title="Posso cambiare la valuta di fatturazione dopo aver sottoscritto un abbonamento?">
    Puoi cambiare liberamente la valuta di fatturazione prima di avviare un abbonamento. Se hai già un abbonamento attivo, [contatta l'assistenza](mailto:support@macaly.com) e il team la cambierà per te.
  </Accordion>

  <Accordion title="Dove trovo le fatture e le ricevute?">
    Vai su macaly.com/billing e clicca sulla scheda **Fatture**. Tutte le fatture precedenti sono elencate lì e possono essere scaricate singolarmente.
  </Accordion>

  <Accordion title="Perché mi è stato addebitato più del previsto?">
    Quando passi a un piano superiore, ti viene addebitato subito il prezzo intero del nuovo piano, non solo la differenza. Per esempio, passando da €22/mese a €44/mese ti vengono addebitati subito €44. Se pensi che l'addebito sia avvenuto per errore, [contatta l'assistenza](mailto:support@macaly.com). Il team può procedere con un rimborso se i crediti del piano superiore non sono ancora stati usati.
  </Accordion>

  <Accordion title="Posso ottenere un rimborso per un rinnovo dell'abbonamento che ho dimenticato di annullare?">
    [Contatta l'assistenza](mailto:support@macaly.com) il prima possibile. I rimborsi per i rinnovi accidentali vengono gestiti caso per caso. Se non hai ancora usato i crediti rinnovati, il rimborso è di solito possibile. La politica di rimborso di Macaly è descritta nella sezione 7 dei Termini di servizio su macaly.com/terms-of-service.
  </Accordion>

  <Accordion title="Esiste un piano più economico per un sito sul mio dominio?">
    Sì. Il piano Starter (€8,80/mese, fatturazione mensile) include 1 app pubblicata sul tuo dominio personalizzato, nessun badge Macaly e 1M crediti al mese. L'acquisto del dominio viene addebitato a parte. Starter non include l'integrazione con GitHub.

    **Per passare da Pro a Starter**, programma il passaggio in **Fatturazione**, oppure scegli Starter quando annulli Pro. Pro e i suoi crediti restano fino alla data di rinnovo. Al rinnovo, Macaly controlla il workspace. Se ha più di 1 app pubblicata o più di 5 GiB di file, il passaggio viene annullato e Pro si rinnova. Questo controllo non rimuove mai nulla dalla pubblicazione né elimina nulla. Puoi annullare un passaggio programmato con **Mantieni Pro**.
  </Accordion>

  <Accordion title="Posso ancora passare al piano Hosting?">
    No. Hosting non è più offerto ai nuovi clienti. Se hai già Hosting, mantieni piano, prezzo e funzionalità e puoi ancora gestirlo o annullarlo da **Fatturazione**.
  </Accordion>

  <Accordion title="Cosa succede al mio dominio personalizzato se annullo il piano Pro?">
    Se annulli Pro e torni al piano Gratuito, il tuo dominio personalizzato viene sostituito dalla URL Macaly predefinita e il badge Made with Macaly ricompare. Per mantenere entrambi, passa invece al piano Starter (€8,80/mese): programmalo in Fatturazione oppure scegli Starter quando annulli il piano Pro.
  </Accordion>
</AccordionGroup>

## Pubblicazione e deployment

<AccordionGroup>
  <Accordion title="Come pubblico il mio progetto?">
    Fai clic sul pulsante **Pubblica** nell'angolo in alto a destra dell'editor. Dopo la pubblicazione, il tuo sito è online su un sottodominio Macaly gratuito (ad esempio `mioprogetto.macaly.app`). Per collegare un dominio personalizzato vai su **Impostazioni → Domini**. Un dominio personalizzato richiede un piano Starter, Pro o Agenzie, oppure un piano Hosting già attivo.
  </Accordion>

  <Accordion title="La pubblicazione è bloccata da molto tempo sulla compilazione. Che cosa devo fare?">
    Apri la finestra di pubblicazione. Se mostra **Impossibile verificare lo stato**, fai clic su **Riprova**. Macaly ricontrolla lo stato senza avviare una nuova compilazione. Se resta bloccata, [contatta l'assistenza](mailto:support@macaly.com) con il link al tuo progetto.
  </Accordion>

  <Accordion title="L'anteprima mostra le modifiche ma il sito online no. Perché?">
    L'URL dell'anteprima e l'URL pubblicato (il tuo sottodominio Macaly o il dominio personalizzato) sono due ambienti separati. Devi fare clic su **Pubblica** per portare le modifiche sul sito online. Se il sito online continua a non aggiornarsi, riapri la finestra di pubblicazione. Se mostra **Pubblicazione non riuscita**, fai clic su **Correggi ora** per far riparare l'errore all'agente, oppure pubblica di nuovo. Se non basta, [contatta l'assistenza](mailto:support@macaly.com) con il link al tuo progetto.
  </Accordion>

  <Accordion title="Posso scaricare il codice sorgente del mio progetto?">
    Sì. Vai su **Impostazioni** nel tuo progetto e usa l'opzione di esportazione per scaricare uno ZIP con il codice sorgente. Questa funzionalità richiede come minimo il livello più basso del piano Pro e non è disponibile nel piano Gratuito.
  </Accordion>

  <Accordion title="Che cos'è il badge &#x22;Made with AI in Macaly&#x22; sul mio sito pubblicato?">
    È l'indicazione visibile che il tuo sito è stato creato con l'AI. Nel piano Gratuito non può essere disattivata; i piani Starter, Pro, Agenzie e Hosting già attivi possono nasconderla in **Impostazioni → Generale**. I siti pubblicati riportano anche un tag `ai-generated` leggibile dalle macchine. Vedi [Usare l'AI in modo responsabile](/docs/it/security/using-ai-responsibly).
  </Accordion>

  <Accordion title="Devo dire ai miei visitatori che il mio sito è stato creato con l'AI?">
    Macaly dichiara che la piattaforma è basata sull'AI, e il badge sul tuo sito pubblicato mostra come è stato creato. Se tu debba dichiarare qualcosa di più sui tuoi contenuti o sulle tue funzionalità AI dipende dalla legge applicabile e dal caso d'uso specifico. [Usare l'AI in modo responsabile](/docs/it/security/using-ai-responsibly) illustra le situazioni più comuni.
  </Accordion>

  <Accordion title="La mia app ha un suo chatbot AI. L'indicazione di Macaly lo copre?">
    No. L'indicazione che vedi in Macaly riguarda Macaly. Se il tuo progetto ha un chatbot o qualsiasi altra funzionalità AI, informare gli utenti finali fa parte della tua applicazione. Chiedi all'agente di aggiungere un'indicazione sopra il campo della chat o all'inizio della conversazione.
  </Accordion>
</AccordionGroup>

## Domini e hosting

<AccordionGroup>
  <Accordion title="Come collego un dominio personalizzato?">
    Nel tuo progetto, vai su **Impostazioni → Domini**, digita il nome del dominio e clicca su **Collega**. Macaly mostra i record DNS che devi aggiungere. Vai dal tuo registrar e aggiungi il record A e il record CNAME come indicato. Dopo aver salvato i record, torna in Macaly e clicca su **Aggiorna**. Per collegare un dominio personalizzato serve un piano Starter, Pro o Agenzie, oppure un piano Hosting già attivo.
  </Accordion>

  <Accordion title="Quali record DNS devo aggiungere per il mio dominio personalizzato?">
    Di solito servono due record:

    * Un **record A** per il dominio principale che punta all'indirizzo IP di Macaly
    * Un **record CNAME** per `www` che punta all'hostname di Macaly

    I valori esatti sono mostrati in **Impostazioni → Domini** quando aggiungi il tuo dominio.
  </Accordion>

  <Accordion title="Il mio sito funziona su www ma mostra un errore SSL sul dominio senza www. Come lo risolvo?">
    Aggiungi un record A per il dominio principale (apex) che punta all'indirizzo IP di Macaly (`216.150.1.1`). Rimuovi eventuali record A o AAAA in conflitto già presenti per il dominio principale. Se il dominio principale mostra **Certificato SSL mancante** in **Impostazioni → Domini** anche se i suoi record sono corretti, fai clic su **Riprova certificato SSL**. Puoi riprovare una volta all'ora. [Contatta l'assistenza](mailto:support@macaly.com) se non sei sicuro di quali record rimuovere.
  </Accordion>

  <Accordion title="Il mio dominio mostra ancora In sospeso o Non collegato. Cosa devo fare?">
    Ricontrolla che i record DNS presso il tuo registrar corrispondano esattamente a quelli indicati da Macaly. Rimuovi eventuali record in conflitto. Clicca su **Aggiorna** nel pannello Domini di Macaly. La propagazione DNS può richiedere fino a 24 ore.
  </Accordion>

  <Accordion title="Posso ancora acquistare il piano Hosting per usare un dominio personalizzato?">
    No. Il piano Hosting non è più offerto ai nuovi clienti. Per usare un dominio personalizzato, scegli il piano Starter (€8,80/mese) o Pro. Se hai già Hosting, mantieni piano, prezzo e funzionalità e puoi ancora gestirlo o annullarlo da **Fatturazione**.
  </Accordion>

  <Accordion title="Posso configurare le email sul mio dominio personalizzato?">
    Macaly non fornisce hosting per le email. Per avere un indirizzo email sul tuo dominio personalizzato (per esempio [info@tuosito.com](mailto:info@tuosito.com)), registrati presso un provider esterno come Google Workspace, Zoho o Microsoft 365 e configura i loro record MX presso il tuo registrar. Una volta ottenuto un indirizzo email, l'agente Macaly può creare moduli di contatto che gli inviano le notifiche.
  </Accordion>
</AccordionGroup>

## Email e notifiche

<AccordionGroup>
  <Accordion title="Macaly può inviare email dal mio progetto?">
    Sì. Macaly ha un'API email integrata basata su Resend. Per impostazione predefinita le email in uscita vengono inviate da `noreply@email.macaly-app.com`. Per inviare da un indirizzo sul tuo dominio ti servono un account Resend e una chiave API tuoi. Chiedi all'agente di configurare la funzionalità email e indica l'indirizzo del mittente e del destinatario che vuoi usare.
  </Accordion>

  <Accordion title="Quali sono i limiti di invio delle email?">
    Il limite predefinito è di massimo 10 email al minuto per applicazione. Macaly può solo inviare email, non riceverle. Non è adatto a newsletter o email di marketing in massa.
  </Accordion>

  <Accordion title="Le email di accesso con OTP non arrivano. Che cosa devo fare?">
    Prima di tutto controlla la cartella spam o posta indesiderata. Se le email davvero non arrivano, [contatta l'assistenza](mailto:support@macaly.com) con il link al tuo progetto e l'indirizzo email coinvolto. Il team può verificare la consegna delle email sul backend.
  </Accordion>
</AccordionGroup>

## Lavorare con l'agente

<AccordionGroup>
  <Accordion title="L'agente si è bloccato o ci mette troppo tempo. Cosa posso fare?">
    Se l'agente non mostra progressi per più di 10-15 minuti, ricarica la pagina. Se l'anteprima è bloccata, prova **Ricostruisci anteprima** o **Riavvia app** nella barra degli strumenti. Se l'ultima modifica ha danneggiato il tuo progetto, utilizza **Cronologia delle versioni** o **Ripristina questa versione**. Se il problema persiste, [contatta l'assistenza](mailto:support@macaly.com) con il collegamento alla chat e l'orario approssimativo. I crediti consumati durante una sessione bloccata confermata verranno esaminati.
  </Accordion>

  <Accordion title="L'agente continua a fare lo stesso errore. Come evito di consumare crediti inutilmente?">
    Quando segnali un errore, sii il più specifico possibile. Descrivi cosa stavi facendo prima dell'errore, cosa vedi ora, cosa non funziona e quale dovrebbe essere il comportamento corretto. Più dettagli fornisci, meglio l'agente riuscirà a correggerlo al primo tentativo.
  </Accordion>

  <Accordion title="Quanti passaggi può eseguire l'agente per ogni richiesta?">
    Macaly ha a disposizione circa 20 passaggi per ogni richiesta dell'utente. Se il tuo prompt è troppo complesso, l'agente potrebbe non completare tutto. Suddividi le richieste grandi in passaggi più piccoli e sequenziali: invia una modifica specifica per messaggio, verifica che funzioni e poi prosegui.
  </Accordion>

  <Accordion title="Come creo un backup del mio progetto?">
    Macaly salva le versioni del progetto in modo da poter ripristinare il codice precedente. Per le tue copie, utilizza [GitHub](/docs/it/integrations/github) per il codice se il tuo piano lo supporta e **Esporta** nella scheda **Database** per i dati della tabella. Lo ZIP non include i file caricati sulla tua app. Un duplicato copia il progetto corrente, non uno stato precedente del database.
  </Accordion>

  <Accordion title="Posso ripristinare una versione precedente del mio progetto?">
    Sì. Clicca sull'icona dell'orologio nella barra in alto per aprire la **Cronologia versioni**, scegli una versione per vederla in anteprima e clicca su **Ripristina**. Puoi anche usare il pulsante **Ripristina questa versione** sotto qualsiasi risposta dell'agente. In entrambi i casi il codice del progetto torna allo stato di quel momento. Vedi [Cronologia versioni](/docs/it/chat/overview#cronologia-versioni). Ciò ripristina solo il codice, non i dati del database o i file caricati nella tua app. Pubblica di nuovo per aggiornare il tuo sito live.
  </Accordion>
</AccordionGroup>

## Modelli AI

<AccordionGroup>
  <Accordion title="Posso scegliere quale modello AI usa Macaly?">
    Sì. Macaly funziona con diversi modelli di aziende differenti e puoi scegliere quale usa l'agente. GLM 5.3 Flash è il modello predefinito. È veloce, consuma pochi crediti e basta per la maggior parte delle modifiche di tutti i giorni. Vedi [Modelli AI](/docs/it/agent/models) per l'elenco completo e per capire a cosa si adatta ciascuno.
  </Accordion>

  <Accordion title="Dove cambio il modello?">
    Puoi cambiare il modello in due punti. Per cambiarlo per tutte le tue chat, apri **Impostazioni**, vai alla scheda **Preferenze** e scegli un modello nella sezione **AI**. Per scegliere un modello per un singolo progetto, apri quella chat, vai alla scheda **Impostazioni** e scegli un modello sotto **Modello AI**. L'impostazione di un progetto ha sempre la precedenza su quella del tuo account.
  </Accordion>

  <Accordion title="Quale modello dovrei usare?">
    Resta sul modello predefinito finché non hai un motivo per cambiare. Passa a un modello pensato per il lavoro complesso quando aggiungi cose come account utente, pagamenti o logiche più complesse. Scendi a uno più veloce ed economico per le modifiche ai testi e i piccoli ritocchi. Vedi [Modelli AI](/docs/it/agent/models) per le opzioni attuali.
  </Accordion>

  <Accordion title="Due modelli sembrano simili. Come scelgo tra i due?">
    Ogni azienda costruisce i propri modelli in modo diverso e le differenze si notano più nello stile che in quello che il modello sa fare. Quale ti si addice dipende spesso dal progetto e dalle preferenze personali, quindi vale la pena provarne più di uno.
  </Accordion>

  <Accordion title="Il modello che scelgo cambia la quantità di crediti che consumo?">
    Sì. Il consumo di crediti dipende dalle tariffe del modello scelto e dai token che elabora e genera. Anche la dimensione della modifica e la lunghezza della conversazione hanno un ruolo. Vedi [Piani e crediti](/docs/it/welcome/pricing) per capire come funzionano i crediti e cosa include ogni piano.
  </Accordion>

  <Accordion title="Dove girano i modelli?">
    Ogni modello è contrassegnato con **EU**, **US** o **Globale**. L’instradamento globale può elaborare le richieste in diverse regioni, anche al di fuori dell’UE. Se il tuo progetto tratta dati personali e hai bisogno che restino nell'UE, scegli un modello contrassegnato con **EU**.
  </Accordion>

  <Accordion title="Posso cambiare il modello a metà progetto?">
    Sì. La tua scelta si applica al messaggio successivo. Tutto quello che l'agente ha già creato resta com'è e mantiene l'intera cronologia del tuo progetto, quindi puoi cambiare modello in qualsiasi momento senza perdere nulla.
  </Accordion>

  <Accordion title="Il mio progetto usa un modello che non è nell'elenco. Cosa è successo?">
    I progetti che hai avviato tempo fa possono essere ancora impostati su un modello che nel frattempo è stato ritirato. Quei progetti continuano a funzionare. Ora girano sulla versione più recente dello stesso modello, quindi ottieni i miglioramenti senza fare nulla. Le nuove chat usano sempre i modelli attuali.
  </Accordion>
</AccordionGroup>

## Problemi tecnici ed errori

<AccordionGroup>
  <Accordion title="Che cosa significa il codice di errore 524 o un timeout di Cloudflare?">
    L'errore 524 è un timeout: significa che il server non ha risposto in tempo. Prova ad aggiornare la pagina dopo un minuto o due. Se il problema persiste, [contatta l'assistenza](mailto:support@macaly.com) con il link alla tua chat. Puoi verificare gli incidenti in corso su status.macaly.com.
  </Accordion>

  <Accordion title="L'anteprima segnala Failed to Start oppure il server di sviluppo è andato in crash. Che cosa devo fare?">
    Il server del sandbox è andato in crash. Dovrebbe riavviarsi automaticamente entro uno o due minuti. Se non succede, [contatta l'assistenza](mailto:support@macaly.com) con il link alla tua chat. Il team può riavviare il sandbox e rimborsare i crediti consumati durante il disservizio.
  </Accordion>

  <Accordion title="Ricevo l'errore &#x22;Application error: a client-side exception has occurred&#x22;. Che cosa non va?">
    Se lo vedi nell'editor di Macaly, ricarica la pagina. Se si ripete, [contatta l'assistenza](mailto:support@macaly.com) con il link alla tua chat. Se l'errore compare sul tuo sito pubblicato, segnalalo all'agente con una descrizione chiara oppure [contatta l'assistenza](mailto:support@macaly.com).
  </Accordion>

  <Accordion title="Il caricamento delle immagini non riesce. Quali sono i limiti di dimensione?">
    Le singole immagini non devono superare 8000×8000 pixel. Se carichi più di 20 immagini in una sola richiesta, ognuna deve restare sotto i 2000×2000 pixel. I file dovrebbero essere sotto i 5 MB. Se incontri un errore nel caricamento di un SVG, [contatta l'assistenza](mailto:support@macaly.com).
  </Accordion>
</AccordionGroup>

## Duplicazione dei progetti

<AccordionGroup>
  <Accordion title="Come duplico un progetto?">
    Apri il menu chat e seleziona **Duplica**. Un duplicato normale copia il progetto corrente senza la cronologia delle conversazioni e ottiene un database separato. I dati della tabella corrente vengono copiati dove supportato; i progetti più vecchi con una vecchia configurazione App Files potrebbero iniziare con un database vuoto e senza file caricati. Pubblica la copia e ricollega il suo dominio personalizzato, se necessario. Utilizza la **Cronologia delle versioni** per ripristinare una versione precedente del codice.
  </Accordion>

  <Accordion title="Le copie condividono lo stesso database?">
    No. Ogni copia ha un proprio database separato.
  </Accordion>

  <Accordion title="Posso condividere il mio progetto in modo che qualcun altro lo duplichi nel proprio account?">
    Sì. Fai clic su **Condividi** accanto al pulsante **Pubblica** e imposta la visibilità su **Chiunque abbia il link**. Poi condividi il link: chiunque lo apra può vedere il progetto e duplicarlo nel proprio account Macaly.
  </Accordion>

  <Accordion title="Creo siti web per i clienti. Possono prendere in carico il sito nel proprio account Macaly?">
    Sì. Qualsiasi progetto può essere duplicato e condiviso con il tuo cliente, che può poi continuare a sviluppare e gestire il sito nel proprio account Macaly, in modo indipendente da te.
  </Accordion>
</AccordionGroup>

## Database

<AccordionGroup>
  <Accordion title="Devo configurare un database?">
    No. Ogni progetto Macaly ne riceve uno automaticamente. Non devi configurarne uno presso un provider, inserire credenziali o collegare nulla. Descrivi cosa vuoi memorizzare, per esempio gli invii dei moduli di contatto o gli articoli del blog, e l'agente crea le tabelle e le collega al tuo progetto.
  </Accordion>

  <Accordion title="Quale database usa Macaly?">
    Macaly usa Convex. Ogni progetto ha il proprio database isolato con aggiornamenti in tempo reale e scalabilità automatica, ospitato nell'UE. Vedi [Database](/docs/it/features/databases).
  </Accordion>

  <Accordion title="Il database ha un costo aggiuntivo?">
    Il database è incluso in ogni piano e, finché resti entro la soglia di utilizzo mensile, non consuma crediti. Sui piani Starter, Pro e Agenzie l'utilizzo oltre la soglia viene addebitato in crediti. Su Starter, Pro e Agenzie, ogni 1GiB aggiuntivo iniziato costa 200K crediti. Su Starter, Pro e Agenzie, ogni 100.000 chiamate API backend aggiuntive costano 200K crediti. La soglia viene conteggiata sull'intero workspace e si azzera all'inizio di ogni mese di calendario. Se a metà mese passi a un piano superiore da Gratuito o Hosting, la soglia del piano a pagamento parte dal passaggio e l'utilizzo precedente non viene mai addebitato. Trovi i dettagli in [Piani e crediti](/docs/it/welcome/pricing#utilizzo-del-database).
  </Accordion>

  <Accordion title="Come visualizzo e modifico i miei dati?">
    La scheda **Database** elenca le tue tabelle e mostra le righe di ciascuna. Puoi filtrarle e ordinarle, modificare i valori direttamente lì, aggiungere righe o eliminarle. La creazione delle tabelle e la modifica dei campi che contengono avvengono nel codice del progetto, quindi chiedile all'agente, per esempio: "Aggiungi un campo telefono alla tabella Leads."
  </Accordion>

  <Accordion title="Posso lavorare su dati di test invece che sui dati reali?">
    Sì. Nella scheda **Database**, fai clic su **Aggiungi modalità di test** e Macaly crea un database **Test**, una copia separata dei tuoi dati in cui puoi lavorare senza cambiare quello che vedono i tuoi utenti. Puoi passare dal database Live a quello Test quando vuoi e pubblicare da entrambi. La pubblicazione dal database Test parte da un controllo di compatibilità, così la tua app pubblicata continua a funzionare con i dati che ha già.
  </Accordion>

  <Accordion title="Come scarico una copia dei miei dati?">
    **Esporta** nella scheda **Database** scarica uno snapshot ZIP dei dati delle tue tabelle, e **Importa** lo ripristina. I file che il tuo progetto memorizza, come le immagini caricate, non fanno parte di quel file. Tieni uno snapshot prima di modifiche importanti, perché sia l'eliminazione delle righe sia l'importazione di uno snapshot sostituiscono i dati in modo definitivo.
  </Accordion>
</AccordionGroup>

## SEO

<AccordionGroup>
  <Accordion title="Come gestisce Macaly la SEO?">
    Macaly crea siti ottimizzati per i motori di ricerca. Rendering lato server, HTML pulito e meta tag sono gestiti automaticamente da Macaly. Una volta pubblicato il progetto, l'audit SEO assegna un punteggio al tuo sito e ti indica cosa migliorare. Puoi anche modificare i meta tag, i titoli e le descrizioni delle pagine in **Impostazioni → SEO**.
  </Accordion>

  <Accordion title="Perché non riesco ad avviare l'audit SEO?">
    L'audit nella scheda SEO controlla il sito pubblicato, quindi resta bloccato finché non pubblichi. Se vuoi un punteggio prima, chiedi all'agente in chat un audit SEO: analizzerà un'anteprima delle modifiche su cui stai lavorando.
  </Accordion>

  <Accordion title="Il mio audit SEO sembra non aggiornato. Perché?">
    L'audit riflette l'ultima versione pubblicata. Se hai cambiato qualcosa da allora, pubblica di nuovo il progetto e i risultati dell'audit si aggiorneranno. Puoi anche chiedere all'agente di controllare le modifiche non pubblicate su un'anteprima.
  </Accordion>

  <Accordion title="Che cosa significa Pronto per l'AI?">
    Pronto per l'AI misura quanto i crawler AI, come quelli di ChatGPT, Claude o Perplexity, riescono a raggiungere il tuo sito e a capirlo. Controlla che i contenuti si trovino nella pagina stessa invece di essere caricati con JavaScript, che i crawler AI non siano bloccati e che sia disponibile un file llms.txt a guidarli. Macaly esegue automaticamente il rendering delle tue pagine sul server.
  </Accordion>

  <Accordion title="Come miglioro il mio punteggio SEO?">
    Lavora sull'elenco dei problemi, prima gli errori e poi gli avvisi. Puoi usare il pulsante Correggi tutto con l'AI e passare all'agente tutti i problemi in una volta, oppure affrontarli uno alla volta. Poi pubblica le modifiche e il punteggio si aggiorna al prossimo audit.
  </Accordion>

  <Accordion title="Il mio sito non compare nella ricerca Google. Cosa posso fare?">
    L'indicizzazione di Google richiede tempo, spesso da alcuni giorni a qualche settimana. Per accelerarla, invia la URL del tuo sito a Google Search Console su search.google.com/search-console. Puoi anche condividere la tua URL sui social, dato che Google scansiona i link che trova altrove sul web.
  </Accordion>

  <Accordion title="Posso incorporare un sito Macaly in un altro sito con un iframe?">
    Tecnicamente sì, usando la URL Macaly pubblicata dentro un iframe. Tuttavia i contenuti all'interno degli iframe vengono indicizzati male dai motori di ricerca, con un impatto negativo sulla tua SEO. Un approccio migliore è usare Macaly come sito autonomo con un proprio dominio personalizzato.
  </Accordion>
</AccordionGroup>

## Account

<AccordionGroup>
  <Accordion title="Qual è la differenza tra il mio account e un workspace?">
    Il tuo account è la tua identità personale: la tua email, l'accesso e le preferenze personali come il tema e la lingua. Un workspace è il luogo in cui avviene il lavoro vero e proprio, con i suoi progetti, crediti, membri e la sua fatturazione. Un solo account può far parte di più workspace, il che è utile per separare i progetti personali dal lavoro per i clienti o per collaborare con team diversi.
  </Accordion>

  <Accordion title="Perché alcune impostazioni cambiano quando passo a un altro workspace?">
    Le impostazioni nella sezione Personale seguono il tuo account ovunque. Il tema, la lingua, il modello AI preferito e le notifiche restano gli stessi in ogni workspace. Le impostazioni nella sezione Workspace sono legate a ciascun workspace, quindi membri, domini, chiavi API e connessioni sono diversi in ognuno.
  </Accordion>

  <Accordion title="Come cambio il mio indirizzo email?">
    [Contatta l'assistenza](mailto:support@macaly.com) e indica il nuovo indirizzo email. Il team lo aggiornerà lato backend. Nota: non puoi usare un indirizzo email già registrato a un altro account Macaly.
  </Accordion>

  <Accordion title="Non riesco ad accedere e non ricevo le email con l'OTP.">
    Controlla prima la cartella spam o posta indesiderata. Se l'email non arriva affatto, [contatta l'assistenza](mailto:support@macaly.com). Il team può verificare lo stato del tuo account e aiutarti con l'autenticazione.
  </Accordion>

  <Accordion title="Come esco dagli altri dispositivi?">
    Apri Impostazioni → Sicurezza. Vedrai tutti i dispositivi attualmente connessi al tuo account, con la possibilità di uscire da remoto. È utile se hai usato Macaly su un computer condiviso o se hai perso un dispositivo.
  </Accordion>

  <Accordion title="Come elimino definitivamente il mio account?">
    [Contatta l'assistenza](mailto:support@macaly.com) e richiedi l'eliminazione dell'account. Il team eliminerà il tuo account e tutti i dati associati. Nota: questa azione è irreversibile. Tutti i progetti, i crediti e i dati verranno rimossi definitivamente.
  </Accordion>
</AccordionGroup>

## Workspace

<AccordionGroup>
  <Accordion title="I workspace condividono i crediti?">
    No. Ogni workspace ha il proprio piano e i propri crediti. Se fai parte di più workspace, ognuno tiene traccia dei crediti e della fatturazione in modo indipendente. Passare a un altro workspace significa passare al suo saldo di crediti.
  </Accordion>

  <Accordion title="Ricevo crediti gratuiti in ogni workspace che creo?">
    No. Il milione di crediti gratuiti mensili vale solo per il tuo workspace predefinito, quello creato al momento della registrazione. Gli eventuali workspace aggiuntivi che crei partono dal piano Gratuito ma senza crediti, quindi dovrai passarli a un piano a pagamento per usare l'agente.
  </Accordion>

  <Accordion title="Cosa succede ai miei progetti se elimino un workspace?">
    Tutto ciò che si trova in quel workspace viene eliminato definitivamente: progetti, chat, database e qualsiasi dominio personalizzato collegato. L'operazione non può essere annullata, quindi fai un backup o duplica tutto quello che vuoi conservare prima di eliminarlo.
  </Accordion>

  <Accordion title="Un workspace può avere più di un proprietario?">
    No. Ogni workspace ha esattamente un proprietario, che gestisce la fatturazione, l'amministrazione e i membri. Tutti gli altri sono membri con accesso completo alle chat e ai crediti, ma senza diritti di amministrazione.
  </Accordion>

  <Accordion title="Posso trasferire la proprietà di un workspace a un'altra persona?">
    Al momento la proprietà di un workspace non può essere trasferita dall'interfaccia. Se hai bisogno di cambiare il proprietario di un workspace, [contatta l'assistenza](mailto:support@macaly.com) e il team potrà aiutarti.
  </Accordion>

  <Accordion title="Quanti workspace posso avere?">
    Non c'è un limite fisso. Molti utenti creano workspace separati per i progetti personali, per i clienti o per team diversi.
  </Accordion>

  <Accordion title="Posso spostare una chat da un workspace a un altro?">
    Non esiste un'opzione integrata per spostare una chat tra workspace. [Contatta l'assistenza](mailto:support@macaly.com) allegando il link alla chat e indicando il workspace di destinazione, e il team potrà aiutarti.
  </Accordion>

  <Accordion title="Cosa succede se annullo il piano a pagamento su uno dei miei workspace?">
    Il workspace continua a esistere ma torna ai limiti del piano Gratuito alla fine del periodo di fatturazione. La tua app pubblicata resta accessibile sul sottodominio Macaly predefinito, ma i domini personalizzati e le funzionalità Pro smettono di funzionare a meno che tu non passi al piano Starter, che mantiene un'app sul tuo dominio personalizzato. Il piano Gratuito include 1 app pubblicata. Se il workspace ha più app online, proprietari e amministratori ricevono un'email e il tempo per scegliere quale resta online. Le altre app vengono poi rimosse dalla pubblicazione, ma i tuoi progetti e i tuoi dati restano.
  </Accordion>
</AccordionGroup>

## Assistenza

<AccordionGroup>
  <Accordion title="Quanto velocemente risponde l'assistenza di Macaly?">
    Il team punta a rispondere entro un giorno lavorativo. L'assistenza ha sede in Europa (fuso orario CET) ed è chiusa nel weekend. Nei periodi di festività le risposte possono richiedere un po' più di tempo.
  </Accordion>

  <Accordion title="Come segnalo un bug che mi ha fatto consumare crediti?">
    [Contatta l'assistenza](mailto:support@macaly.com). Includi il link alla chat interessata, una descrizione di che cosa è successo e all'incirca quando. Prima di scrivere all'assistenza, usa il pulsante **Segnala un problema** sulla risposta dell'agente che ha creato il problema: allega contesto utile per il team di sviluppo.
  </Accordion>

  <Accordion title="Esiste una pagina di stato dove controllare i disservizi?">
    Sì. [status.macaly.com](https://status.macaly.com) mostra le informazioni sugli incidenti attivi e sui disservizi recenti.
  </Accordion>
</AccordionGroup>


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