Se succede questo, fai quello
flow.conditional fa proseguire un flusso su strade diverse a seconda del risultato di un passaggio precedente — se l’importo supera una soglia, se il documento è di un certo tipo — così l’automazione decide da sola invece di eseguire sempre la stessa sequenza fissa.
Non tutti i flussi vanno dritti
Una catena semplice esegue sempre gli stessi passaggi nello stesso ordine. Ma spesso serve altro: se un documento è una fattura, leggilo in un modo; se è una ricevuta, leggilo in un altro. flow.conditional aggiunge un bivio al flusso: in base al risultato di un passaggio, la sequenza prosegue su un ramo o su un altro, senza che tu debba gestire i due casi con due automazioni separate.
Come si definisce la condizione
Indichi quale valore controllare — un campo estratto, un punteggio, un tipo di documento riconosciuto — e la regola che decide il ramo: uguale a, maggiore di, contiene un certo testo. Ogni ramo prosegue con i propri passaggi successivi, indipendenti da quelli dell’altro ramo, fino alla fine del flusso, senza mai eseguire i passaggi del ramo scartato o sprecare risorse su quel percorso.
Una capacità ancora giovane
flow.conditional è in beta: già utilizzabile oggi per condizioni semplici e chiare, ma la stiamo ancora affinando in base ai primi flussi reali costruiti dai clienti. Per logiche con molti bivi annidati, consigliamo di iniziare con condizioni semplici e scriverci se il caso cresce in complessità nel tempo, man mano che il flusso matura e si arricchisce di nuovi casi.
Prezzo calcolato sul ramo effettivamente eseguito
Il costo somma solo i passaggi del ramo che viene davvero percorso, più la maggiorazione del 20% per il coordinamento — i passaggi del ramo non scelto non vengono eseguiti e non vengono addebitati. Se il ramo eseguito costa $0.008, il totale con la maggiorazione arriva a $0.0096, in dollari, prezzo noto prima ancora che il bivio venga deciso e il flusso imbocchi una direzione o l’altra.
Casi d'uso
Documento smistato in base al tipo
Studio Legale Esposito & Associati fa leggere ogni documento in arrivo e, se il sistema riconosce un contratto, lo instrada verso un passaggio di estrazione clausole; se riconosce una fattura, verso l’estrazione di importo e scadenza.
Ordine gestito in base all’importo
Rossi & Figli S.r.l. fa proseguire automaticamente gli ordini sopra i 1.000 € verso una verifica aggiuntiva, mentre quelli sotto soglia procedono direttamente alla conferma standard.
Recensione instradata in base al tono
Un negozio online analizza il tono di ogni recensione ricevuta: se risulta negativa, il flusso avvisa subito il servizio clienti; se positiva, la mette in coda per una possibile pubblicazione.
Domande frequenti
Quanti rami posso definire in una singola condizione?
Puoi definire più rami a seconda dei valori possibili del campo controllato, non solo un semplice sì o no. Per logiche molto articolate con molti livelli, scrivici prima di costruire il flusso.
Posso usarla già in produzione o conviene aspettare?
È in beta: funziona bene per condizioni chiare e semplici, ma la stiamo ancora perfezionando. Per flussi critici con logiche complesse, consigliamo di validare bene i primi risultati prima di affidargli decisioni importanti.
Pago anche i passaggi del ramo non scelto?
No. Solo i passaggi effettivamente eseguiti nel ramo percorso entrano nel calcolo del prezzo, più la maggiorazione del 20% di coordinamento.
Posso combinare una condizione con l’esecuzione in parallelo?
Sì: dopo un bivio, ciascun ramo può a sua volta lanciare più passaggi in parallelo, se sono indipendenti tra loro.
Cosa succede se nessuna condizione definita risulta vera?
Definisci sempre un ramo predefinito per i casi non previsti, così il flusso non resta bloccato senza sapere come proseguire quando nessuna regola specifica si applica.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/flow/conditional \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/flow/conditional", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/flow/conditional",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/flow/conditional", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/flow/conditional", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"input": "…"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "flow.conditional",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |