Modello AI e BYOK #

Questa pagina spiega quale modello AI alimenta il tuo bot, perché è supportato un solo provider per il BYOK (Bring Your Own Key) e come configurare la tua chiave se il tuo piano lo include.

Quale modello AI alimenta il bot #

La piattaforma utilizza Anthropic Claude come modello principale per il tuo bot. Claude è stato scelto perché, dopo test approfonditi su ogni principale modello di frontiera (termine del settore per i modelli di IA più avanzati disponibili) sul mercato, è l’unico in grado di gestire in modo affidabile il volume di messaggi in produzione.

Non devi scegliere un modello. La piattaforma seleziona automaticamente quello giusto per ogni attività e ne ottimizza l’utilizzo dietro le quinte (inclusa l’avanzata memorizzazione nella cache dei prompt, che riduce drasticamente i costi per conversazione).

Perché solo Anthropic per il BYOK #

I clienti ci chiedono spesso se aggiungeremo il supporto per OpenAI, Google Gemini, OpenRouter o modelli open source per BYOK. La risposta onesta è: nessuno di questi, se utilizzato in modo grezzo e non ottimizzato, regge il confronto con i volumi di produzione.

Per un piccolo progetto, un tasso di successo di 9 su 10 da parte di un’IA è accettabile. Una volta che gestisci conversazioni reali con i clienti su larga scala, un tasso di fallimento del 10% significa prenotazioni interrotte, risposte errate, follow-up mancati e vendite perse. Questo è l’ordine di grandezza che riscontriamo anche con i modelli di frontiera di alto livello di altri fornitori (circa il 6-10% su casi limite avversari, ovvero domande di test complesse e deliberatamente difficili) — e questo senza considerare i modelli più economici.

I problemi rientrano in tre categorie:

• I casi limite si rompono in modo imprevedibile. Un modello può funzionare perfettamente per centinaia di chat, per poi improvvisamente allucinare una chiamata a uno strumento, affermare di aver fatto qualcosa che non ha fatto o ignorare le istruzioni a metà conversazione.
• Il contesto lungo è gestito male. Una singola risposta del bot utilizza la cronologia della chat, le FAQ, la logica di follow-up, le chiamate agli strumenti e il ragionamento. La maggior parte dei modelli va in crisi con questo volume e produce output peggiori.
• “Più economico” raramente lo è. Il prezzo di listino inferiore per token è compensato da più tentativi, più token di output e una conversione peggiore. Il costo reale per conversazione riuscita finisce per essere più alto.

Supportare 100 modelli diversi è più una strategia di marketing che una reale capacità. Preferiamo offrirti un provider che funzioni in modo affidabile piuttosto che cinque che si rompono in modi diversi.

Il nostro modello: Max #

Abbiamo creato il nostro modello interno, Max: un modello proprietario unito a uno stack di ottimizzazione multi-pass, perfezionato su dati di conversazione reali provenienti dalla piattaforma. L’obiettivo era ottenere un modello significativamente più conveniente di Claude, pur rimanendo affidabile sui pattern di conversazione effettivamente gestiti dalla piattaforma, ed è proprio questo che offre Max: una frazione del prezzo Pro (0,25 crediti per azione), ottimizzato per rimanere accurato laddove un modello economico standard potrebbe sbagliare.

Max non richiede alcuna configurazione: nessuna scelta del modello, nessun account provider, nessuna chiave. Viene eseguito interamente sulla nostra infrastruttura ed è il modello più accurato che offriamo: nei nostri benchmark è il più efficace nel rimanere fedele a ciò che la tua azienda afferma realmente. Per un’analisi completa di come Max si confronta con Claude e con i modelli economici di terze parti di cui i clienti chiedono spesso — incluso ciò che quei modelli hanno effettivamente sbagliato nei nostri test — consulta Perché Max è la scelta migliore.

Chi vede il livello Max #

Se il selettore Qualità AI nella scheda Istruzioni AI del tuo Agente mostra solo Pro ed Economy, significa semplicemente che Max non è attivo per l’account a cui sei connesso. Due cose lo attivano:

• Gli account con un piano lifetime idoneo ottengono Max automaticamente.
• Qualsiasi altro account deve avere Max abilitato esplicitamente.

Su un account fornito da un’agenzia, il tuo provider potrebbe aver scelto il modello per te. Se il selettore della Qualità AI mostra una sola scheda e non c’è nulla a cui passare, si tratta di un’impostazione deliberata del tuo account, non di un errore: chiedi a chi fornisce il tuo account di modificarla. Se viene ancora mostrata una scheda con una nota che indica che non è più disponibile, il tuo Agente sta utilizzando un modello che il tuo provider ha rimosso nel frattempo: continuerà a rispondere, ma utilizzando uno dei modelli consentiti, quindi scegline uno per far sì che il selettore corrisponda a ciò che è effettivamente in esecuzione.

Collegare la propria chiave Anthropic (BYOK) non ha nulla a che fare con la visibilità di Max. Le due cose funzionano fianco a fianco: consulta la nota sull’eccezione in Configurazione di BYOK per sapere come viene fatturato un Agente Max quando hai una chiave collegata. Rimuovere la tua chiave API non farà apparire Max.

Il livello Mini #

Se puoi vedere Max, puoi vedere anche Mini, a 0,15 crediti per azione. Mini è la stessa IA di Max a un prezzo inferiore, con due compromessi:

• Maggiore probabilità di errori. Mini è il modello più leggero dei due. Max è il modello più preciso che offriamo — ottimizzato al massimo per attenersi a ciò che la tua azienda afferma realmente — mentre con Mini c’è una maggiore probabilità che un piccolo errore o un’allucinazione si insinui in una risposta.
• Memoria più leggera. Nelle conversazioni lunghe, Mini ricorda meno messaggi precedenti e recupera meno frammenti dalla knowledge base per ogni risposta.

Max rimane la scelta consigliata per tutto ciò in cui un dettaglio errato può costare una vendita: prenotazioni, domande sui prezzi, assistenza con posta in gioco reale. Mini è adatto a conversazioni ad alto volume e sensibili al prezzo, dove la velocità e il costo contano più dell’ultimo punto percentuale di precisione.

Mini si trova nello stesso selettore di qualità IA di Max, su ogni account che dispone di Max. Come Max, Mini viene eseguito interamente sulla nostra infrastruttura e non utilizza mai una chiave BYOK, pertanto una chiave Anthropic collegata non viene utilizzata (e non viene fatturata) mentre un Agente è su Mini.

Cosa copre la tariffa Mini di 0.15. Il prezzo Mini si applica a tutto ciò che accade all’interno di una conversazione dal vivo: risposte dell’IA, chiamate a strumenti dell’IA (come prenotare un appuntamento o avvisare un operatore umano), valutazioni della chat (decidere se una conversazione debba essere ignorata o chiusa), gestione delle interruzioni (quando un contatto invia un nuovo messaggio mentre il bot sta ancora componendo la sua risposta), riepiloghi della chat e auto-tagging tramite IA. Le funzionalità IA una tantum al di fuori della conversazione — ottimizzazione delle campagne, generazione della knowledge base e tagging effettuato tramite API — hanno una tariffa fissa unica di 0.25 crediti sia su Max che su Mini, quindi potresti vedere occasionali voci da 0.25 nella tua cronologia crediti anche quando ogni Agente è impostato su Mini. Si tratta di quelle funzionalità, non del modello Max che risponde alle tue chat.

Configurazione del BYOK #

BYOK è incluso nei piani Agency e Agency Unlimited, e nei livelli a vita AppSumo a partire dal Plan 2. Non fa parte del piano Business. Se il tuo piano lo include, puoi collegare la tua chiave API Anthropic (un codice privato dal tuo account Anthropic che consente alla piattaforma di addebitare l’utilizzo dell’IA direttamente a te invece di utilizzare i crediti della piattaforma).

Funzionano solo le chiavi ufficiali Anthropic. Una chiave valida proviene dal tuo account personale su console.anthropic.com e inizia sempre con sk-ant-. Le chiavi provenienti da rivenditori, proxy o siti di “API Claude scontate” (che spesso iniziano con un prefisso diverso) non sono supportate e non verranno salvate. Fai attenzione alle offerte di token Claude a basso costo, ben al di sotto dei prezzi ufficiali di Anthropic: nessuno può rivendere legittimamente l’accesso a Claude a un prezzo inferiore a quello applicato da Anthropic e tali offerte sono quasi sempre truffe basate su chiavi rubate o create per sottrarre i tuoi dati di pagamento.

Sei su un telefono? La barra laterale sinistra potrebbe essere nascosta. Tocca prima l’icona del menu (☰), quindi tocca Impostazioni.

Non vedi le chiavi API BYOK nel gruppo Avanzate? La sezione appare solo nei piani che includono BYOK. Se il tuo account è gestito da un provider, appare solo quando quest’ultimo ha attivato Porta la tua chiave API (Bring Your Own API Key) per il tuo account.

1. Nella barra laterale sinistra principale, fai clic su Settings (l’icona a forma di ingranaggio vicino alla parte inferiore).
2. Nella pagina Settings, nel menu a sinistra, scorri fino al gruppo Advanced.
3. Fai clic su BYOK API Keys.

4. Fai clic su Add key (Aggiungi chiave) sulla scheda Anthropic. Apparirà un campo Secret key (Chiave segreta) (segnaposto sk-ant-…).

5. Incolla la tua chiave API Anthropic nel campo, quindi fai clic su Save key (Salva chiave).

Una volta abilitato, il tuo bot utilizzerà la tua chiave per le chiamate AI e pagherai Anthropic direttamente per tale utilizzo invece di consumare i crediti della piattaforma per le risposte AI. L’infrastruttura del canale (server WhatsApp Web, numeri di telefono, ecc.) continua a utilizzare i crediti come di consueto.

Un’eccezione: il livello Max. Se la Qualità AI di un Agente è impostata sul livello Max, quell’Agente viene eseguito interamente sulla nostra infrastruttura interna e viene fatturato a 0,25 crediti per azione anche quando hai BYOK collegato: Max non utilizza mai la tua chiave Anthropic. (Lo stesso vale per Mini, dove disponibile: 0,15 crediti per azione, mai la tua chiave.) Per fatturare le risposte sul tuo account Anthropic, mantieni l’Agente sul livello Pro (standard). Il selettore Qualità AI si trova nella scheda Istruzioni AI di ogni Agente. La pagina delle impostazioni Chiavi API BYOK mostra un avviso ogni volta che la tua chiave è archiviata ma uno o più dei tuoi Agenti sono ancora in esecuzione sul livello Max, elencando quali: così puoi capire a colpo d’occhio perché vengono ancora utilizzati i crediti.

Una nota sui costi: Portare la propria chiave non è più l’opzione economica. Con una chiave collegata, il tuo Agente viene eseguito su Claude e paghi direttamente le tariffe a consumo di Anthropic (Anthropic ti fattura in base a quanto utilizzi effettivamente, in modo simile a una bolletta). Calcolato sugli account che utilizzano la propria chiave, una risposta dell’IA costa circa 3 volte quella della stessa risposta su Max e più di 5 volte quella su Mini, una volta conteggiato il lavoro in background che una risposta attiva (ricerca nella knowledge base, controllo spam, estrazione di nome ed email, valutazioni della chat, tagging), tutto ciò che è incluso nella tariffa fissa Max e Mini ma fatturato per token sulla tua chiave. Le nostre ottimizzazioni di prompt-caching si applicano anche alla tua chiave, quindi non si tratta di una lacuna nella cache; Max e Mini sono semplicemente modelli molto più economici che ottengono anche punteggi più alti nel nostro benchmark sulle conversazioni di vendita. Usa BYOK quando desideri specificamente che l’utilizzo dell’IA venga addebitato sul tuo account Anthropic, non per risparmiare denaro.

Perché la prima risposta in una conversazione costa molto più delle successive. La memorizzazione nella cache funziona archiviando il contesto della conversazione con Anthropic la prima volta che viene inviato, per poi riutilizzarlo. Scriverlo costa più di una normale richiesta; ogni risposta che lo riutilizza costa circa un ventesimo. Pertanto, la prima risposta sembra allarmantemente costosa, mentre quelle successive sono molto economiche. Qualsiasi elemento di grandi dimensioni nella conversazione rende quella prima risposta più pesante: un documento caricato da un visitatore è l’esempio principale. Un PDF di 24 pagine equivale a circa 70.000 token, poiché ogni pagina viene inviata sia come testo che come immagine della pagina, e rimane nella conversazione, quindi viene reinviata (e ricreata nella cache) a ogni risposta. Se una conversazione rimane inattiva per oltre un’ora, la copia archiviata scade e la risposta successiva paga nuovamente la scrittura.

Se stai creando qualcosa che fa uso intensivo di documenti (spiegazioni di contratti, consultazione di manuali, qualsiasi cosa in cui gli utenti caricano file), il livello Max è solitamente la scelta migliore: ha un costo fisso di 0,25 crediti per risposta, indipendentemente dalle dimensioni del documento, quindi non c’è alcun picco nel primo messaggio e nessuna esposizione al costo per token. Vedi Perché Max è la scelta più conveniente per scoprire come Max si confronta in termini di qualità e costo.

Se la tua chiave BYOK non funziona (non valida, esaurita o limitata nella frequenza — il che significa che Anthropic ha temporaneamente limitato il numero di richieste che la tua chiave può effettuare), il fatto che il tuo bot continui a funzionare dipende dall’interruttore “Fallback to credits” sulla stessa pagina BYOK API Keys:

• Attivo: la piattaforma passa temporaneamente ai crediti della piattaforma in modo che il tuo bot continui a rispondere e continui a riprovare a usare la tua chiave in background; nel momento in cui una chiamata ha di nuovo successo, torna automaticamente alla tua chiave.
• Disattivato (impostazione predefinita): le risposte dell’IA vengono bloccate finché non correggi la chiave. Nulla consuma i tuoi crediti silenziosamente, ma il tuo bot smette anche di rispondere, quindi se preferisci che continui a funzionare con i crediti mentre risolvi il problema della chiave, attiva questo interruttore in anticipo.

In ogni caso, riceverai un’email la prima volta che la tua chiave non funziona (non una per ogni messaggio).

Domande frequenti #

Posso utilizzare OpenAI, Gemini o un altro provider per il BYOK? Al momento no, per altri provider. Per la maggior parte delle persone la risposta è già qui: Max e Mini sono i nostri livelli interni, a 0,25 e 0,15 crediti per azione.

La mia chiave BYOK verrà utilizzata per tutto? La maggior parte delle operazioni di IA è esente da addebiti di crediti quando è collegata la tua chiave Anthropic (BYOK): le risposte dell’IA, l’uso degli strumenti, l’ottimizzazione delle campagne, la generazione della knowledge base e la ricerca web vengono eseguiti utilizzando la tua chiave. Quattro elementi continuano a costare crediti anche con una chiave collegata: il livello Max a 0,25 crediti per azione e il livello Mini a 0,15, poiché entrambi vengono eseguiti sui nostri modelli; Lead Finder a 0,25 per indirizzo email trovato; e le Automazioni a 0,25 per esecuzione più 0,25 per passaggio IA. Per mantenere un Agente completamente sulla tua chiave a 0 crediti, lascialo sul livello Pro. Le commissioni del canale (canone mensile di WhatsApp Web, costi di consegna dei messaggi WhatsApp e costi dei modelli) vengono fatturate separatamente dall’utilizzo dell’IA in ogni caso. Se la chiave non funziona durante una chiamata che avrebbe dovuto utilizzare la stessa, il fatto che la piattaforma passi ai crediti dipende dall’interruttore Fallback to credits (Ripristino ai crediti): consulta l’interruttore “Fallback to credits” descritto sopra in questa pagina.

Quando esattamente le risposte dell’IA costano 0 crediti? BYOK è per account. Le risposte dell’IA costano 0 crediti solo quando questo account ha collegato la propria chiave Anthropic. Senza una chiave propria, le risposte consumano crediti alla tariffa normale.

BYOK influisce sulla consegna dei messaggi o sull’affidabilità del canale? No. BYOK modifica solo il modo in cui vengono fatturate le chiamate IA del tuo bot. Tutto il resto — instradamento dei messaggi, infrastruttura del canale, follow-up, campagne e Broadcast — funziona esattamente allo stesso modo.

Vedi anche: Perché Max è il miglior rapporto qualità-prezzo · Configurazione del tuo bot IA · Agenti IA