Collega il tuo sistema

Panoramica

Canali e integrazioni → Sistema proprio (/it/integrations/own-system) è per i negozi che mantengono gli account dei clienti nel proprio sistema (ad esempio un portale logistico) e non vogliono copiare quei dati in OrderInChat.

• Integra il widget di OrderInChat nelle tue pagine per utenti registrati.
• Il tuo server firma un token a breve termine per l'utente registrato e lo fornisce al widget.
• Quando quel cliente chiede informazioni sul proprio account (ad esempio "Dove si trova la mia spedizione?"), l'AI chiama i tuoi strumenti MCP in sola lettura con il token di quell'utente, sia nella chat testuale che nelle chiamate vocali avviate dal widget.
• OrderInChat controlla solo la tua firma. Non crea mai identità, non legge il tuo database e non memorizza ciò che i tuoi strumenti restituiscono.

Disponibile nei piani a pagamento (Starter, Pro, Ultra). I visitatori senza un token valido sono anonimi: l'AI risponde dalla tua base di conoscenza e chiede loro di accedere per domande relative all'account.

Fallo costruire all'AI del tuo sviluppatore

In Da dare all'AI del tuo sviluppatore, fai clic su Copia istruzioni e incolla il testo così com'è nell'assistente AI dei tuoi sviluppatori (Claude Code, Cursor, ChatGPT…). È in inglese e descrive esattamente cosa costruire — l'endpoint del token, il server MCP firmato e il codice del widget — con l'ID del tuo negozio e i tuoi indirizzi già inseriti. Chiede all'AI di concludere con l'elenco dei valori da inserire in questa pagina. I segreti non sono mai nel testo: crea i segreti di firma in questa pagina e impostali tu sul tuo server.

1. Token di accesso utente

Il tuo server firma un JWT per l'utente registrato:

Scegli come OrderInChat verifica:

• URL JWKS (ES256 o RS256) — l'indirizzo HTTPS delle tue chiavi pubbliche.
• Chiave pubblica (ES256 o RS256) — incolla la chiave pubblica PEM.
• Segreto condiviso (HS256) — almeno 32 caratteri, memorizzato in modo crittografato.

Incolla un token di esempio sotto Testa un token per verificarlo prima di andare in produzione. Un token non valido o scaduto non interrompe mai la chat: il visitatore è semplicemente trattato come anonimo.

2. Il tuo server MCP

Inserisci l'indirizzo del tuo server MCP (Streamable HTTP, tools/list e tools/call). Test e Live hanno ciascuno il proprio indirizzo e segreto di firma; Modalità attiva sceglie quale utilizzare l'AI.

Clicca su Crea per ottenere un segreto di firma. Viene mostrato una sola volta — conservalo sul tuo server. Revoca lo rimuove immediatamente (le chiamate in quella modalità si fermano fino a quando non ne crei uno nuovo).

Ogni richiesta che OrderInChat invia al tuo server porta:

• X-OIC-Timestamp — secondi Unix
• X-OIC-Signature — v1= + esadecimale HMAC-SHA256 di timestamp.body con il tuo segreto di firma
• X-OIC-User-Token — il token dell'utente, invariato (verificalo tu stesso e restituisci solo i dati di quell'utente)
• X-OIC-Mode — test o live

Rifiuta le richieste la cui firma non corrisponde o il cui timestamp è più vecchio di 5 minuti. OrderInChat non ha un indirizzo IP fisso, quindi utilizza la firma invece di una lista di autorizzazione IP.

3. Strumenti

Clicca su Scopri strumenti per leggere gli strumenti elencati dal tuo server, quindi attiva quelli che l'AI può utilizzare. Consenti solo strumenti in sola lettura. Gli strumenti che appaiono in seguito vengono avviati disattivati fino a quando non li attivi.

• Chat testuale: una chiamata a uno strumento può richiedere fino a 8 secondi.
• Chiamate vocali: fino a 3 secondi; l'assistente dice prima un breve "fammi controllare". Se il tuo server è lento, dice che non può controllare in questo momento.
• Ciò che i tuoi strumenti restituiscono è trattato solo come dati, mai come istruzioni, e non viene salvato nella cronologia della chat.

4. Integra il widget

<script>
  window.OrderInChatSettings = {
    userToken: "",
    getUserToken: async () => (await fetch("/your/oic-token")).text(),
  };
</script>
<script src="https://app.orderinchat.com/widget/oic-widget.js" data-tenant-id="YOUR-STORE-ID"></script>

getUserToken viene chiamato quando il token sta per scadere. Dopo che lo script è stato caricato, puoi anche utilizzare OrderInChat.setUserToken(token), OrderInChat.clearUserToken() (alla disconnessione) e OrderInChat.onTokenRefresh(fn).

Con un token valido e l'assistente vocale attivato, l'intestazione del widget mostra un pulsante telefono. La chiamata avviene nel widget ed è addebitata dai crediti AI come qualsiasi chiamata sul sito web (le chiamate agli strumenti sono incluse nella chiamata). L'audio delle chiamate web non viene registrato.

Personalizza apre le impostazioni del widget in una nuova scheda. A ogni caricamento di pagina il codice legge l'aspetto del widget da OrderInChat (tramite data-tenant-id), quindi le modifiche salvate lì valgono subito, senza incollare di nuovo il codice. Viene usato il profilo widget scelto per la vetrina (altrimenti quello attivo o il primo); non viene creato alcun profilo nuovo.

5. Testa la connessione

Sotto Strumenti, Testa la connessione esegue controlli fissi sul tuo indirizzo MCP di Test con il segreto di firma di test. Nessuna IA coinvolta e nulla viene salvato. Verifica che:

• l'indirizzo sia https pubblico (non localhost né un indirizzo di rete privata);
• un tools/list firmato correttamente funzioni;
• una richiesta con firma errata venga rifiutata;
• una firma corretta con un timestamp più vecchio di 5 minuti venga rifiutata;
• tools/call su uno strumento attivato senza token utente restituisca un errore e nessun dato;
• con un token di esempio incollato in Testa un token, tools/call funzioni — e con che velocità (oltre 2 secondi è troppo lento per le chiamate vocali, che rinunciano dopo 3 secondi).

Vengono chiamati solo gli strumenti rilevati e attivati, con argomenti vuoti; il token di esempio serve solo per quel test e non viene mai salvato. Ogni voce fallita indica come correggerla. Copia i risultati per il tuo sviluppatore copia un report in inglese da incollare al tuo sviluppatore o alla sua IA; ripeti il test finché nulla fallisce.

Cosa vede il tuo team

• Posta in arrivo → Web: il nome e l'email del cliente dal token, o Utente #ID quando non ne invii nessuno. Ogni risposta dell'AI mostra quale dei tuoi strumenti ha utilizzato e se ha funzionato — mai i dati.
• Posta in arrivo → Chiamate: le chiamate del widget appaiono sotto Sito web del negozio e in Live mentre sono in corso; la trascrizione mostra ogni passaggio dello strumento (solo nome e risultato).
• Clienti: viene creata o riutilizzata una scheda cliente per ogni ID utente (ID utente del negozio), quindi le chat e le chiamate della stessa persona sono collegate.