Convertito
Esiste l'equivalente e i parametri sono stati portati. Resta da controllare le credenziali, che in nessun export viaggiano.
Integrazioni e apertura
170 nodi, un’API, e due direzioni di MCP.
Le integrazioni sono nodi come gli altri: stessa tavolozza, stesse espressioni, stesse credenziali cifrate. E ciò che l'interfaccia sa fare, lo sa fare anche l'API — perché è la stessa strada.
La tavolozza
Il catalogo è l'unica fonte: la tavolozza dell'editor, il pannello delle proprietà, la validazione e il prompt del costruttore assistito si generano da lì. Aggiungere un nodo non richiede di ritoccare l'interfaccia.
| Famiglia | Nodi | Che cosa copre |
|---|---|---|
| Integrazioni | 23 | Richiesta HTTP con credenziale applicata alla chiamata, e i connettori verso gli strumenti di tutti i giorni. |
| 20 | Fogli, Drive, Gmail e calendario con account collegato. | |
| Telegram | 19 | Messaggi, file, tastiere, gestione di chat e canali tramite bot. |
| Flusso | 17 | Condizioni, diramazioni, unione che attende tutti gli ingressi, cicli a lotti, attese anche in ore lavorative, sotto-workflow. |
| Microsoft 365 | 14 | Posta, calendario, file e cartelle con account collegato. |
| Dati | 13 | Impostare campi, variabili di processo, trasformare, dividere e aggregare gli elementi. |
| AI | 11 | Nodi LLM, agenti con strumenti, classificazione ed estrazione dai testi. |
| AI · Risorse | 11 | Modello, memoria, strumenti e schema di uscita da agganciare ai nodi AI. |
| File | 8 | Leggere, scrivere, estrarre testo, consegnare un file a chi ha avviato il flusso. |
| Pratiche | 8 | — |
| Trigger | 7 | Manuale, pianificato (cron con fuso orario), webhook, modulo pubblico, posta in arrivo, errore di un altro workflow, chiamata da un altro workflow. |
| Chat | 7 | Conversazioni interne e assistenti. |
| Database | 6 | Interrogazioni e scritture su connessioni configurate. |
| Persone | 3 | Attività umana, attesa di una risposta via email, modulo mandato per email. |
| Codice | 3 | JavaScript del progettista in sandbox, con limite di tempo. |
I nodi XML, CSV e le utilità di data e ora sono funzioni pure senza dipendenze esterne: si estendono con i test, non aggiungendo librerie.
L'API
Token per profilo, con tre ruoli — leggere, eseguire, tutto — perché consultare le attività è una cosa e chiuderle un'altra. Lo schema OpenAPI 3.1 è servito dall'applicazione.
| Percorso | A che serve |
|---|---|
/api/v1/attivita | Elenca le attività visibili al token; la singola si legge e si completa. |
/api/v1/items | Crea e legge le pratiche; /cerca per trovarle, /stato per farle avanzare. |
/api/v1/workflows/{id}/esegui | Avvia un workflow e riceve l'esecuzione che ne nasce. |
/api/v1/executions/{id} | Stato e registro dei passi di un'esecuzione. |
/api/v1/openapi | Lo schema OpenAPI 3.1, sempre allineato al codice. |
/api/v1/mcp | L'endpoint del server MCP. |
- Idempotenza. Una scrittura con
Idempotency-Keyripetuta restituisce la stessa risposta di prima invece di rifare il lavoro: un agente che ritenta non fa danni. - Errori stabili. Ogni errore ha un codice leggibile da un programma oltre al messaggio per una persona, con lo stato HTTP giusto.
- Limiti dichiarati. C'è un limite di richieste al minuto, e la risposta dice qual è e fra quanto riprovare.
- Niente rotture silenziose. Un endpoint superato lo dice nelle intestazioni standard
DeprecationeSunsete nel corpo della risposta — e continua a funzionare.
MCP, nelle due direzioni
Model Context Protocol è il modo standard con cui un agente monta uno strumento. xFlowy lo parla da entrambe le parti.
xFlowy come server
Gli strumenti esposti sono gli stessi dell'API, con la stessa identità e gli stessi permessi: elencare e leggere le attività, completarne una, cercare fra le pratiche, avviare un workflow. Sono descritti per un lettore che non conosce xFlowy — dicono quando servono, non solo che cosa fanno.
xFlowy come client
Gli assistenti possono usare i server MCP delle applicazioni che hai già: il gestionale, il CRM, l'archivio documentale. Gli strumenti che ne arrivano si aggiungono a quelli nativi, dentro le stesse regole di governance.
Porta i flussi che hai già
Importazione degli export di n8n, Node-RED, Make e Power Automate — e del formato di xFlowy stesso. Prima l'anteprima con il rapporto nodo per nodo, poi la bozza: mai un workflow attivo per importazione.
Da verificare
L'equivalente c'è, ma qualcosa va riletto: la nota attaccata al nodo dice esattamente che cosa.
Segnaposto
Nessun equivalente. Il nodo tiene il posto con i parametri originali dentro, i collegamenti restano, e l'attivazione è bloccata finché non lo sostituisci. Non fa finta di funzionare.
Gli operatori che xFlowy non ha non vengono inventati: la condizione diventa esplicitamente falsa, con la nota che spiega perché. Un'importazione che «funziona» nascondendo ciò che non ha capito è peggio di un'importazione parziale.
Dove gira
In cloud
Applicazione e database gestiti, file su storage privato, battito periodico del worker per timer, scadenze e riprese. Il sito che stai leggendo e l'applicazione vivono nello stesso progetto, separati per dominio: da qui non si raggiunge nessuna rotta dell'applicazione.
In casa tua
Immagine Docker autonoma con utente non privilegiato, avvio idempotente, worker che batte ogni minuto, file su disco. Una rotta pubblica di salute dice versione e stato dello storage, senza rivelare nulla.
Vuoi vederla su un processo tuo?
Il modo più rapido è raccontare un flusso reale — quello che oggi vive fra una casella di posta condivisa, un foglio di calcolo e tre solleciti. Rispondiamo dicendo che cosa xFlowy fa già, che cosa richiederebbe lavoro e che cosa non è il caso di fargli fare.