Blog Guide Portfolio Biografia antoniotrento.net
Italiano English

Stack AI sovrano

Integrazioni e dati legacy

IMAP/PEC, Salesforce, Oracle, voce e fonti sporche: collegare mondi che non si parlano senza fare danni in produzione.

Integrazioni e dati legacy

Ogni PMI ha almeno un sistema che non parla con gli altri. La casella PEC da cui arrivano fatture e comunicazioni che qualcuno smista a mano. Il CRM che esporta solo se un amministratore preme un pulsante. Il gestionale su Oracle di cui nessuno ha più lo schema. Le telefonate, i vocali, le fonti dati esterne che si rompono senza preavviso. Collegare questi mondi è il lavoro meno spettacolare e più redditizio dell’integrazione: è lì che si recuperano ore ogni settimana. Ed è anche il posto dove si fanno i danni peggiori, perché si tocca la produzione di sistemi che non hai progettato tu.

Questa guida raccoglie gli articoli su come si fanno integrazioni che reggono: agenti e flussi che leggono da sistemi vecchi e scomodi senza romperli, senza consegnare password a un SaaS, e senza fingere che il dato sporco sia pulito.

Il principio: leggere molto, scrivere poco, dimostrare tutto

Il filo che lega questi articoli è un’asimmetria. Leggere da un sistema legacy è quasi sempre sicuro, se lo fai con un utente dedicato, permessi minimi e un ritmo che il sistema regge. Scrivere è dove si rompono le cose: un record sovrascritto, una PEC partita, un campo aggiornato su diecimila righe. Per questo le architetture che propongo partono sempre dalla sola lettura, scrivono in punti precisi e piccoli, e lasciano una traccia di ogni scrittura che permetta di dimostrare cosa è successo.

L’altro filo è il dato onesto. Una fonte esterna che non risponde, un valore vecchio di tre giorni, una colonna di cui non sei sicuro: il sistema lo deve dire, non nascondere. Un cruscotto che mostra un numero vecchio come se fosse di oggi fa più danni di uno che mostra “dato non disponibile”.

Le integrazioni (e l’articolo che le affronta)

Posta, PEC e identità

CRM, gestionali e database senza documentazione

Voce, desktop e ambienti chiusi

Regole dell’agente e fonti dati esterne

Il pezzo che decide tutto: l’utente di integrazione e la traccia

In quasi tutti questi articoli ritornano due scelte, e da queste due dipende se l’integrazione regge per anni o si rompe al primo audit.

La prima è l’utente di integrazione. Ogni sistema che colleghi deve vedere arrivare un’identità dedicata, con i permessi minimi per quel compito: sola lettura dove basta leggere, scrittura solo sui campi che servono, mai l’account dell’amministratore “perché tanto funziona”. Quando qualcosa va storto, l’utente dedicato ti dice subito da dove è partito; quando cambi fornitore o spegni l’integrazione, lo disattivi senza toccare le persone.

La seconda è la traccia. Ogni lettura importante e ogni scrittura lasciano un segno: cosa, quando, con quale versione del flusso, con quale esito. Non per burocrazia, ma perché le integrazioni falliscono in silenzio. Una PEC non scaricata, un export che ha saltato una pagina, una colonna rinominata dal fornitore del gestionale: senza traccia, te ne accorgi quando un cliente chiama.

Quando l’integrazione non è il problema

Una parte di questi articoli dice anche quando non integrare. Se una fonte non ha un canale lecito e stabile, si cambia fonte invece di costruire uno scraper. Se una pratica richiede identità e firma di una persona, l’agente prepara e la persona decide. Se il sistema legacy sta per essere sostituito, a volte conviene un export manuale settimanale invece di un’integrazione che vivrà sei mesi. Dirlo fa parte del lavoro, tanto quanto scrivere il connettore.

Quando l’integrazione richiede anche agenti che agiscono sui sistemi (scrivere sul CRM, aprire ticket, spedire), il discorso continua nella guida sugli agenti che eseguono. L’infrastruttura su cui far girare tutto questo — Docker, reverse proxy, segreti, backup — è nella guida allo stack sovrano.

Come usare questa guida

Parti dall’articolo che descrive il sistema che oggi ti fa perdere più tempo. Ognuno ha un’architettura di riferimento con quello che l’agente o il flusso non tocca, un percorso a step, i fallimenti tipici con le righe di log da cui riconoscerli, i costi in ordine di grandezza e una sezione onesta su quando non farlo.

Se vuoi capire come collegare i tuoi sistemi — la tua PEC, il tuo CRM, il tuo gestionale — senza consegnarli a un servizio esterno, trovi il mio percorso nella biografia e puoi scrivermi da contatti.

Qui sotto trovi tutti gli articoli di questa guida.

Articoli di questa guida

9 November 2026

SPID, PEC e l'agente: cosa non automatizzare (e come preparare i dati per un umano che firma davvero)

Il confine tra ciò che un agente AI può preparare e ciò che resta a una persona: SPID è l'identità di qualcuno, la PE...

27 October 2026

IMAP IDLE vs polling ogni 30 secondi: come non farti chiudere la PEC dal provider mentre l'agente “ascolta” la posta

IMAP IDLE vs polling per agenti che leggono la PEC: cosa fa IDLE e quando il server lo taglia, costi del polling, lim...

18 October 2026

Margin debt FRED vs FINRA: perché il tuo dashboard "rischio contenuto" è un bug di aggregazione (non un mercato safe)

Data engineering per indicatori di mercato: margin debt FINRA vs serie Z.1 su FRED, dati stale, YoY che esplodono, pe...

17 October 2026

Il backtest del tuo bot di trading mente: walk-forward, overfitting e perché uno Sharpe 2.4 in sample è quasi sempre spazzatura

Metodo onesto per validare un bot di trading: look-ahead e survivorship bias, walk-forward con embargo, costi e slipp...

16 October 2026

YAML come costituzione dell'agente: come definisci tono, divieti e canali (e perché un prompt da 12 pagine in chat non è governabile)

Policy-as-code per agenti AI: una costituzione in YAML versionata con identità, divieti, tool, canali e budget, valid...

15 October 2026

App desktop AI offline su Windows (Electron): come distribuire un modello locale senza che l'antivirus e il path da 260 caratteri ti distruggano il lancio

Distribuire un'app desktop AI offline su Windows con Electron: architettura a processi, modello scaricato o incluso, ...

14 October 2026

Assistente vocale in PMI: latenza, barge-in e GDPR (perché Vapi/Retell non sono "un centralino più furbo" se l'audio va in USA)

Assistente vocale per PMI fatto sul serio: budget di latenza STT→LLM→TTS, barge-in, dove transita l'audio, prenotazio...

9 October 2026

Reverse engineering su Oracle: come trovare la colonna IBAN senza schema (REPL, catalogo, e il rischio di fare damage in produzione)

Metodo cauto per esplorare un DB Oracle legacy senza documentazione: read replica o utente SELECT-only, ricerca nel d...

8 October 2026

Export notturno Salesforce → CSV con JWT in Docker: field mapping, paginazione e perché l'utente "Administrator" è una bomba

Ricetta di un exporter Salesforce → CSV di produzione: Connected App con JWT Bearer, utente di integrazione a permess...

1 October 2026

Whisper API vs Parakeet/NeMo offline su Windows: quando la trascrizione in cloud ti costa più della GPU (e ti porta via le riunioni)

Trascrizione audio offline su Windows: Whisper API vs faster-whisper e Parakeet/NeMo self-hosted. Costi reali per 20 ...

23 September 2026

Come costruire un agente IMAP che classifica PEC e fatture (senza Gmail API e senza dare la password a un SaaS)

Un inbox agent che smista PEC, fatture e comunicazioni legali senza mandare la tua posta a un SaaS americano. Archite...

Antonio Trento — System Architect & AI Integrator

Questo è il tuo problema?

Progetto e costruisco dati, backend, interfaccia e agenti AI end-to-end. Niente slide: sistemi che girano e restano tuoi.