Configurare l'IA (con la tua chiave)
Con The-Y scegli tu il provider IA e non paghi nessun ricarico sull'IA: inserisci la tua chiave API (Anthropic, OpenAI o Google) e paghi l'utilizzo direttamente al tuo provider, a prezzo di costo. Dopo hai a disposizione copilot, riassunti, traduzione con la tua IA, il bot di risposta IA con la tua knowledge base e l'assistenza IA per modelli WhatsApp, flussi e conferme di prenotazione. La traduzione funziona anche senza chiave, sul nostro server (vedi sotto).

Prima di iniziare: cosa ti serve
- Un account presso un provider IA a tua scelta: Anthropic (Claude), OpenAI (GPT) o Google (Gemini).
- Un po' di credito o un metodo di pagamento presso il provider: altrimenti il test di connessione fallisce con un messaggio sul saldo (non è un errore di The-Y).
- Per Google: un progetto Google Cloud con fatturazione attiva (piano a pagamento). Senza fatturazione nessun contenuto di WhatsApp, Messenger e Instagram va a Google (perché).
Passo per passo
- Apri le impostazioni IA. Nell'app, a sinistra Settings → AI (nel gruppo “Advanced”, alla voce dell'intelligenza artificiale).
- Scegli il provider. Nel menu a tendina seleziona il tuo provider (Anthropic / OpenAI / Google). Sotto compare un aiuto guidato con un link diretto alla creazione della chiave e (se serve) alla ricarica del credito presso il tuo provider.
- Crea la chiave. Tramite il link genera una chiave API presso il provider (vedi la tabella qui sotto) e copiala.
- Incolla la chiave. Incolla la chiave in The-Y (viene salvata in forma cifrata). Se vuoi, cambia il modello; precompilati: Claude Haiku 5.5 (Anthropic), GPT-6 Luna (OpenAI), Gemini 3.5 Flash-Lite (Google).
- Spunta “AI active” e clicca “Test connection”. Il test fa una vera mini chiamata. Verde = fatto. Se manca il credito, il provider lo segnala direttamente (ricarica e ripeti il test).
Dove trovo la chiave?
| Provider | Creare una chiave | Credito |
|---|---|---|
| Anthropic (Claude) | console.anthropic.com → Settings → API Keys → “Create Key” (sk-ant-…) | Settings → Billing (senza credito il test fallisce) |
| OpenAI (GPT) | platform.openai.com → API keys → “Create new secret key” (sk-…) | Billing → credito/metodo di pagamento |
| Google (Gemini) | Google AI Studio → “Get API key” | attiva la fatturazione nel progetto Google Cloud (piano a pagamento) e confermalo in The-Y: vedi sotto |
Cosa può fare poi l'IA
- Inbox: “💡 Suggestion” (una bozza di risposta basata sullo storico e sulla tua knowledge base) e “📝 Summary” di un ticket lungo.
- Traduzione: messaggi dei clienti e risposte nella rispettiva lingua; con il tuo provider qualsiasi lingua e di solito una qualità migliore (scegli “Your own AI key” in Settings → AI → Translation).
- Agenti IA personalizzati (nella pagina “Ask” e come selettore nell'inbox), smistamento automatico (categoria/sentiment/priorità) e il bot di risposta IA (knowledge base) nella WebChat.
Novità della versione 1.1.43: assistenza IA per modelli, flussi e prenotazioni
- Modelli WhatsApp: “✨ Create with AI” (da una sola frase, con un controllo dei motivi di rifiuto più comuni), “✨ Translate” (fino a 10 lingue), “✨ Explain and suggest a fix” per i rifiuti e “utility or marketing?” con il costo per messaggio: guida.
- Automazioni: “✨ From one sentence” crea un flusso (sempre disattivato) e il passaggio IA classifica i messaggi o estrae dati, con un ramo “AI unsure”: guida.
- Conferma di prenotazione → viaggio: l'IA legge una conferma (PDF, immagine o testo email; fino a 5 file da 10 MB ciascuno, PDF fino a 10 pagine) e precompila il viaggio; non viene salvato nulla finché non confermi: guida.
- Pulsanti sempre visibili: i nuovi pulsanti IA ci sono anche senza chiave. Un clic spiega allora “Add your AI key” (gli amministratori ricevono un link alle impostazioni, tutti gli altri “Please ask an admin”); lo stesso succede se l'IA è disattivata o se è stato raggiunto il tetto mensile o il limite di Free. Gli errori del tuo provider compaiono come messaggio chiaro. Dalla 1.1.66 l'avviso senza chiave mostra anche un esempio del risultato (ad es. un suggerimento di risposta), chiaramente contrassegnato, mai salvato né inviato. “Ask AI” è sempre nella barra laterale.
- Tracciabile: ogni suggerimento dell'IA viene registrato (chi l'ha richiesto, accettato o scartato) nel registro delle modifiche (Settings → Change log) e come CSV in Settings → Data backup (“AI suggestions”). Il contenuto di un suggerimento viene cancellato automaticamente dopo 90 giorni.
🔒 La privacy del tuo provider IA
In Settings → AI vedi per ogni provider cosa promette riguardo all'addestramento e cosa devi impostare tu. The-Y non addestra alcun modello e passa i contenuti solo al provider che hai configurato con la tua chiave.
| Provider | Cosa promette il provider | Cosa devi impostare tu |
|---|---|---|
| Anthropic | Per contratto non addestra i modelli con i dati inviati tramite API. Eccezioni: feedback che segnali esplicitamente o un consenso esplicito (opt-in). | Non dare il consenso all'uso dei dati e non inviare feedback che contengono dati dei clienti. |
| OpenAI | I dati inviati all'API non vengono usati per l'addestramento, a meno che tu non scelga esplicitamente di condividerli. Log antiabuso conservati fino a 30 giorni. | Non attivare la condivisione dei dati con OpenAI (impostazioni dell'organizzazione). |
| Google (Gemini) | Nel piano a pagamento (progetto con fatturazione attiva) Google non usa prompt e risposte per migliorare i propri prodotti; senza fatturazione può usarli a questo scopo. Per servizi offerti a utenti nello SEE, in Svizzera e nel Regno Unito, Google consente solo il piano a pagamento. | Attiva la fatturazione nel progetto Google Cloud e in The-Y spunta “My Google project has billing enabled (paid tier)”. |
Quali contenuti vanno al tuo provider per ogni funzione è indicato nell'informativa sulla privacy (“AI functions”). L'accordo sul trattamento dei dati con il tuo provider IA lo stipuli tu (DPA, Allegato 2). Dati dei provider aggiornati al 12 nov 2026 (fonti: Anthropic · OpenAI · Google); valgono le loro condizioni.
📊 Contatori e limiti di Free
I costi dell'IA li paghi direttamente al tuo provider. I limiti proteggono solo il nostro server; tutto si può usare anche nel piano Free.
| Funzione | Free | Cloud Pro e licenza a pagamento |
|---|---|---|
| Passaggi IA nei flussi | 1.000 al mese | illimitati |
| Conferme di prenotazione estratte | 300 al mese (i documenti che non sembrano un viaggio non contano) | illimitati |
| IA per i modelli (creare, tradurre, spiegare, verificare la categoria) | nessun limite mensile, solo un freno contro gli abusi: al massimo 30 chiamate ogni 10 minuti | uguale |
| Flusso da una frase | nessun limite mensile, solo un freno contro gli abusi: al massimo 10 ogni 10 minuti | uguale |
- Contatori: “AI steps this month” e “Documents read this month” in Settings → AI.
- Limite raggiunto: il pulsante resta visibile e spiega il limite; un passaggio IA in un flusso prende il ramo “AI unsure”: non si interrompe nulla.
- Self-hosted: gli stessi limiti con una chiave gratuita, nessun limite con una licenza a pagamento.
🌐 Traduzione: chi traduce i tuoi messaggi
In Settings → AI → Translation scegli come vengono tradotti i messaggi nell'inbox (“🌐 Translate” e “Translate reply”). Per questo non ti serve una chiave IA: l'impostazione predefinita funziona senza.
| Traduci con | Cosa significa |
|---|---|
| Sul nostro server (predefinito) | Il nostro servizio di traduzione (LibreTranslate) sul nostro server in Austria (data center a Vienna), senza accesso a internet. I testi vengono elaborati solo per la traduzione, non vengono salvati né passati a nessuno. Lingue: tedesco, inglese, turco; va bene per messaggi brevi (circa 0,5–1,5 s). |
| La tua chiave IA | Traduce il provider IA configurato in questa pagina: qualsiasi lingua (anche croato, serbo, bosniaco), di solito con qualità migliore. I testi vanno al tuo provider, con cui hai il contratto; i costi li paghi lì. |
| La tua chiave DeepL | Qualità molto buona. Inserisci la tua chiave API DeepL (salvata cifrata). I testi vanno a DeepL, con cui hai il contratto. |
- Regola per WhatsApp, Messenger e Instagram: questi messaggi li traduciamo solo sul nostro server o con la tua chiave, mai tramite un servizio gratuito esterno. Lì non usiamo una chiave DeepL gratuita (termina con
:fx), perché DeepL può usare i testi Free per l'addestramento: in quel caso traduce il nostro server. - Fonte indicata: sotto ogni traduzione vedi chi l'ha fatta, ad es. “translated on our server” o “with your AI key”.
- “Test translation” prova subito l'impostazione. La scheda mostra anche se il servizio di traduzione è attivo e quali lingue ha.
- Servizio non raggiungibile o lingua non installata? Allora vedi un messaggio chiaro. Niente passa di nascosto a un altro servizio.
Tenere sotto controllo i costi
Dato che paghi direttamente il provider, hai il pieno controllo dei costi dal suo pannello. In The-Y puoi anche impostare un limite di spesa mensile per l'IA (protegge il tuo budget). La piattaforma non spende mai soldi per la tua IA.
Valori indicativi per chiamata (prezzi di listino del 9 ott 2026): un suggerimento di risposta usa circa 670 token in entrata e 100 in uscita, ≈ 0,01 centesimi di dollaro con Claude Haiku 5.5, ≈ 0,05 centesimi di dollaro con Gemini 3.5 Flash-Lite; un passaggio IA in un flusso circa 0,0004–0,008 $, una conferma di prenotazione estratta circa 0,003–0,06 $, a seconda del modello. Il builder mostra accanto al passaggio IA il costo approssimativo ogni 1.000 esecuzioni e la vista dei costi in Reports elenca le funzioni IA.
Collegare l'IA (MCP): Claude, ChatGPT e simili lavorano nel CRM
Dalla 1.1.66 un programma di IA come Claude o ChatGPT può configurare il tuo account e darti una mano: mostrare cosa manca ancora; creare una casella email; attivare la web chat e darti il codice di integrazione; configurare il telefono (interni, gruppo di chiamata, orari telefonici, destinazioni dei numeri, linea); creare o importare contatti; creare trattative, attività e modelli di risposta; leggere l'inbox e salvare risposte come bozze. È diverso dalla chiave IA descritta sopra: qui è il tuo programma di IA a usare il CRM, e l'IA la paghi al suo provider. Di più: Server MCP: Claude o ChatGPT configura il tuo CRM (aggiornato al 14 nov 2026, fonte: The-Y CRM 1.1.67).
- Indirizzo:
https://crm.the-y.at/api/mcp(self-hosted: il tuo indirizzo +/api/mcp). Lo trovi in Settings → Integrations → “Connect AI (MCP)”. Può collegarsi chiunque abbia il permesso di gestire le integrazioni (ad es. gli amministratori). - Claude (claude.ai, Desktop): “Customize” → “Connectors” → “+ Add” → “Add custom connector” → nome “The-Y CRM” e l'indirizzo → “Continue” → mantieni l'accesso rilevato (“Sign in now”) → “Add” → “Connect”. Si apre il nostro accesso: accedi, scegli cosa può fare l'IA, “Allow”. Nella chat lo attivi tramite “+” → “Connectors”. Con Claude Team ed Enterprise sono prima gli amministratori della tua organizzazione Claude ad aggiungere il connettore (“Organization settings” → “Connectors”); poi ogni persona si collega da sé. Il piano Claude Free consente un connettore personalizzato.
- ChatGPT (sul web): “Plugins” → “+” → “Add custom MCP server” → nome e indirizzo in “Connection”, autenticazione “OAuth” → conferma l'avviso → “Create as a plugin” → il nostro accesso al momento del collegamento → “Allow”. Secondo OpenAI il supporto completo (comprese modifiche e invii) è disponibile per Business, Enterprise ed Edu; gli altri piani sono limitati. Nei workspace gli amministratori devono consentire i server MCP personalizzati (aggiornato al 12 nov 2026).
- Claude Code:
claude mcp add --transport http the-y-crm https://crm.the-y.at/api/mcp, poi/mcp→ accedi. - Altri programmi: accesso con un clic (OAuth) o una chiave nell'header
Authorization: Bearer <key>(Settings → Integrations → “Connect AI (MCP)” → “Create key”). - Cosa può fare l'IA? Lo scegli al momento dell'accesso: Read and write drafts (consigliato) o Set up. “May send messages to customers” è una casella a parte e non è mai preselezionata. Il collegamento vale 90 giorni.
- Sicuro: l'IA non riceve mai password: le password di caselle email e telefono le inserisci tu (l'IA ti manda il link). Senza il permesso di invio salva le risposte solo come nota interna. Non può eliminare né fare chiamate. Ogni azione finisce nel registro. In “Connected AI programs” vedi ogni collegamento e lo chiudi subito con “Disconnect”. Limiti: per collegamento ad es. al massimo 10 messaggi inviati al minuto e 60 all'ora, più i limiti API del tuo piano.
- Conferma, rinnovo e dimensione delle risposte (dalla 1.1.67): prima che Claude invii un messaggio, configuri una casella email (questo sovrascrive i dati del server di una casella esistente con lo stesso indirizzo) o accenda/spenga la web chat, te lo chiede. Se un programma di IA rinnova il suo accesso due volte nello stesso momento, entro 60 secondi riceve entrambe le volte lo stesso nuovo accesso; chiudiamo il collegamento solo se più tardi ritorna un refresh token già usato (in quel caso ricollega). Per indirizzo IP contano solo gli accessi falliti (al massimo 120 al minuto). L'IA riceve i modelli di risposta 50 per chiamata, ogni testo accorciato a 500 caratteri; leggendo una conversazione ogni messaggio ha al massimo 4.000 caratteri, 60.000 in totale: nelle conversazioni molto lunghe i messaggi più vecchi vengono tralasciati.
Risoluzione dei problemi
Il test di connessione segnala “no key”
Non è (ancora) salvata nessuna chiave, oppure “AI active” non è spuntato. Incolla la chiave, spunta la casella, ripeti il test.
Errore nel test anche se la chiave è corretta
Di solito manca il credito presso il provider (soprattutto Anthropic/OpenAI). Ricarica nel pannello del provider o aggiungi un metodo di pagamento e ripeti il test. Il testo dell'errore arriva direttamente dal provider.
I pulsanti IA non compaiono nell'inbox
Senza una chiave attiva i pulsanti IA sono nascosti di proposito (non si rompe nulla). Appena “AI active” è attivo e il test è verde, compaiono “💡 Suggestion” e “📝 Summary”. I nuovi pulsanti IA (modelli, flussi, viaggi), invece, sono sempre visibili e con un clic spiegano cosa manca.
Con Google i messaggi WhatsApp non vengono tradotti né riassunti
Per i contenuti di WhatsApp, Messenger e Instagram, con Google serve la casella “My Google project has billing enabled (paid tier)” in Settings → AI. Attiva la fatturazione nel tuo progetto Google Cloud e poi spunta la casella. Dopo aver cambiato chiave, conferma di nuovo.
Un pulsante IA dice che è stato raggiunto il limite di Free
Nel piano Free ci sono 1.000 passaggi IA nei flussi e 300 conferme di prenotazione estratte al mese (limiti). Si riparte il mese successivo; con Cloud Pro o una licenza a pagamento non c'è limite.
