# Chiave OpenAI

> Con una tua chiave OpenAI l'intelligenza artificiale di SupportFast lavora sul tuo conto OpenAI. Scegli modelli più avanzati e uno storico più lungo, e i messaggi AI non scalano dal piano.

Pagina: https://supportfast.ai/it/guida/sviluppatori/chiave-openai/ · Sezione: Account · Aggiornata il 30 ottobre 2026

> **Prima di iniziare**
>
> - Un account su platform.openai.com, con la fatturazione attiva e del credito.
> - Il permesso «Fatturazione (Account)». Senza, i riquadri della chiave non compaiono, né sull'account né sui workspace né sugli agenti.

## Cos'è e cosa cambia

La chiave OpenAI è un codice segreto che collega SupportFast al tuo account OpenAI. Senza una tua chiave, l'AI è compresa nel piano e usa il servizio di SupportFast.

| Cosa | Senza chiave propria | Con la tua chiave |
| --- | --- | --- |
| Modello AI | Sempre il modello predefinito | Scegli il modello nel Playground dell'agente chat e nei nodi AI delle automazioni |
| Storico | Al massimo gli ultimi 5 messaggi | Scegli quanti messaggi della conversazione considerare |
| Messaggi AI e costo | Compresi nel piano: scalano dalla quota mensile | Non scalano dal piano: li paghi a OpenAI, sul conto della chiave |
| Messaggi vocali nel widget | Non compresi | Compresi: l'agente risponde leggendo la trascrizione |
| Vocali su WhatsApp, Instagram e Messenger, con Ricezione e Trascrizione Audio accesa nel canale | Li ascolti in console e rispondi tu | Vengono trascritti e l'agente risponde |

**Cosa non cambia.** Minuti di chiamata, esecuzioni, invii, agenti, utenti e le altre quote restano quelle del piano. Vedi [Come si contano i consumi](https://supportfast.ai/it/guida/account/piani-e-consumi.md#consumi).

### Cosa usa la tua chiave

Con la chiave passano dal tuo conto OpenAI:

- le risposte dell'agente chat, su ogni canale;
- l'allenamento e la ricerca nella conoscenza;
- la trascrizione dei messaggi vocali;
- i nodi AI delle automazioni;
- il riepilogo e la traduzione nelle Conversazioni;
- la profilazione automatica dei contatti;
- per l'agente vocale, la generazione del prompt e l'analisi dopo la chiamata: esito, riepilogo e dati estratti.

## Quale chiave vale

Di solito basta una chiave sull'account, che vale per tutto. Se vuoi tenere separati dei costi, puoi mettere una chiave diversa su un workspace o su un singolo agente chat: vale la più vicina all'agente.

L'agente vocale e i nodi AI delle automazioni usano la chiave del workspace o dell'account. Per trascrivere i vocali dei canali vale la chiave dell'agente chat che risponde, se ne ha una; altrimenti quella del workspace o dell'account.

## Creare la chiave su OpenAI

1. **Entra nel pannello di OpenAI**
   Accedi a platform.openai.com con il tuo account OpenAI, oppure creane uno.

2. **Attiva la fatturazione**
   Aggiungi un metodo di pagamento e carica del credito. Senza credito la chiave non funziona.

3. **Crea la chiave**
   Ti consigliamo un progetto dedicato a SupportFast. Crea una nuova chiave segreta e dalle un nome riconoscibile, per esempio «SupportFast».

4. **Copiala intera**
   Copia la chiave, che comincia con `sk-`, e tienila in un posto sicuro finché non la inserisci.

> **Nota**
>
> **Permessi della chiave.** Se su OpenAI limiti i permessi della chiave, lasciale l'accesso ai modelli per la chat e per la ricerca nella conoscenza.

## Inserire la chiave

A ogni livello la console controlla la chiave in un momento diverso:

| Dove | Quando viene provata su OpenAI | Se OpenAI la rifiuta |
| --- | --- | --- |
| Account | Con Prova e salva, prima di salvarla. | Non viene salvata. |
| Workspace | Mai: si salva così com'è. | Te ne accorgi solo perché gli agenti non rispondono. Provala subito dopo il salvataggio, come spiegato qui sotto. |
| Agente chat | A ogni salvataggio della scheda Generali, anche se cambi altro. | Non si salva niente della scheda, nemmeno le altre modifiche. |

### Sull'account

Vale per tutti i workspace e gli agenti che non hanno una chiave propria.

1. **Apri la scheda della chiave**
   Vai in Account › Abbonamento e scorri fino alla scheda «Chiave OpenAI». In alternativa premi «Inserisci la chiave per messaggi illimitati» sulla scheda «Messaggi AI»: illimitati vuol dire senza il limite del piano, perché li paghi tu sul tuo conto OpenAI.

2. **Incolla la chiave**
   Incollala nel campo Chiave OpenAI. L'occhio Mostra la chiave la mostra per intero.

3. **Prova e salva**
   Premi Prova e salva. La console prova la chiave su OpenAI e la salva solo se funziona: compare «Chiave OpenAI salvata».

> **Risultato**
>
> Sulla scheda «Messaggi AI» compare «Chiave OpenAI inserita».

Una chiave rifiutata da OpenAI non viene salvata e leggi «La chiave non funziona: controlla di averla copiata intera e di aver attivato la fatturazione su platform.openai.com.».

### Su un workspace

Vale per gli agenti di quel workspace che non hanno una chiave propria.

1. **Apri le impostazioni del workspace**
   Vai nelle [Impostazioni del workspace](https://supportfast.ai/it/guida/workspace/impostazioni.md) e trova la scheda «Chiave OpenAI».

2. **Spegni la chiave dell'account**
   Spegni Usa la chiave API dell'Account principale: compare il campo per la chiave.

3. **Incolla la chiave**
   Incollala nel campo Chiave OpenAI.

4. **Salva e prova**
   Premi Salva modifiche nella barra in basso. Qui la console non prova la chiave: apri subito un agente del workspace con il link della chat. Se risponde, la chiave funziona.

### Su un agente chat

Vale solo per quell'agente. Serve a separare i costi, per esempio di un cliente o di un progetto.

1. **Apri il Profilo Agente**
   Vai in Agente chat › Profilo Agente › Generali, riquadro «Chiave OpenAI».

2. **Spegni la chiave del workspace e incolla la tua**
   Spegni Usa la chiave del workspace e incolla la chiave nel campo Inserisci chiave API che compare.

3. **Salva**
   Premi Salva modifiche. A ogni salvataggio della scheda la console prova la chiave su OpenAI. Se viene rifiutata, sul campo leggi «OpenAI non ha accettato questa chiave: controllala e riprova.» e non si salva niente, nemmeno le altre modifiche.

> **Attenzione**
>
> **Una chiave dell'agente che smette di funzionare blocca la scheda Generali.** Se è finito il credito o hai revocato la chiave, nessuna modifica della scheda si salva, anche se riguarda altro. Per sbloccarla ricarica il credito, incolla una chiave che funziona, oppure riaccendi Usa la chiave del workspace e salva.

## Se la chiave smette di funzionare

Una chiave può smettere di funzionare quando finisce il credito su OpenAI o quando la revochi. Finché non la sistemi, gli agenti che la usano non rispondono ai clienti e gli allenamenti nuovi falliscono.

> **Consiglio**
>
> **Tieni d'occhio il credito.** Nel pannello di OpenAI imposta un limite di spesa e un avviso via email.

Per ripartire, ricarica il credito oppure crea una chiave nuova e inseriscila al posto della vecchia. Poi rilancia gli allenamenti falliti con ⋮ › Riesegui allenamento: vedi [Allenamento: come funziona](https://supportfast.ai/it/guida/agente-testuale/allenamento.md).

## Togliere la chiave

- **Account.** Nella scheda «Chiave OpenAI» premi Rimuovi e conferma. La chiave viene tolta subito e i messaggi AI tornano a scalare dal piano.
- **Workspace.** Riaccendi Usa la chiave API dell'Account principale e salva: la chiave del workspace viene tolta.
- **Agente.** Riaccendi Usa la chiave del workspace e salva: la chiave dell'agente viene tolta.

Togliere la chiave da un livello non cambia gli altri: agenti e workspace con una chiave propria continuano a usarla.

Togliere la chiave da SupportFast non la disattiva su OpenAI. Se non ti serve più, revocala anche dal pannello di OpenAI.

## Privacy

Con la tua chiave, i dati che l'AI elabora arrivano a OpenAI attraverso il tuo account OpenAI. Su quei dati valgono quindi anche i termini che hai accettato con OpenAI, compreso il suo accordo sul trattamento dei dati: controllali prima di inserire la chiave. Come SupportFast tratta i dati per tuo conto lo dicono l'accordo sul trattamento dei dati (DPA) e l'elenco dei sub-responsabili: vedi [Documenti legali](https://supportfast.ai/it/guida/aiuto/documenti-legali.md) e [Privacy e sicurezza](https://supportfast.ai/it/guida/aiuto/privacy-sicurezza.md). Per un dubbio sul tuo caso, chiedi al tuo consulente privacy.

Non mandare la chiave via email o in chat, nemmeno a noi. Se è finita in mani sbagliate, revocala su OpenAI e inserisci quella nuova.

## Domande frequenti

**Posso usare la chiave di un altro fornitore di AI?**

No. SupportFast accetta solo chiavi OpenAI.

## Leggi anche

- [Playground: istruzioni e flussi](https://supportfast.ai/it/guida/agente-testuale/playground.md): Scegliere il modello e lo storico dell'agente.

- [Abbonamento e pagamenti](https://supportfast.ai/it/guida/account/abbonamento.md): La pagina con la chiave dell'account.