Collega Reaktive ai sistemi che usi già.
Un’API con chiave per utente di servizio, documentata in OpenAPI 3.1: il tuo gestionale avvia le automazioni e legge l’esito, con il costo in euro per ogni corsa.
Il flusso di un’integrazione
Il tuo sistema avvia, una persona approva, il risultato torna indietro.
Il tuo sistema
- Gestionale: nuovo ordine
- CRM: nuovo contatto
- Portale interno: un pulsante
Reaktive
- Automazione: i passi
- Agente: controlla e scrive
- Approvazione: una persona decide
Risultato
- Stato e costo in euro della corsa
- File Word, Excel, PDF
- Email inviata, foglio su Drive
Di nuovo nel tuo sistema
- Ordine aggiornato con il documento
- Contatto con il dossier
- Costo riconciliato nel controllo di gestione
Le stesse azioni dell’area di lavoro, dal tuo software.
Un elenco chiuso di rotte, documentate una per una. Ciò che non è nell’elenco non si può fare con una chiave.
Avvia un’automazione
Con i dati di ingresso del tuo sistema: parte la versione attiva, in coda come dal pulsante «Esegui».
- POST/api/workflows/{id}/runs
- GET/api/workflows/{id}/tasks/{taskId}
Segui le corse e scarica i file
Stato, durata, costo in euro e file prodotti di ogni corsa; annulla quelle in coda.
- GET/api/runs · /api/runs/{id}
- GET/api/runs/{id}/files/{fileId}
Parla con un agente
Crea la chat, invia il messaggio, leggi la risposta mentre arriva, allega file. Il turno costa come dall’interfaccia.
- POST/api/chats · /api/chats/{id}/messages
- POST/stream · /api/chats/{id}/files
Approvazioni
Leggi gli invii in attesa e decidi, se ne hai il diritto: anche da un tuo pannello interno.
- GET/api/approvals · /api/approvals/{id}
- POST/api/approvals/{id}
Agenti e utilizzo
Elenco e scheda degli agenti; la spesa per persona, agente e automazione, per riconciliare i costi.
- GET/api/agents · /api/agents/{id}
- GET/api/usage
Team e chiavi
Con lo scope di amministrazione: inviti al team e chiavi utente, che restano in attesa finché il Proprietario le approva.
- GET/api/team · POST /api/team
- GET/api/api-keys · POST /api/api-keys
Tre passi, e il tuo sistema lavora con Reaktive.
Un utente di servizio
Nel Team crei «Gestionale» come utente di servizio, con il suo tetto di spesa: le azioni sono attribuite e limitate come per una persona.
Una chiave approvata
L’utente di servizio crea la chiave rk_…; il Proprietario la approva. La chiave si vede una volta sola.
Chiamate con la chiave
Authorization: Bearer rk_… e una Idempotency-Key per non avviare due volte la stessa corsa se la rete cade.
Le prove dal browser («Prova la chiamata») sono nella pagina Sviluppatori dell’area di lavoro, dopo l’accesso: sono chiamate reali e consumano credito.
# 1. Il gestionale avvia l’automazione per il nuovo ordine curl -X POST \ https://reaktive.cloud/api/workflows/<id>/runs \ -H "Authorization: Bearer rk_…" \ -H "Idempotency-Key: ordine-10492" \ -H "Content-Type: application/json" \ -d '{"source":"active","input":{"ordine":"10492"}}' # 202 Accepted {"taskId":"5b7d9f1a-…","status":"queued"} # 2. Legge lo stato finché terminal è true curl -H "Authorization: Bearer rk_…" \ https://reaktive.cloud/api/workflows/<id>/tasks/5b7d9f1a-… {"task":{"status":"done"},"run":{"id":"4e6a8c0b-…","outcome":"completed","costEur":"0.004120000000"},"terminal":true} # 3. Scarica i file prodotti dalla corsa curl -H "Authorization: Bearer rk_…" \ https://reaktive.cloud/api/runs/4e6a8c0b-…
Ogni rotta documentata, con esempi, in italiano e inglese.
Generato dallo stesso documento OpenAPI 3.1 che la piattaforma usa nei test: se cambia l’API, cambia la pagina. Qui in sola lettura; le prove dopo l’accesso.
Le modifiche additive compaiono nella sezione «Novità»; una modifica incompatibile arriva solo con un nuovo prefisso, annunciato 90 giorni prima.
Regole chiare, uguali per tutti.
Due scope
Utente e amministrazione. Il ruolo della persona resta il limite: una chiave non fa più di chi l’ha creata, e non ha mai poteri di piattaforma.
Isolamento
Un oggetto di un’altra organizzazione risponde 404, come dall’interfaccia. Le chiavi sono conservate solo come impronta.
Limiti per chiave
600 richieste e 60 avvii al minuto; oltre, 429 con Retry-After.
Idempotenza
Stessa Idempotency-Key e stesso corpo entro 24 ore: stessa risposta, nessuna doppia corsa.
Errori a codice
{error, message, details}, con il messaggio nella lingua di Accept-Language.
Audit
Ogni scrittura con origine «api»; «ultimo uso» su ogni chiave.
Costi
Nessun canone per l’API: ogni corsa o turno costa come dall’interfaccia, dentro il tetto dell’utente di servizio.
Versione
La versione 1 è implicita in /api/…; modifiche incompatibili solo con un nuovo prefisso, annunciate 90 giorni prima.
Tre modi di collegare i sistemi aziendali.
Meccanismi veri, dati di esempio.
Gestionale (ERP)
A ogni nuovo ordine il gestionale avvia «Verifica fornitore e bozza di conferma»: l’agente controlla il fornitore sul web, prepara la bozza di email e chiede l’approvazione; il gestionale legge l’esito e il documento.
CRM
Per ogni nuovo contatto il CRM avvia la ricerca sull’azienda (sito, notizie, bandi vinti) e riceve il dossier, che l’automazione salva anche nella cartella Drive del commerciale.
Portale interno
Un pulsante «Rassegna straordinaria» nell’intranet avvia l’automazione con il tema scelto e mostra i file prodotti quando la corsa finisce; le approvazioni restano a chi ne ha il diritto.
Cosa entra nell’elenco appena è pronto e provato.
Webhook di uscita firmati
Reaktive chiama il tuo sistema a fine corsa.
Avvio con stream
Gli eventi della corsa mentre accade.
Agenti da API
Creazione e modifica con la chiave di amministrazione.
Chat senza stream
Una sola chiamata, risposta completa.
Vuoi vederla sul tuo caso?
Una demo tecnica di 30 minuti: avviamo un’automazione dal tuo sistema e leggiamo l’esito insieme.