--- seo_title: Integrazione Zapier per conversione file e dati web | EnConvert meta_desc: Aggiungi su invito l'integrazione EnConvert per Zapier per convertire file, trasformare pagine web in markdown e PDF, indicizzare siti in blocchi pronti per il RAG e monitorare le pagine. keywords: conversione file zapier, zapier pdf, zapier docx in pdf, web scraping zapier, zapier url in markdown, zapier screenshot, integrazione zapier enconvert, zapier converti file, zapier crawl rag, zapier perceive url, zapier connessione api key --- # Integrazione Zapier per conversione file e dati web L'integrazione EnConvert per [Zapier](https://zapier.com) raccoglie dodici tra azioni, ricerche e trigger dietro un'unica connessione: converti un file in PDF o markdown, trasforma una pagina web in dati pronti per gli agenti, esegui il crawl di un intero sito in blocchi pronti per il RAG, cerca sul web e tieni d'occhio i cambiamenti di una pagina. Ogni rendering di pagina porta con sé un punteggio `render_quality` da 0.0 a 1.0, così una pagina bloccata o vuota arriva segnalata anziché data per buona.
Accesso: solo su invito · Step: 8 azioni, 3 ricerche, 1 trigger · Credenziale: una API key privata EnConvert (sk_) · Codice sorgente: enconvert/zapier-enconvert
--- ## Cosa fa l'integrazione ### Crea (azioni) | Azione | Cosa fa | |--------|--------------| | **Convert File to PDF** | Trasforma un documento, foglio di calcolo, presentazione, immagine, file HTML o di testo in un PDF. Il campo facoltativo PDF Options accetta JSON, per esempio formato e orientamento della pagina. | | **Convert File to Markdown** | Trasforma file Word, PowerPoint, Excel, PDF, EPUB, RTF, HTML e di testo in markdown. | | **Convert Image** | Converte tra JPEG, PNG, WebP, HEIC e SVG, e rasterizza una pagina PDF in JPEG. | | **Compress Image** | Riduce un PNG, JPEG o WebP verso una dimensione obiettivo in KB. Il formato non cambia mai. | | **Perceive URL** | Renderizza una singola pagina in markdown, HTML pulito, HTML grezzo, uno screenshot, uno screenshot a pagina intera, un PDF, link, immagini o dati strutturati. Costruita su [Perceive](/it/docs/endpoints/perceive.md). | | **Distill Structured Data** | Estrae i campi che descrivi da una o più pagine e restituisce un risultato per URL. Costruita su [Distill](/it/docs/endpoints/distill.md). | | **Start Ingest Job** | Esegue il crawl di un intero sito, o di un elenco di URL, in JSONL a blocchi pronto per il RAG. Costruita su [Ingest](/it/docs/endpoints/ingest.md). | | **Create Watcher** | Monitora una pagina alla ricerca di cambiamenti a cadenza fissa, al massimo ogni ora. Costruita su [Watch](/it/docs/coming-soon/watch.md). | ### Ricerche | Ricerca | Cosa fa | |--------|--------------| | **Search the Web** | Ricerca web, notizie, immagini, scholar, brevetti o mappe, un risultato per riga. Costruita su [Lookup](/it/docs/coming-soon/lookup.md). | | **Discover URLs** | Elenca gli indirizzi di un sito tramite sitemap, crawl o entrambi, senza renderizzare. Costruita su [Discover](/it/docs/coming-soon/discover.md). | | **Get Ingest Job** | Legge un job di ingest tramite ID, incluso l'URL del suo output JSONL finito. Il campo **Ingest Job** è un menu a tendina popolato dal tuo account, quindi scegli un job invece di digitarne l'ID, oppure mappi un ID da uno step precedente. | ### Trigger | Trigger | Cosa fa | |---------|--------------| | **New Watcher Snapshot** | Interroga un watcher e scatta quando registra un nuovo controllo, con il conteggio delle modifiche. Il campo **Watcher** è un menu a tendina popolato dal tuo account, quindi scegli un watcher invece di digitarne l'ID, oppure mappi un ID da uno step precedente. | Tutto gira sulla stessa API REST documentata in questo sito, quindi la quota del tuo piano, i rate limit e le funzionalità valgono esattamente come ovunque altrove. --- ## Aggiungere EnConvert al tuo account Zapier EnConvert è disponibile su invito. Non c'è niente da installare e nessun comando da eseguire. 1. Apri il link di invito: [Aggiungi EnConvert a Zapier](https://zapier.com/developer/public-invite/245566/b32c70d9f97609c6974a298e49b4498e/). 2. Accedi a Zapier se non hai già effettuato l'accesso. 3. Accetta l'invito nella pagina che si apre. Da quel momento EnConvert compare quando lo cerchi nell'editor di Zap, con l'etichetta **Invite Only**. L'invito ti permette di usare l'integrazione nei tuoi Zap; nient'altro del tuo account cambia. --- ## Collegare il tuo account EnConvert 1. Genera una API key **privata** nella [dashboard](/it/dashboard/api-keys). Le chiavi private iniziano con `sk_`. 2. Aggiungi uno step EnConvert a uno Zap e scegli **Connect a new account**. 3. Incolla la chiave. La connessione chiama `GET /v1/whoami`, che accetta solo chiavi private. Una chiave pubblica `pk_` viene rifiutata in quel momento, non più tardi durante l'esecuzione di uno Zap. La chiave viaggia nell'header `X-API-Key` su ogni richiesta, e la connessione viene etichettata con il tuo piano.
Le chiavi pubbliche non funzioneranno. Le chiavi che iniziano con pk_ sono pensate per i widget nel browser e vengono rifiutate da ogni step di questa integrazione. Approfondisci in Chiavi private.
--- ## File Le quattro azioni di conversione accettano un input **File**, così mappi un file direttamente da uno step precedente come Google Drive, Dropbox o un allegato email. L'azione lo carica, poi restituisce il risultato come un vero file Zapier, pronto da inserire nello step successivo, insieme al nome del file, alla dimensione e a un URL di download. Non serve uno step in più per recuperare i byte: Zapier risolve il file quando l'azione successiva lo utilizza. L'output file si chiama **Converted File** su Convert File to PDF, Convert File to Markdown e Convert Image, e **Compressed File** su Compress Image. Il link si chiama **Download URL** su tutte e quattro e resta valido per 15 minuti. Il formato di ingresso viene letto dal nome del file. Zapier passa il file all'azione come URL opaco, quindi l'azione recupera quel nome dall'header `Content-Disposition` del file server, poi dall'URL, poi dal content type, e si ferma con un messaggio quando nessuno dei tre dà un'estensione utilizzabile. Mappa il file da uno step che conserva il nome originale, come un allegato email o un file di cloud storage. **Output Filename** dà il nome al risultato, non all'input, quindi non può fornire un'estensione mancante. --- ## Il punteggio render_quality Perceive URL restituisce `render_quality`, un numero da 0.0 a 1.0. Un punteggio basso indica che la pagina non è stata renderizzata in modo pulito, per esempio una pagina di challenge, un cookie wall o il guscio vuoto di una single-page app. Il contenuto torna comunque, segnalato, così una lettura errata non entra mai di nascosto in un foglio di calcolo o in uno step AI a valle. Aggiungi un filtro Zapier su questo valore per scartare o riprovare le letture di bassa qualità. --- ## Zap di esempio ### Un nuovo file in Drive verso un riassunto ```text Google Drive (New File) -> EnConvert (Convert File to Markdown) -> AI step (Summarize) ``` Il markdown torna direttamente sullo step, così lo step AI lo legge senza alcun collante intermedio. ### Un allegato email verso un PDF ```text Email (New Attachment) -> EnConvert (Convert File to PDF) -> Dropbox (Upload File) ``` Il PDF convertito è un vero file Zapier, così lo step Dropbox lo carica direttamente. ### Una ricerca salvata verso un foglio di calcolo ```text Schedule -> EnConvert (Search the Web) -> Google Sheets (Create Row) ``` La ricerca restituisce una riga per risultato, così ogni risultato diventa una riga del foglio di calcolo. ### Una pagina monitorata verso un avviso Slack ```text EnConvert (New Watcher Snapshot) -> Filter (only if Has Changes) -> Slack (Send Message) ``` Il trigger scatta a ogni controllo programmato; il filtro lascia passare solo i controlli che sono realmente cambiati. --- ## Stato Oggi l'integrazione è disponibile su invito. Una volta accettato l'invito si comporta come qualsiasi altra app Zapier: stesso editor, stessa schermata di connessione, stessi step. La pubblicazione nella App Directory di Zapier è un passaggio a parte ed è ancora in corso. Il link di invito funziona in entrambi i casi, e gli Zap che costruisci ora continueranno a funzionare dopo la pubblicazione. --- ## Risoluzione dei problemi **EnConvert non compare quando lo cerco nell'editor di Zap.** Accetta prima l'invito, mentre sei connesso allo stesso account Zapier in cui costruisci gli Zap. Le app su invito restano nascoste agli account che non hanno accettato. **La connessione non si salva.** La chiave è sbagliata oppure è una chiave pubblica `pk_`. Genera una chiave privata nella [dashboard](/it/dashboard/api-keys). La connessione chiama `GET /v1/whoami`, che accetta solo chiavi private. **Uno step segnala che l'operazione non è inclusa nel mio piano.** Perceive, Distill, Discover, Search, Ingest e Watch attingono al numero di operazioni mensili incluse nel tuo piano. Controlla il tuo utilizzo e il tuo piano nella [pagina dei prezzi](/it/pricing.md). **Una conversione restituisce un link, non un file.** Restituisce entrambi. Mappa l'output file nello step successivo per allegare il file vero, oppure usa il campo **Download URL** se vuoi solo il link. **Una conversione fallisce su un file che altrove si apre senza problemi.** L'azione legge il formato di ingresso dal nome del file, e il nome che Zapier passa non è sempre quello originale. Mappa il file da uno step che conserva il proprio nome, come un allegato email o un file di cloud storage, oppure rinominalo nello step che lo produce. **Output Filename** dà il nome soltanto al risultato. --- ## Sorgente e link - **Link di invito**: [Aggiungi EnConvert a Zapier](https://zapier.com/developer/public-invite/245566/b32c70d9f97609c6974a298e49b4498e/) - **API key**: [Dashboard](/it/dashboard/api-keys) - **Tipi di chiave**: [Chiavi private](/it/docs/authentication.md#private-keys) - **API sottostante**: [Introduzione](/it/docs/introduction.md) - **Assistenza Zapier**: [help.zapier.com](https://help.zapier.com) - **Codice sorgente**: [enconvert/zapier-enconvert](https://github.com/enconvert/zapier-enconvert) --- ## Domande frequenti ### Come ottengo l'integrazione EnConvert in Zapier? Apri il [link di invito](https://zapier.com/developer/public-invite/245566/b32c70d9f97609c6974a298e49b4498e/), accedi a Zapier e accetta nella pagina che si apre. EnConvert compare poi nella ricerca dell'editor di Zap con l'etichetta **Invite Only**. Non installi niente e non esegui nessun comando. ### Come converto un file DOCX in PDF in Zapier? Aggiungi l'azione **Convert File to PDF** e mappa il tuo file nel campo **File** da uno step precedente come Google Drive o un allegato email. L'azione restituisce un vero file Zapier più un URL di download, così lo step successivo (Gmail, Dropbox, Drive) riceve direttamente il PDF. I file Word portano con sé la propria impostazione di pagina, quindi dimensione della pagina e margini non si applicano a loro. ### Come trasformo una pagina web in markdown in Zapier? Usa l'azione **Perceive URL** con Markdown selezionato in Outputs. Il markdown torna direttamente sullo step. È circa sei volte più piccolo dell'HTML grezzo della stessa pagina, il che riduce il costo in token di qualsiasi step AI a valle. ### Come carico un intero sito web in un vector store con Zapier? Usa **Start Ingest Job** in modalità Sitemap, poi leggilo con **Get Ingest Job** finché non termina e prendi l'URL dell'output JSONL. Ogni riga è un blocco che porta con sé il proprio URL di origine, il titolo e il percorso delle intestazioni, ovvero la forma che un vector store si aspetta. ### Quale credenziale serve all'integrazione? Una API key privata che inizia con `sk_`, creata in Dashboard, API keys, e incollata quando colleghi un account. Le chiavi pubbliche che iniziano con `pk_` vengono rifiutate. La connessione chiama `GET /v1/whoami` per confermare la chiave prima che tu ci costruisca qualcosa sopra. ### Perché lo step mostra l'etichetta Invite Only? Quell'etichetta indica un'app raggiungibile su invito anziché tramite la App Directory pubblica. Non limita ciò che gli step fanno né quanti Zap ci costruisci sopra. La pubblicazione è in corso, e non cambierà gli Zap che hai già costruito.