Integrazione Zapier per conversione file e dati web#
L'integrazione EnConvert per Zapier 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.
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. |
| Distill Structured Data | Estrae i campi che descrivi da una o più pagine e restituisce un risultato per URL. Costruita su Distill. |
| 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. |
| Create Watcher | Monitora una pagina alla ricerca di cambiamenti a cadenza fissa, al massimo ogni ora. Costruita su Watch. |
Ricerche#
| Ricerca | Cosa fa |
|---|---|
| Search the Web | Ricerca web, notizie, immagini, scholar, brevetti o mappe, un risultato per riga. Costruita su Lookup. |
| Discover URLs | Elenca gli indirizzi di un sito tramite sitemap, crawl o entrambi, senza renderizzare. Costruita su Discover. |
| 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.
- Apri il link di invito: Aggiungi EnConvert a Zapier.
- Accedi a Zapier se non hai già effettuato l'accesso.
- 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#
- Genera una API key privata nella dashboard. Le chiavi private iniziano con
sk_. - Aggiungi uno step EnConvert a uno Zap e scegli Connect a new account.
- 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.
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#
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#
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#
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#
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. 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.
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
- API key: Dashboard
- Tipi di chiave: Chiavi private
- API sottostante: Introduzione
- Assistenza Zapier: help.zapier.com
- Codice sorgente: enconvert/zapier-enconvert
Domande frequenti#
Come ottengo l'integrazione EnConvert in Zapier?#
Apri il link di invito, 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.