Collegare qualsiasi cosa

HTTP in entrata, HTTP in uscita, le parti scomode gestite

Ogni strumento di automazione pubblicizza un numero di integrazioni. Il numero è sempre grande ed è sempre la domanda sbagliata, perché il sistema di cui hai davvero bisogno è quello costruito internamente nel 2014 da qualcuno che se n'è andato. Ciò che conta è quanto bene lo strumento parla del protocollo che sta sotto a tutte.

Le connessioni pronte all'uso

Le applicazioni su cui girano la maggior parte delle aziende hanno passi già preparati: negozi e marketplace, contabilità e fatturazione, fogli di calcolo e database, calendari e posta, archiviazione e messaggistica, CRM e helpdesk, fornitori di pagamenti e corrieri. Autorizzi l'account una volta e i campi hanno i nomi nel linguaggio dell'applicazione, non nel linguaggio del suo JSON.

Dove un'applicazione ha una particolarità del mercato polacco — un sistema di fatturazione che deve essere pronto per il KSeF, un corriere le cui etichette sono uno standard nazionale — il passo preparato lo sa, perché la famiglia vende in quel mercato e ha dovuto impararlo.

E poi il caso generale

Tutto il resto è un passo HTTP, e un passo HTTP qui non è un premio di consolazione. È la stessa macchina su cui sono costruite le connessioni pronte, con la stessa gestione delle parti che sono noiose da scrivere da soli.

Le parti noiose

Gestite, così non le riscrivi tu

Autenticazione

Chiavi API, bearer token, basic auth, OAuth 2 con refresh, firma delle richieste HMAC, TLS reciproco. Una credenziale è memorizzata una volta, richiamata per nome e mai stampata in un log o in un record di esecuzione.

Paginazione

Cursori, numeri di pagina, offset, header Link, e l'API che segnala la fine restituendo un array vuoto. Dici quale forma è e il passo percorre l'intero insieme.

Limiti di frequenza

Un tetto per connessione, rispettato in ogni workflow che la usa. Quando un provider risponde 429 con un Retry-After, il passo aspetta quel tempo invece di martellare.

Retry e backoff

Errori transitori ritentati con un intervallo crescente e un tetto. Un passo è una funzione pura dei suoi input, quindi un retry riesegue il passo, non l'intera esecuzione.

Payload scomodi

JSON, codifica form, XML, testo semplice, upload multipart. Risposte analizzate in campi che puoi richiamare per nome, compresi quelli annidati quattro livelli più in basso.

Timeout

Un limite per passo, così una dipendenza lenta non può trattenere un worker mentre tutto ciò che viene dopo si mette in coda. Cosa succede quando il limite è raggiunto lo decidi tu, per ogni passo.

Se parla HTTP, la conversazione è già iniziata.

Webhook in entrata, presi sul serio

Ogni workflow può avere un URL che lo avvia. Quell'URL verifica le firme — HMAC nelle forme che i provider comuni usano, e un segreto condiviso dove quello è tutto ciò che il mittente riesce a fare. Una richiesta non firmata a un workflow che si aspetta una firma viene rifiutata e registrata, non elaborata in silenzio.

La deduplicazione si basa sull'identificatore del payload stesso, così un mittente che ritenta perché non ha visto in tempo il tuo 200 ottiene un'esecuzione anziché tre. I payload malformati vengono conservati, con il motivo del rifiuto, perché la causa più comune di un gap misterioso in un'automazione è un mittente che ha cambiato idea su un campo.

I sistemi che parlano solo CSV

Esistono. Un file appare su un server SFTP alle quattro di notte, o arriva come allegato, o viene depositato in una cartella condivisa. Un workflow può tenerlo d'occhio, leggerlo e trattare ogni riga come un record — compreso il file con byte-order mark, separatori punto e virgola e una riga di intestazione in polacco, perché è così che appare davvero l'export.

Anche il verso opposto funziona: un workflow può assemblare un file e metterlo dove l'altro sistema si aspetta di trovarlo, che spesso è l'unica interfaccia che ha un software del 2006.

Feed fornitori notturnoSFTP → HTTP

⚡Trigger04:02Nuovo file sull'SFTP del fornitore: stock-2026-09-09.csv.
2AnalisiPunto e virgola, byte-order mark, intestazioni in polacco. 4 118 righe.
3NormalizzazioneCodici valuta verificati con i dati di riferimento; due rifiutati come non validi.
4Push2.9 sHTTP PATCH in batch da 200, limite di frequenza rispettato.
!EccezioniDue righe archiviate per una persona, con il numero di riga e il motivo. Le altre 4 116 sono passate.

Passi che hanno chiamato un modello: 0Costo di questa esecuzione: zero

Dove vivono le credenziali

Crittografate, referenziate per nome, limitate al workspace che le possiede e mai mostrate in un log di esecuzione, in un messaggio di errore o in una conversazione con l'assistenza. Un record di esecuzione mostra che un passaggio si è autenticato come supplier-sftp; non mostra cosa sia supplier-sftp.

Un'agenzia che gestisce un workflow per trenta clienti assegna a ogni cliente il suo set di credenziali, e il workflow fa riferimento al set anziché al segreto. Ruotare una chiave è una sola modifica in un solo posto — ed è questa la ragione principale per cui le agenzie arrivano qui.

Il limite che vale la pena conoscere: un sistema senza alcuna interfaccia — niente API, niente webhook, niente file, niente se non una persona che clicca in un browser — non può essere automatizzato né da questo né da nessun altro strumento onesto. Qui non c'è un browser headless che finge di essere un utente, perché si rompe la prima volta che l'altra parte sposta un pulsante, e si rompe in silenzio.