# Importare contenuti da un foglio di calcolo

> Come portare post, articoli e post brevi da un foglio .xlsx o .csv con la data e l'autore originali (file, colonne, opzioni, anteprima, avanzamento e report), cosa fa saltare una riga, ogni avviso e i limiti.

Il pulsante **Importa contenuti** porta nella community lo storico che stava altrove (WordPress, Substack, Circle, un vecchio gruppo, un foglio di calcolo): ogni riga del foglio diventa un post, un articolo o un post breve, con la **data originale** e, quando è possibile, l'**autore originale**. Indichi dove va ogni colonna, controlli un'anteprima e solo allora importi. Nessuno riceve notifiche.

## A cosa serve

| Community | Foglio di calcolo |
|---|---|
| In migrazione da un blog o una newsletter | L'esportazione degli articoli, con titolo, testo in HTML, data ed e-mail dell'autore |
| Forum o vecchio gruppo | Le discussioni, ognuna con l'e-mail di chi l'ha aperta, verso uno spazio Feed |
| Associazione | L'archivio dei comunicati degli ultimi anni, tutti in uno spazio Contenuti |
| Corso | Gli avvisi della classe come post brevi, nell'ordine in cui sono usciti |

## Come funziona

### Dove si trova e chi può

Nell'intestazione degli spazi **Contenuti** e **Feed**, clicca sulla freccia accanto a **Nuovo Contenuto** (nel Feed, **Nuovo Status**) e scegli **Importa contenuti**. Solo il **proprietario** e l'**amministratore** vedono questa opzione; per gli altri ruoli non compare, e l'API rifiuta.

Con l'ingresso nella community sospeso da Memberfy, l'importazione non parte. Vedi [Sospensione di ingressi e vendite](/membros/politica-de-convites#sospensione-di-ingressi-e-vendite).

### I tre tipi

| Tipo | Come entra | Dove può entrare |
|---|---|---|
| **Post** | Titolo e testo | Spazio Contenuti o Feed |
| **Articolo** | Titolo e testo | Spazio Contenuti o Feed |
| **Post breve** | Solo testo, fino a 500 caratteri, senza titolo e senza tag | Solo spazio Feed |

Il tipo vale per tutte le righe (opzione **Tipo**) o arriva da una colonna del foglio, con valori come *post*, *articolo* o *breve* (anche *status*, *blog*, *newsletter*, in italiano, inglese, spagnolo, portoghese o tedesco).

### Cosa rispetta l'importazione

- **La data originale resta.** Il post entra con la data del foglio come [data di pubblicazione](/espacos/conteudo#data-di-pubblicazione), al posto di quella data nel Feed e nell'elenco dello spazio, e non in cima.
- **In silenzio.** Nulla viene notificato: nessun membro riceve avvisi né e-mail, i post restano fuori dalle e-mail di novità e dai contenuti in evidenza, e nessuno guadagna punti nella [Classifica](/espacos/ranking). Solo chi ha importato riceve, alla fine, un'e-mail con il riepilogo.
- **L'autore arriva dall'e-mail.** La colonna dell'e-mail dell'autore collega ogni riga a una persona della community. Deve essere membro e avere un **ruolo inferiore al tuo** (il proprietario importa a nome di amministratori, moderatori, finanza e membri; l'amministratore, a nome di moderatori, finanza e membri). Altrimenti la riga viene saltata e il report dice perché. La tua e-mail vale sempre. Chi ha importato resta registrato nei [Log](/membros/registros-de-atividades) per ogni post fatto a nome di un'altra persona.
- **Una data nel futuro o non valida non entra.** La riga viene saltata. Una **data vuota** diventa la data dell'importazione, e la riga entra con un avviso.
- **Nulla entra due volte.** Un post o articolo con lo stesso titolo e la stessa data di uno già presente nella community viene saltato; importare di nuovo lo stesso foglio non crea duplicati. Anche le righe ripetute nel foglio stesso entrano una volta sola.
- **Le immagini arrivano insieme.** Le immagini dentro il testo vengono scaricate e ospitate su Memberfy, con gli stessi limiti di un'immagine caricata dall'app; i link del testo restano come sono. L'immagine che non si può scaricare resta come link all'originale, e il report lo segnala.
- **I link diventano player o scheda.** I link nel testo di ogni post importato diventano [player o scheda](/espacos/conteudo#i-link-diventano-player-o-scheda), fino a 5 per post, in background, dopo l'ingresso del post.

### Limiti

| Cosa | Limite |
|---|---|
| File | **.xlsx** o **.csv**, fino a **5 MB** |
| Righe | Fino a **5.000** righe di dati (e 100 colonne) |
| Immagini per riga | **20**; le successive restano come link |
| Immagini per importazione | **300** o **500 MB**, quello che arriva prima; le successive restano come link |
| Importazioni contemporanee | **Una** per community; la successiva parte quando la precedente finisce |

Un foglio i cui testi insieme superano i 25 MB viene rifiutato prima di iniziare: dividilo in parti più piccole.

## Passo dopo passo

### 1. File

1. Nello spazio Contenuti o Feed, fai clic su **Importa contenuti**.
2. Trascina il foglio o fai clic per sceglierlo (**.xlsx o .csv · fino a 5 MB e 5.000 righe**).
3. Controlla la lettura:
   - **Foglio**: in un .xlsx, quale foglio leggere.
   - **Riga di intestazione**: Memberfy la trova da sola; per cambiarla, fai clic su un'altra riga della tabella.
   - **Separatore** (virgola, punto e virgola, tabulazione o barra verticale) e **Codifica**: in un .csv, riconosciuti da soli; puoi cambiarli.

### 2. Colonne

Ogni colonna compare con le prime 3 righe e una destinazione suggerita in **Va in**. Sistema quello che serve; ciò che resta su **Ignora** non viene importato. Ogni destinazione accetta una sola colonna.

| Destinazione | Cosa ci va |
|---|---|
| **Titolo** | Obbligatorio per post e articoli. I titoli oltre i 300 caratteri vengono tagliati |
| **Contenuto** | Testo, Markdown o HTML. Obbligatorio per continuare |
| **E-mail dell'autore** | Il post va a nome della persona della community con questa e-mail. Senza questa colonna, tutto esce a tuo nome |
| **Data di pubblicazione** | La data originale. Una data senza fuso usa il fuso della community |
| **Space** | L'id, l'indirizzo o il nome di uno spazio Contenuti o Feed (maiuscole e accenti non contano) |
| **Tipo** | post, articolo o breve |
| **Tag** | Più valori, separati da virgola, punto e virgola o barra verticale (fino a 20 per post) |

### 3. Opzioni

- **Space** (o **Space predefinito**, quando c'è una colonna di space): dove entrano i post, o lo spazio usato quando la riga non ne ha uno valido. **Nessuno (salta la riga)** salta le righe senza uno space valido.
- **Tipo** (o **Tipo predefinito**): Post, Articolo o Post breve. Il post breve entra solo in uno spazio Feed.
- **Chi vede**: **Solo membri** o **Pubblico**.
- **Ordine delle date**, che compare quando il foglio ha date come 03/04/2024: **Giorno/mese/anno** o **Mese/giorno/anno**. La schermata mostra un esempio del foglio (*"03/04/2024 sarà letta come 3 aprile 2024."*) e, quando il foglio ha una data che sta in un solo ordine (come 25/12/2023), sceglie quello e lo segnala.
- **Fuso**: le date senza fuso sono lette nel fuso della community, che la schermata mostra.
- **Autore con e-mail sconosciuta**, per quando l'e-mail del foglio non è di nessuno della community: **Salta la riga** o **Pubblica a mio nome** (la riga entra con un avviso).

Le date accettate: AAAA-MM-GG (con o senza ora e fuso), GG/MM/AAAA o MM/GG/AAAA (con `/`, `.` o `-` e ora facoltativa), date con il nome del mese in inglese (*15 March 2024*, *Mar 15, 2024*) e timestamp Unix. Nel .xlsx, la cella data di Excel vale così com'è.

### 4. Anteprima

L'anteprima non salva nulla. Mostra il riepilogo (righe nel foglio, quanti saranno importati, quanti con data originale, quanti senza data, righe saltate, righe con avvisi, immagini da scaricare e dimensione dei testi) e le **prime 10 righe** come saranno: tipo, titolo, spazio, autore, data e avvisi, con quelle saltate segnalate.

### 5. Confermare

Fai clic su **Importa N post** e conferma. L'importazione gira in background: puoi chiudere la finestra.

### 6. Avanzamento

La schermata mostra *"120 di 800 righe"*. **Annulla importazione** ferma le righe mancanti; i post già entrati restano pubblicati.

### 7. Report e storico

Alla fine, la schermata mostra **Importati**, **Saltati**, **Con errore** e **Con avvisi**, le **Righe non entrate** (con il motivo) e quelle **Entrati con avvisi**. **Scarica il report** genera un CSV con la riga, il risultato, il titolo e il motivo. Chi ha importato riceve anche il riepilogo via e-mail.

**Importazioni precedenti**, in alto nella finestra, elenca le importazioni della community, con lo stato (**Non avviata**, **In coda**, **In importazione**, **Completata**, **Non riuscita**, **Annullata** o **Abbandonata**) e **Vedi** per aprire il report. Un foglio analizzato e non importato entro 24 ore diventa **Abbandonata**.

## Perché una riga è stata saltata

| Nel report | Cosa vuol dire | Cosa fare |
|---|---|---|
| **Senza titolo** | Post o articolo senza titolo | Compila il titolo o importa la riga come post breve |
| **Senza contenuto** | Post breve senza testo | Compila il contenuto |
| **Nessuno space valido** | La riga non indica uno spazio che accetti quel tipo, e non c'è uno spazio predefinito adatto | Scegli uno spazio predefinito, o correggi la colonna di space |
| **Data non valida** | La data non è stata capita, o non esiste (come 31/02) | Correggi la data o cambia l'**Ordine delle date** |
| **Data nel futuro** | La data è successiva a adesso: l'importazione non programma post | Correggi la data |
| **Contenuto troppo lungo** | Post breve con più di 500 caratteri | Importalo come post o articolo |
| **Ripetuta nel foglio** | Stesso tipo, titolo, data e inizio del testo di una riga precedente | Nulla: la prima è entrata |
| **Esiste già un post con questo titolo e questa data** | Un post o articolo uguale è già nella community, da un'importazione precedente o fatto a mano | Nulla: è ciò che evita i duplicati |
| **L'e-mail dell'autore non è di nessuno della community** | L'e-mail non è di un membro, e l'opzione è **Salta la riga** | Invita prima la persona, o scegli **Pubblica a mio nome** |
| **Puoi pubblicare solo a nome di chi ha un ruolo inferiore al tuo** | L'e-mail è di qualcuno con un ruolo uguale o superiore al tuo | Chiedi a un proprietario di importare, o togli l'e-mail dalla riga |
| **Errore nel salvataggio** (risultato **Non riuscito**) | Qualcosa è andato storto nel salvare quella riga | Importa di nuovo il foglio: ciò che è già entrato viene saltato |

## Cosa vuol dire ogni avviso

La riga con un avviso **è entrata**; l'avviso dice cosa è cambiato.

| Avviso | Cosa vuol dire |
|---|---|
| **Tipo non riconosciuto** | Il valore della colonna Tipo non è post, articolo né breve; è valso il tipo delle opzioni |
| **Titolo tagliato** | Il titolo superava i 300 caratteri ed è stato tagliato |
| **Space non trovato** | Lo spazio della riga non esiste nella community; è valso lo spazio predefinito |
| **Space di altro tipo** | Lo spazio della riga non accetta quel tipo (per esempio, un post breve in uno spazio Contenuti); è valso lo spazio predefinito |
| **Senza data** | La cella della data era vuota; il post è entrato con la data dell'importazione |
| **Autore non trovato** | L'e-mail non è di nessuno della community; il post è uscito a tuo nome (opzione **Pubblica a mio nome**) |
| **Tag ignorati** | Il post breve non ha tag |
| **Immagine non scaricata** | Un'immagine del testo non è stata scaricata; resta il link all'originale |
| **Immagine non supportata** | L'indirizzo dell'immagine non è un link web scaricabile; resta come link |
| **Troppe immagini nel post** | Il testo aveva più di 20 immagini; le successive restano come link |
| **Limite di immagini dell'importazione** | L'importazione ha raggiunto 300 immagini o 500 MB; le successive restano come link |

## Domande frequenti

**I membri riceveranno una valanga di avvisi?**
No. Nulla dell'importazione notifica i membri né conta punti, qualunque sia la data.

**Posso importare commenti e reazioni?**
No. L'importazione porta post, articoli e post brevi. Per portare persone, usa [Importare membri da un foglio di calcolo](/membros/importar-membros).

**Ho importato e mancavano alcune persone come autori. Posso importare di nuovo?**
Sì. Invita le persone, importa lo stesso foglio e le righe già entrate vengono saltate come *Esiste già un post con questo titolo e questa data*. I post brevi non passano per questo controllo: in una seconda importazione, lascia solo le righe mancanti.

**E se sbaglio la data di un post?**
Modifica il post e cambia la **Data di pubblicazione**. Vedi [Data di pubblicazione](/espacos/conteudo#data-di-pubblicazione).

## Con l'assistente

L'assistente fa la stessa importazione in quattro passaggi: `analyze_content_import` (legge il foglio), `preview_content_import` (il riepilogo, senza salvare), `start_content_import` (importa dopo aver mostrato il riepilogo) e `get_content_import` (avanzamento e report). Vedi [Strumenti · Contenuti](/mcp/ferramentas-conteudo#analyze-content-import).

## Nell'API

`POST /api/import/spreadsheet` (carica il file e restituisce l'analisi), `POST /api/import/spreadsheet/{id}/preview` (il riepilogo e le prime 10 righe), `POST /api/import/spreadsheet/{id}/start` (conferma e mette in coda), `GET /api/import/spreadsheet/{id}` (avanzamento e report), `GET /api/import/spreadsheet` (storico) e `DELETE /api/import/{importId}` (annulla). Solo proprietario e amministratore, con l'`X-CommunityId`. Vedi [Import](/api/referencia/import).

## Correlati

- [Contenuti](/espacos/conteudo)
- [Feed](/espacos/feed)
- [Importare membri da un foglio di calcolo](/membros/importar-membros)
- [Log](/membros/registros-de-atividades)