Integrazioni di sistema: collegare gli strumenti che già usi

Un'integrazione di sistema è il collegamento che sposta i dati tra gli strumenti che la tua azienda già usa, come il negozio, il CRM, il software di contabilità, l'email e i fogli di calcolo, così che nessuno debba copiarli a mano. È pensata per le aziende che hanno superato la fase del ricopiare e inoltrare ma non vogliono sostituire i sistemi che funzionano.

Punti chiave

• L'integrazione riguarda dati che si spostano in modo affidabile tra i sistemi che mantieni, non l'acquisto di un nuovo sistema.
• Le API permettono di chiedere dati ai sistemi; i webhook permettono ai sistemi di annunciare i cambiamenti. La maggior parte delle integrazioni usa entrambi.
• Uno strumento di workflow come n8n copre molti casi. Il codice su misura serve per alti volumi, logiche complesse o dove non esiste un connettore.
• I dati restano tuoi: i tuoi account, i tuoi database, le tue esportazioni. Pretendilo in ogni contratto.
• Hosting nell'UE e ruoli GDPR chiari sono decisioni da prendere prima del primo collegamento, non dopo.
• Ogni integrazione prima o poi fallisce. Monitoraggio, nuovi tentativi e una persona che viene avvisata fanno parte della costruzione.

I tre meccanismi

API. Un'interfaccia di programmazione è il modo in cui un sistema permette a un altro di leggere o scrivere i suoi dati in forma strutturata. Il tuo negozio ha un'API che può elencare gli ordini di oggi; il tuo sistema contabile ne ha una che può creare una fattura. Un'integrazione chiama la prima, trasforma il risultato e chiama la seconda.

Webhook. Invece di chiedere a un sistema ogni pochi minuti se è cambiato qualcosa, un webhook permette al sistema di inviare un messaggio nel momento in cui succede qualcosa: un nuovo ordine, una fattura pagata, l'invio di un modulo. I webhook rendono le integrazioni immediate e riducono il traffico inutile.

Strumenti di workflow. Prodotti come n8n offrono una tela visuale in cui i passaggi vengono collegati: ricevi un webhook, cerca un cliente, dirama in base a un campo, scrivi in un foglio, invia un messaggio. Includono connettori per i sistemi più comuni e possono essere ospitati in proprio (https://docs.n8n.io/hosting/), il che conta per il luogo in cui i tuoi dati vengono trattati.

Quando basta uno strumento di workflow

Uno strumento di workflow è adatto quando:

• I sistemi coinvolti hanno connettori pronti o API pulite.
• Il volume è moderato: centinaia o poche migliaia di eventi al giorno, non milioni.
• La logica è una sequenza di passaggi con poche diramazioni, non un algoritmo lungo.
• Le persone che in seguito modificheranno il flusso non sono sviluppatori ma devono vedere cosa fa.

Per molte piccole e medie imprese, questo copre gran parte del primo anno di automazione: smistamento dei lead, notifiche sugli ordini, passaggio delle fatture, composizione dei report, pubblicazione sui social media.

Quando serve codice su misura

Il codice su misura si guadagna il suo posto quando:

• Un sistema non ha API né connettore e i dati vanno estratti da file, portali o allegati email.
• Le trasformazioni sono complesse: abbinare prodotti tra cataloghi, riconciliare pagamenti, applicare regole di prezzo.
• I requisiti di volume o di tempo di risposta superano ciò che un motore di workflow gestisce comodamente.
• L'integrazione fa parte di un prodotto che vendi, dove test, versionamento e deployment devono essere rigorosi.

I due approcci si combinano bene. Uno schema comune è uno strumento di workflow per l'orchestrazione e piccoli servizi su misura per i passaggi difficili. Decidere dove passa il confine è un compito di progettazione, e va rivisto man mano che il volume cresce.

Proprietà dei dati

Le integrazioni toccano i tuoi dati più preziosi: clienti, ordini, fatture. Tre regole li mantengono tuoi.

1. Account e credenziali appartengono all'azienda, non all'agenzia. Chiavi API, hosting, domini e l'istanza di workflow vengono creati a tuo nome, e le persone che li hanno costruiti hanno un accesso da amministratore che puoi revocare.
2. I dati risiedono in sistemi da cui puoi esportare. Se un'integrazione mantiene un proprio database, hai un modo documentato per tirare fuori tutto.
3. La logica è documentata in linguaggio semplice. Per ogni flusso: cosa lo avvia, cosa legge, cosa scrive e chi viene avvisato quando fallisce. Bastano un diagramma e una pagina di testo.

Hosting nell'UE e ruoli GDPR

La maggior parte dei dati delle integrazioni sono dati personali ai sensi del GDPR, Regolamento (UE) 2016/679 (https://eur-lex.europa.eu/eli/reg/2016/679/oj). Ne derivano due decisioni.

Dove vengono trattati i dati. Far girare il motore di workflow e gli eventuali database su server nell'UE evita le questioni legate ai trasferimenti verso paesi terzi (Capo V del Regolamento). Molti servizi collegati sono a loro volta gestiti fuori dall'UE; per questi, verifica i termini del fornitore e il meccanismo di trasferimento su cui si basano.

Chi è titolare e chi è responsabile. La tua azienda decide perché e come vengono trattati i dati dei clienti; è il titolare del trattamento (articolo 4, punto 7). Un'agenzia che costruisce e gestisce un'integrazione per tuo conto, e qualsiasi servizio che tratta i dati per te, agisce come responsabile del trattamento (articolo 4, punto 8) e richiede un accordo scritto di trattamento dei dati ai sensi dell'articolo 28. È documentazione standard. Il punto è averla in essere prima che i dati reali comincino a fluire, e includere l'integrazione nel tuo registro delle attività di trattamento (articolo 30).

Anche i passaggi AI in un flusso, ad esempio un modello che legge un'email e la classifica, sono trattamento. Anche il fornitore di quel modello è un responsabile, e i suoi termini dovrebbero dichiarare cosa fa con i dati che gli vengono inviati.

Monitoraggio e gestione dei guasti

Un'integrazione che funziona in silenzio per mesi un giorno fallirà: un'API cambia, un token scade, un campo viene rinominato, un servizio è fuori uso. Progetta per questo.

• Nuovi tentativi per i guasti temporanei, con un limite, così una breve interruzione non perde eventi.
• Una coda di attesa in cui gli eventi falliti aspettano di essere rielaborati invece di sparire.
• Avvisi a una persona, per email o chat, quando un flusso fallisce più di un numero stabilito di volte o non è partito quando previsto.
• Log che mostrano, per ogni evento, cosa è entrato e cosa è uscito, conservati abbastanza a lungo da poter indagare.
• Un controllo mensile di token, versioni dei connettori e volumi.

La gestione dei guasti è anche il punto in cui entrano le persone. Un flusso che non riesce a decidere, ad esempio una fattura che non corrisponde a nessun fornitore, dovrebbe creare un'attività per una persona anziché tirare a indovinare.

Mantenere il controllo nel team

Le aziende che ottengono valore duraturo dalle integrazioni sono quelle le cui persone possono vederle e modificarle. Passi pratici: dai al responsabile operativo l'accesso alla tela del workflow, tieni un elenco dei flussi attivi con i rispettivi responsabili, concorda chi approva una modifica e fai girare ogni nuovo flusso in parallelo al processo manuale finché non si è dimostrato affidabile.

Come lo facciamo in Hot Skulls Labs

Iniziamo ogni integrazione con l'analisi: ripercorriamo il processo con le persone che lo gestiscono e annotiamo ogni sistema, ogni passaggio e ogni decisione. Da lì disegniamo i flussi e segniamo quali passaggi sono semplice spostamento di dati e quali richiedono giudizio.

Il nostro schema predefinito è lo stesso che usiamo in tutto il nostro lavoro di automazione: un trigger (un webhook o una pianificazione), un passaggio AI dove serve giudizio (classificazione, estrazione, bozze), un passaggio di approvazione umana per tutto ciò che agisce verso l'esterno o modifica registrazioni finanziarie, ed esecuzione nei sistemi di destinazione. Le integrazioni semplici saltano il passaggio AI; quelle delicate non saltano mai l'approvazione.

Pilotiamo prima un solo flusso e lo facciamo girare accanto al processo manuale. Costruiamo con n8n dove connettori e volumi lo consentono, e scriviamo servizi su misura in codice dove non lo consentono; spesso i due girano insieme. Ospitiamo su server nell'UE, creiamo tutti gli account a nome del cliente, firmiamo un accordo di trattamento dei dati prima che i dati reali comincino a fluire e consegniamo una documentazione che nomina ogni flusso, il suo trigger, il suo responsabile e il suo avviso.

L'esercizio fa parte del lavoro. Monitoriamo i flussi, rivediamo le eccezioni con il cliente e adattiamo man mano che sistemi e azienda cambiano. Questi schemi sono stati costruiti e usati prima in Strady, il nostro prodotto, prima di offrirli ai clienti.