Riferimento

Una pagina di consultazione rapida per botts.ai: limiti dei piani, cosa costa crediti, tipi di file supportati, canali, livelli di residenza dei dati, incorporamento del widget, strumenti HTTP e segreti, campi dei moduli e un elenco esplicito di ciò che la piattaforma (ancora) non fa.

Tabelle di consultazione rapida che raccolgono in un unico posto numeri e regole concreti. Per il «perché» e il «come», segui i link alle guide complete.

Piani e limiti

I nuovi spazi di lavoro scelgono un piano subito dopo la registrazione. Personal parte con una prova gratuita di un mese (150 crediti iniziali) e Business con una prova gratuita di 14 giorni (1'500 crediti iniziali), senza carta di credito e con una sola prova gratuita per persona. Per avere subito tutti i crediti mensili, scegli Preferisco pagare subito, senza prova. I prezzi hanno lo stesso importo in CHF, EUR e USD; con il pagamento annuale risparmi circa il 17%. Enterprise è su misura e si concorda con il team di vendita. I vecchi piani Free e Lite non sono più offerti ai nuovi clienti; le organizzazioni Lite esistenti mantengono il loro piano.

Il piano Personal include solo lo spazio di lavoro della chat IA interna. I deployment su canali esterni (widget per il sito web, telefono) richiedono Business o superiore.

Vedi Team e fatturazione per i cambi di piano, i blocchi di crediti e la ricarica automatica.

Cosa costa crediti

Tutto quello che fa un agente viene conteggiato in crediti. Prima si consumano i crediti del piano, poi quelli acquistati (a partire da quelli che scadono prima).

Per stimare la fattura mensile, il calcolatore dei costi ti fa scegliere chat, voce o entrambi, una configurazione (con o senza base di conoscenza e strumenti) e un modello, ti chiede i tuoi volumi e mostra i crediti stimati al mese e un piano consigliato. È una stima approssimativa. La pagina dei modelli elenca le tariffe di ogni modello di testo sotto Mostra dettagli: Input, Output e Cached, in crediti per ~1'000 parole.

Tipi di file supportati e limiti di caricamento

• Massimo 100 MB per file. I file più grandi vengono rifiutati prima del caricamento.
• Lo spazio totale per i caricamenti è limitato dal valore Spazio di upload (MB) del tuo piano.

Gli allegati in chat accettano una gamma di formati più ampia ma file più piccoli, perché sono documenti occasionali e non conoscenze permanenti dell'agente:

Tutti e tre contano per lo stesso limite Spazio di upload (MB). Le immagini vengono salvate ridimensionate (lato lungo 1568 px) e senza i metadati della fotocamera. Vedi Allegare documenti e Allegare immagini.

• Un PDF scansionato o composto solo da immagini, senza testo estraibile, viene accettato ma compare come Skipped: non aggiunge contenuti ricercabili. Usa un PDF basato su testo oppure incolla il testo come Markdown. Vedi Base di conoscenza.

Canali

Tutti i dettagli in Deployment.

Livelli di residenza dei dati

Si imposta per ogni organizzazione in Organizzazione → Generale → Posizione del server (Proprietario/Admin). Il livello filtra i modelli IA che puoi selezionare. La Svizzera conta come europea, ma non fa parte dell'UE; un'azienda del Regno Unito non conta come azienda europea.

L'infrastruttura della piattaforma, l'archiviazione delle basi di conoscenza e la cronologia delle chat si trovano in Svizzera (Infomaniak), indipendentemente dal livello. La telefonia vocale usa un fornitore statunitense (Twilio). La ricerca web, quando un agente l'ha attivata, invia le query a Staan.ai in Francia. La prenotazione di appuntamenti trasmette nome, e-mail e orario scelto di chi prenota al servizio di Cal.com ospitato negli Stati Uniti (un'istanza Cal.com self-hosted mantiene i dati in Svizzera). La voce, al telefono e nel widget per il sito web, funziona con GPT Live 1, una risorsa Microsoft Azure OpenAI in Sweden Central distribuita come deployment globale: l'audio può essere elaborato in regioni Azure di tutto il mondo, mentre le trascrizioni vengono salvate in Svizzera. La voce nel widget è disattivata, a meno che il widget non la attivi. GPT Live 1 conta come server europeo gestito da un'azienda statunitense, quindi la voce (deployment telefonici, voce nel widget e test vocale nella dashboard) è disponibile solo con Server europeo, qualsiasi azienda e Globale. I livelli più restrittivi non la consentono; un deployment telefonico creato in precedenza continua a funzionare, ma viene segnalato. botts.ai non addestra modelli con i tuoi dati. Vedi le domande frequenti e l'articolo sulla residenza dei dati.

Incorporamento del widget per il sito web

Ogni deployment sito web fornisce un unico tag script, da incollare subito prima del tag di chiusura </body>:

<script async src="https://api.botts.ai/widget/chat-widget.js?key=YOUR_API_KEY"></script>

• Il parametro key è la chiave API del deployment, con il prefisso bts_. La tua chiave reale è indicata nella sezione Installazione dell'editor del widget: copia il codice da lì.
• La chiave è pubblica per scelta e funziona solo per il widget di questo deployment. Nella dashboard non si può sostituire; un nuovo deployment sito web riceve una chiave nuova.
• Funziona su WordPress, Shopify, Squarespace, Wix o in semplice HTML. Vedi Deployment.
• Da chiuso, il widget è una Bolla (predefinita), una Bolla con messaggio o una Scheda con pulsanti (Chatta, e Parla quando la voce IA è attiva; i visitatori possono ridurla). Si imposta in Launcher nell'editor del widget.
• Voce IA (facoltativa, si imposta in Voce IA): una sessione vocale termina dopo 10 minuti o dopo 90 secondi di silenzio; il messaggio di benvenuto pronunciato può avere al massimo 300 caratteri. Vedi Deployment.

Connessioni e segreti

Le connessioni permettono a un agente di chiamare sistemi esterni. Si configurano in Integrazioni (Admin/Proprietario).

• Fai riferimento a un segreto salvato in qualsiasi punto dell'URL, delle intestazioni o dell'autenticazione con $secret:key_name.
• GET/DELETE inviano i parametri come query string; POST/PUT/PATCH inviano un body JSON. Le variabili di percorso come {order_id} vengono codificate in percent-encoding e sostituite.
• Il body di una risposta 2xx viene passato al modello; se è molto grande viene accorciato, mantenendone l'inizio e la fine. I body 4xx/5xx restano nascosti (il modello riceve lo stato e un'indicazione di non inventare dati). Per risposte del tipo «non trovato», restituisci 200 con un body JSON.
• Gli indirizzi privati, localhost, link-local e di metadati cloud sono bloccati, anche negli URL dei server MCP.
• Gli strumenti MCP vengono registrati come servername__toolname. Se un server cambia il suo elenco di strumenti, la modifica va riapprovata prima di avere effetto.

Attività pianificate

Esecuzioni ricorrenti e personali di un agente, in Pianificate nella barra laterale. Vedi Attività pianificate.

Campi dei moduli

Modelli integrati per la raccolta di lead (da attivare per ogni agente in Modulo / Cattura Lead):

I campi personalizzati usano gli stessi tipi di parametro degli strumenti: string, number, integer, boolean. Per ogni conversazione viene registrato un solo invio; nome, email e telefono compilano anche i campi vuoti del profilo del contatto. Gli invii si possono consultare ed esportare in CSV nella scheda Moduli di ogni agente. Vedi Agenti.

Cosa botts.ai non fa (ancora)

Questo elenco serve a evitare che tu (o un agente addestrato su questa documentazione) dia per scontata una funzione che non esiste:

• Nessun connettore di terze parti per le basi di conoscenza. Le fonti di una base di conoscenza sono solo la scansione di siti web e il caricamento di file. Non c'è sincronizzazione con Google Drive, Notion, Dropbox, SharePoint o S3. (Un server MCP può permettere a un agente di interrogare un sistema del genere in tempo reale, che è una cosa diversa dall'indicizzarlo.)
• Nessuna API pubblica o per i clienti. Non esistono chiavi API personali né un'API REST generica per inviare messaggi in modo programmatico. Le uniche chiavi sono quelle del widget, una per deployment (bts_), che autenticano il widget di chat incorporato sui canali pubblici.
• Nessuna configurazione autonoma delle prenotazioni, per ora. La prenotazione di appuntamenti in un calendario Cal.com esiste, ma è botts.ai ad aggiungere lo strumento su richiesta. Il modulo Richiesta di prenotazione raccoglie la data richiesta, ma non verifica la disponibilità e non prenota nulla. Per un altro sistema di pianificazione, usa una connessione per chiamarne l'API.
• Nessuna impostazione che fissi la lingua delle risposte. Gli agenti rispondono nella lingua in cui l'utente scrive o parla. La Lingua di un deployment telefonico imposta solo il saluto e i primi turni, e la Lingua di un widget solo le etichette del widget stesso. Per fissare una lingua, indicala nel prompt di sistema.
• Ancora nessun OAuth per le connessioni. Le connessioni si autenticano con chiavi, intestazioni, basic auth o un endpoint di login. Le voci del catalogo che prevedono solo l'accesso con OAuth sono elencate ma disattivate.
• Nessun failover per la voce interattiva. I deployment telefonici non hanno un modello di backup.
• I canali WhatsApp, Telegram ed Email non sono ancora disponibili (In arrivo).
• Niente SAML né single sign-on per tutta l'organizzazione, e niente log di audit, per il momento. (I singoli account possono accedere con Continua con Google o con una passkey.)
• Nessuna ottimizzazione automatica del prompt. I Test valutano le risposte di un agente rispetto alle tue aspettative; non riscrivono il prompt, non scelgono un modello e non modificano l'agente in alcun modo.

Ti serve una di queste funzioni? Spesso puoi ottenerla già oggi con una connessione, altrimenti vale la pena parlarne con il supporto.

Cose che questo elenco diceva prima

Rimosse perché ora esistono, nel caso te le ricordi come limiti:

Ultimo aggiornamento: 4 ottobre 2026