Caricare un file su dosya da Zapier

Usa l’azione Upload File dell’app dosya per copiare un file da un evento di attivazione o da un’azione precedente dello Zap nello spazio cloud dosya. L’input File è un riferimento file Zapier o un URL scaricabile, non dati binari n8n né testo base64 incollato.

Accetta l’invito all’app privata e collega l’account

dosya è attualmente un’app privata Zapier e non compare nella ricerca pubblica. Accedi all’account Zapier che sarà proprietario del flusso. Nell’app web dosya apri Integrazioni → Zapier, scegli Apri l’invito Zapier e accetta l’invito con lo stesso account Zapier. Se l’organizzazione limita le app private, chiedi all’amministratore di approvare dosya prima di creare lo Zap. Se dosya manca dal selettore dei passaggi, torna alla pagina di configurazione e verifica che l’invito sia stato accettato dall’account aperto in Zapier.

Torna all’editor dello Zap, aggiungi dosya → Upload File e collegalo con dosya API key. Crea la chiave in Profilo → Chiavi API: scegli Accesso completo, abilita API REST e lascia vuoto il vincolo alla cartella. Vincolala a uno spazio di lavoro se lo Zap deve accedere solo a quello. Non usare la password dosya. La connessione porta l’email del proprietario della chiave.

Il controllo di autenticazione richiede accesso completo perché l’integrazione sottoscrive anche eventi dei file. L’errore è This key has “…” scope. dosya needs a key with full scope to subscribe to file events. Create a full-scope key and reconnect. Una chiave ad accesso completo richiede comunque il permesso di caricamento del membro nella destinazione. Si applicano vincolo allo spazio, scadenza e limiti espliciti della chiave. Le chiavi WebDAV/S3 vincolate a cartelle non sono adatte a questa integrazione REST.

Passaggi: configura e prova Upload File

1. Prova un evento di attivazione o un’azione che produce file con un file recente e non riservato. Controlla che il campione contenga un riferimento file effettivo o un URL di download diretto. Una pagina di anteprima, accesso o condivisione può restituire HTML invece del file richiesto.
2. Aggiungi dosya → Upload File e scegli l’account collegato. Configura i campi seguenti.

Campo dell’azione	Cosa scegliere
Spazio di lavoro (obbligatorio)	Lo spazio di lavoro previsto nell’elenco disponibile per l’account.
Cartella (facoltativo)	Una cartella in quello spazio; vuoto indica la radice.
File (obbligatorio)	Il riferimento file del passaggio precedente o un URL scaricabile da Zapier senza accesso interattivo.
Nome file (facoltativo)	Un nome esplicito con estensione, ad esempio zap-proof-20261014.pdf.

3. Usa un File name unico per la prima prova. Anche se il suggerimento dice che il nome in ingresso viene mantenuto, l’azione attuale usa upload se il campo è vuoto. Associa il nome originale o inseriscine uno per conservare estensione e tipo.
4. Esegui una volta il test dell’azione. Leggi File ID, Nome file, Size in bytes e Folder ID, poi controlla il file in dosya prima di ripetere il test.
5. Controlla filtri dell’evento di attivazione e azioni successive dell’intero Zap. Pubblicalo o attivalo solo dopo aver confermato la destinazione reale e il comportamento nelle esecuzioni ripetute. Un test riuscito scrive già un file reale; pubblicare non lo annulla.

Zapier risolve gli oggetti file in URL per l’azione. L’integrazione dosya scarica l’origine senza inviare la chiave API dosya all’host esterno, poi carica i byte ricevuti. Un URL pubblico deve restituire direttamente il file e restare valido quando lo Zap viene eseguito. Per riferimenti in scadenza, aggiorna i vecchi dati di prova. Evita link che richiedono cookie del browser e usa l’output file o download dell’app di origine. Una pagina di accesso o anteprima HTTP 200 può comunque essere salvata come file: verifica il contenuto, non solo lo stato.

Verifica il risultato e la mappatura successiva

Il risultato include id, file_id, name, size e folder_id; file_id duplica id. I campi selezionabili espongono File ID, File name, Size in bytes e Folder ID. Alla radice, Folder ID è null. L’azione non restituisce un campo version né un riferimento file disidratato per il download da un’altra app. Non associarli dal campione. Usa File ID in un’altra azione dosya per operare sul file salvato.

Apri File nello spazio di lavoro dosya scelto, trova la cartella e controlla nome e dimensione esatti. Scarica il campione per verificarne il contenuto. Upload File non crea un link di condivisione pubblico: i destinatari non ricevono nulla se un altro passaggio non invia o condivide esplicitamente il file.

Limiti di caricamento e nuovi tentativi

L’azione accetta al massimo 52.428.800 byte (50 MiB). Il messaggio indica 50 MB. La dimensione dichiarata viene controllata prima del buffering e viene verificata anche quella scaricata. Se manca Content-Length o la risposta è decompressa, si misurano i byte effettivi. Per file più grandi scegli Upload File From URL, che importa dal lato dosya senza passare da questa azione; si applicano comunque spazio del piano e regole di caricamento.

Le azioni Zapier hanno un limite di esecuzione di 30 secondi: anche un file sotto la soglia può superarlo se download e caricamento sono lenti. Dopo The app did not respond in-time. It may or may not have completed successfully., controlla dosya e la cronologia prima di ripetere. Una chiave di idempotenza basata sull’esecuzione permette a un nuovo tentativo dello stesso caricamento di riusare il risultato salvato. Una nuova esecuzione ha un’identità distinta. Non presumere che una ripetizione intenzionale usi quella originale. Se il nome esiste già nella cartella, dosya crea una nuova versione anziché un altro file. Usa nomi stabili per le versioni e nomi specifici dell’evento per file separati.

Una chiave revocata non autorizza esecuzioni future; rimuovere un account collegato non elimina i file già salvati. Gli aggiornamenti con lo stesso nome cambiano i contenuti correnti: prova in una cartella dedicata prima di associare nomi di produzione.

Recupera un test non riuscito

Problema	Soluzione
Could not fetch the file: the source at … answered with status …	Correggi URL o accesso all’origine oppure aggiorna il riferimento file. Una risposta 404/500 viene rifiutata prima del caricamento dosya.
Il file contiene una pagina web	Sostituisci l’URL di anteprima o accesso con un output file diretto e verifica usando un nuovo nome di prova. Una risposta 200 non prova il contenuto corretto.
This file is larger than 50 MB, which is the limit for the Upload File action.	Passa a Upload File From URL; verifica che il servizio di importazione possa accedere all’origine e che il piano abbia capacità.
Errore di autenticazione o messaggio sull’ambito completo	Riconnetti con una chiave API completa e valida ad accesso completo, senza vincolo a una cartella.
Workspace/Folder mancante o 403	Controlla email dell’account, vincolo e permessi del membro, poi ricarica le scelte. Non scegliere una cartella omonima in un altro spazio di lavoro.
Rifiuto per spazio o regola file	Risolvi il limite effettivo di account, spazio o chiave indicato nella risposta prima di ripetere.
Tempo scaduto	Controlla se file o versione sono già stati salvati; usa un’origine più piccola o veloce oppure l’azione URL asincrona.

Risultato previsto

L’azione testata restituisce un File ID reale i cui byte corrispondono all’origine nella cartella dosya scelta. Dopo la pubblicazione, controlla la prima esecuzione reale e il comportamento di nomi e versioni prima di affidarti ai caricamenti automatici.

Guide correlate

• Collegare Zapier
• Gestire le chiavi API