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.

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.