Importa link in blocco da un CSV

Se hai un foglio di calcolo di URL di destinazione che vuoi abbreviare tutti in una volta — migrando da un altro strumento, lanciando una campagna o popolando un nuovo workspace — l'importer in blocco è la soluzione giusta. Visualizza in anteprima gli errori prima che qualcosa venga confermato, in modo da poter correggere i problemi senza importazioni parziali.

Formato CSV#

L'importer si aspetta un file separato da virgole con una riga di intestazione. L'unica colonna obbligatoria è destination. Tutto il resto è opzionale.

destination,slug,title,tags
https://acme.com/spring-sale,spring-2026,Spring Sale 2026,campaign:spring
https://acme.com/about,,About Us,
https://acme.com/contact,contact-us,,support:contact

Regole delle colonne:

• destination (obbligatoria) — l'URL completo incluso https://. Gli URL senza schema vengono rifiutati.
• slug (opzionale) — uno slug abbreviato personalizzato. Solo lettere, numeri e trattini. Se vuoto, generiamo un codice casuale di 6 caratteri.
• title (opzionale) — un'etichetta leggibile dall'uomo mostrata nella lista dei link.
• tags (opzionale) — uno o più tag separati da due punti o punti e virgola. I tag vengono creati automaticamente se non esistono.

L'ordine delle colonne non ha importanza purché i nomi dell'intestazione corrispondano. Le colonne extra vengono ignorate.

Avvia un'importazione#

1. Vai su Strumenti → Importazione bulk (o fai clic sul pulsante di importazione da Link).
2. Carica il tuo file CSV. L'importer lo analizza e mostra una tabella di anteprima.
3. Rivedi l'anteprima. Le righe con errori vengono evidenziate — passa il cursore sull'icona di errore per vedere cosa non va.
4. Fai clic su Importa per scrivere le righe valide. Le righe con errori vengono saltate.

L'importazione viene eseguita in background. Per i file grandi, un indicatore di avanzamento mostra quante righe sono state elaborate. Riceverai un'email di riepilogo quando è terminata.

Il limite di 50.000 link#

Ogni esecuzione di importazione è limitata a 50.000 righe. Se il tuo file è più grande, dividilo in più file ed eseguili in sequenza. Non c'è un limite giornaliero sulle esecuzioni di importazione.

Deduplicazione#

L'importer controlla gli slug rispetto ai link esistenti. Se lo slug di una riga esiste già nel workspace:

• La riga viene saltata con un errore ("slug already taken").
• Il link esistente non viene modificato.

Se la colonna slug è vuota, generiamo sempre un nuovo codice univoco, quindi le righe con slug vuoto non entrano mai in conflitto.

Se stai reimportando un file che hai parzialmente elaborato in precedenza, l'importer è idempotente per le righe con slug vuoto (ogni esecuzione crea nuovi link con nuovi codici). Per gli slug espliciti, avranno successo solo le righe con slug che non esistono già nel workspace.

Errori comuni di importazione e correzioni#

"Invalid URL" — la destinazione non include uno schema (https://) o contiene caratteri non validi in un URL. Correggi la cella nel tuo foglio di calcolo e ricarica.

"Slug already taken" — esiste già un link con quello slug. Rimuovi lo slug per ottenerne uno auto-generato, o cambialo in qualcosa di unico.

"Slug contains invalid characters" — gli slug possono contenere solo lettere (a-z, A-Z), numeri (0-9) e trattini (-). Spazi, underscore e punti non sono consentiti.

"File too large" — il file supera il limite di 50.000 righe. Dividilo e importa in batch.

"Destination blocked" — il nostro scanner URL ha segnalato la destinazione come dannosa o in una categoria bloccata. Se ritieni che si tratti di un falso positivo, contatta il supporto con l'URL.

Risoluzione dei problemi#

La mia importazione è terminata ma alcune righe mancano. Scarica il report di importazione — appare un link nel riepilogo dell'importazione. Il report mostra quali righe sono state saltate e perché. La maggior parte dei salti sono slug duplicati o URL non validi.

L'importer dice che il file è malformato. Assicurati che il file sia effettivamente CSV (non TSV o Excel .xlsx). Aprilo in un editor di testo e conferma che le virgole siano il delimitatore e che la riga di intestazione sia presente.

L'importazione è bloccata su "processing". Le importazioni grandi (decine di migliaia di righe) possono richiedere alcuni minuti. Aggiorna la pagina per controllare lo stato attuale. Se è ancora bloccata dopo 10 minuti, contatta il supporto con l'ID importazione mostrato nell'URL.