Chat Agent Gateway

Smetti di costruire integrazioni. Inizia a conversare.

Sois AI non espone endpoint. Espone un agente. Gli dici in linguaggio naturale ciò di cui hai bisogno. L'agente proprio di Sois legge il tuo messaggio, negozia i dettagli, agisce su tutto il tuo workspace e risponde quando ha finito.

Questo è il punto di accesso per i chiamanti che non hanno una propria AI: webhook, script, sistemi legacy e automazioni. Un solo endpoint, linguaggio naturale, e l'agente fa il ragionamento. Per i chiamanti senza agente, questo rende superflua una tradizionale API REST con molti endpoint. Non ci sono schemi da imparare, nessuna mappatura di campi da mantenere, nessun breaking change da inseguire. Solo una conversazione tra il tuo sistema e il nostro.

Hai già un agente AI? Collegalo direttamente tramite il server MCP. Questa è la via strategica: il tuo Claude, ChatGPT, Cursor o Gemini ragiona sugli strumenti Sois, così Sois non spende AI per te. Il Chat Agent Gateway è per i chiamanti che non portano un proprio agente.

Come funziona

You:    "Create a contact for Jane Doe, CEO of Acme Corp, [email protected]"
Agent:  Contact created. Added to workspace with company Acme Corp.

Un messaggio in entrata. Un risultato in uscita. L'agente di Sois negozia tutto ciò che sta in mezzo. Poiché l'agente fa il ragionamento, questa via consuma crediti AI Sois.

Tre modi per ricevere la risposta

Metodo Ideale per
Webhook Imposta una response_url sulla tua chiave. L'agente consegna il risultato firmato quando ha finito. Fire and forget.
Polling Controlla lo stato della conversazione in qualsiasi momento. Semplice, nessuna infrastruttura necessaria.
Entrambi Webhook come consegna principale, polling come fallback. Doppia sicurezza.

Avvio rapido

1. Ottieni le tue credenziali dalle Impostazioni nel tuo workspace Sois AI

2. Invia un messaggio

curl -X POST "https://your-workspace.sois.ai/api/agent" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Api-Key: sois_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Find all contacts from London"}'

3. Ricevi la risposta tramite il tuo webhook o interrogando la conversazione

Cosa può fare l'agente?

Tutto ciò che un utente può fare dentro Sois AI:

  • Cercare, creare, aggiornare ed eliminare contatti
  • Gestire attività e assegnazioni
  • Comporre e inviare email
  • Sfogliare e organizzare file e documenti
  • Interrogare reparti, team e membri
  • Lavorare con qualsiasi estensione installata
  • Combinare più azioni in una singola conversazione

L'agente non si limita a leggere i dati, ci agisce sopra. Chiedigli di "inviare via email a John il report del Q1" e troverà il contatto, individuerà il documento, comporrà l'email e la invierà. Nessuna orchestrazione richiesta.

Da sistema a sistema

Quando entrambe le parti sono intelligenti, negoziano. Due workspace Sois AI, o qualsiasi sistema agentico, possono scambiarsi dati tramite il Chat Agent Gateway senza intervento umano. Nessuna mappatura di campi. Nessun middleware. Nessun connettore. Solo due agenti che si mettono d'accordo.

Il tuo ERP parla con il tuo CRM. Si organizzano. Tu ricevi un riepilogo.

Governance: cosa può fare un'integrazione

Il gateway è soggetto alla stessa governance degli strumenti dell'assistente nell'app. Ogni azione che l'agente potrebbe compiere rientra in una di tre modalità, e una chiave API non supera mai i permessi dell'utente che la possiede.

  • Sempre. Le azioni sicure (letture, scritture di routine) vengono eseguite automaticamente.
  • Chiedi. Le azioni sensibili (inviare e-mail, eliminare record, qualsiasi cosa riguardi denaro o identità) richiedono l'approvazione di una persona. Poiché il gateway è un canale «fire-and-forget» senza nessuno davanti a uno schermo, un'azione «chiedi» non viene eseguita per impostazione predefinita.
  • Nega. Bloccata ovunque, gateway incluso.

Per consentire a un'integrazione di eseguire una specifica azione sensibile senza supervisione, preautorizza quell'azione sulla chiave (Impostazioni, Chiavi API, approvazione automatica). È una decisione una tantum e tracciata che prendi al momento dell'emissione della chiave, come concedere uno scope a un'app. Un'azione «chiedi» preautorizzata viene quindi eseguita automaticamente per quella chiave; tutto ciò che non è preautorizzato viene rifiutato, e l'agente ti comunica che serve un'autorizzazione invece di fingere di aver agito.

Ogni azione rifiutata ti viene segnalata, sia nella risposta dell'agente sia in modo leggibile dalla macchina nel payload del webhook sotto governance.tools_blocked (ogni voce riporta l'azione e il motivo: deny o ask_unauthorised). Così il tuo sistema vede esattamente cosa è stato fatto e cosa no.

Budget, non rate limit. Ogni chiave ha un budget in dollari: giornaliero, mensile o totale. Tu controlli quanto vale ogni integrazione. Nessuna quota di richieste arbitraria. Quando il budget è esaurito, l'agente te lo dice chiaramente.

Pronto? Leggi il riferimento completo dell'interfaccia Task per i formati di richiesta e webhook, oppure porta il tuo agente tramite il server MCP.