> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI

> Configura OpenAI per scrivere articoli del blog e generare email in Notifuse.

![OpenAI](https://www.notifuse.com/docs/assets/integrations/openai.png)

L'integrazione OpenAI fa funzionare l'[assistente IA](https://www.notifuse.com/it/docs/features/ai-assistant.md) di Notifuse con i modelli GPT, per scrivere il blog, progettare email e analizzare il traffico web.

## Configurazione

Vai in **Impostazioni** → **Integrazioni**, fai clic su **Aggiungi integrazione**, poi scegli **OpenAI** in **Assistente IA**.

### Campi del modulo

| Campo                   | Descrizione                                                                                                   | Esempio                        |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| **API Key**             | La tua API key di OpenAI                                                                                      | `sk-proj-...`                  |
| **Modello**             | L'ID del modello da usare. È un campo di testo libero, quindi funziona con qualsiasi modello attuale o futuro | `gpt-4.1`                      |
| **Base URL**            | Facoltativo. L'endpoint dell'API, per i provider compatibili con OpenAI. Lascialo vuoto per usare OpenAI      | `https://openrouter.ai/api/v1` |
| **Sforzo di reasoning** | Facoltativo. Quanto ragionano i modelli di reasoning: Nessuno, Minimo, Basso, Medio, Alto o Molto alto        | `Default`                      |

### Scegliere un modello

Il campo Modello è a testo libero, quindi puoi usare un modello uscito dopo la tua versione di Notifuse. Scrivi l'ID esattamente come lo scrive il tuo provider.

| Modello     | Adatto per                                                                   |
| ----------- | ---------------------------------------------------------------------------- |
| **GPT-4.1** | Il modello predefinito. Affidabile per i template MJML e gli articoli lunghi |
| **GPT-5.4** | Ragionamenti complessi e le generazioni più impegnative                      |
| **o4-mini** | Ragionamento più economico per compiti brevi e semplici                      |

Consulta la [pagina dei prezzi di OpenAI](https://platform.openai.com/docs/pricing) per le tariffe aggiornate.

> [!NOTE]
>
> Lascia **Sforzo di reasoning** su Predefinito per i modelli senza reasoning come GPT-4.1. I provider che non supportano questa impostazione la ignorano. Se le risposte arrivano troncate, abbassare lo sforzo lascia alla risposta visibile una parte maggiore del budget di output.

> [!NOTE]
>
> Il pannello dell'assistente mostra il costo progressivo delle conversazioni con Anthropic e Gemini, ma non con OpenAI. Poiché il campo accetta qualsiasi ID di modello, compresi tutti i modelli di OpenRouter e qualsiasi runtime in self-hosting, Notifuse non ha un listino da cui calcolarlo. Controlla la spesa nella dashboard del tuo provider.

## Funzioni abilitate

Con l'integrazione OpenAI configurata, l'assistente IA può fare quanto segue.

### Agente IA del blog

Per il blog, l'agente IA può:

| Funzione                   | Descrizione                                                                     |
| -------------------------- | ------------------------------------------------------------------------------- |
| **Scrivere articoli**      | Scrivere articoli completi a partire da un argomento o da una breve descrizione |
| **Ottimizzazione SEO**     | Generare meta title, meta description e parole chiave                           |
| **Modifica dei contenuti** | Migliorare, ampliare o riassumere contenuti esistenti                           |

### IA dell'editor email

Nell'editor email, l'agente IA può:

| Funzione                  | Descrizione                                                       |
| ------------------------- | ----------------------------------------------------------------- |
| **Generazione di email**  | Creare il contenuto delle email a partire da prompt o descrizioni |
| **Oggetti**               | Suggerire le righe dell'oggetto                                   |
| **Varianti di contenuto** | Creare più versioni per i test A/B                                |

### Assistente di Web Analytics

Rispondi alle domande sul traffico del tuo sito con l'[assistente di Web Analytics](https://www.notifuse.com/it/docs/web-analytics/ai-assistant.md):

| Funzione                      | Descrizione                                                               |
| ----------------------------- | ------------------------------------------------------------------------- |
| **Domande sul traffico**      | Interrogare sessioni, pagine, sorgenti e obiettivi in linguaggio naturale |
| **Riepiloghi del periodo**    | Un'analisi scritta di cosa è cambiato rispetto al periodo di confronto    |
| **Controllo della dashboard** | Cambiare il periodo, applicare filtri o aprire un report Esplora          |

## Potenziato con Firecrawl

Aggiungendo l'[integrazione Firecrawl](https://www.notifuse.com/it/docs/integrations/firecrawl.md), l'agente IA ottiene l'accesso al web:

| Capacità                      | Descrizione                                                     |
| ----------------------------- | --------------------------------------------------------------- |
| **Ricerca sul web**           | Cercare sul web informazioni e tendenze aggiornate              |
| **Scraping di URL**           | Estrarre il contenuto di pagine web specifiche come riferimento |
| **Analisi della concorrenza** | Studiare i contenuti e le strategie dei concorrenti             |
| **Verifica dei fatti**        | Verificare le affermazioni su fonti web aggiornate              |

Quando Firecrawl è configurato, l'agente IA ha a disposizione questi strumenti:

| Strumento    | Descrizione                                                            |
| ------------ | ---------------------------------------------------------------------- |
| `scrape_url` | Esegue lo scraping di un URL e ne restituisce il contenuto in markdown |
| `search_web` | Cerca sul web e restituisce gli URL pertinenti                         |

## Usare OpenRouter

[OpenRouter](https://openrouter.ai) è un gateway API che dà accesso a centinaia di modelli di IA (Google Gemini, Meta Llama, Mistral, DeepSeek e altri) dietro un unico endpoint compatibile con OpenAI.

L'integrazione OpenAI di Notifuse usa l'SDK standard di OpenAI, quindi puoi indirizzarla verso OpenRouter con il campo **Base URL**:

### Campi del modulo per OpenRouter

| Campo        | Descrizione                                 | Valore                         |
| ------------ | ------------------------------------------- | ------------------------------ |
| **API Key**  | La tua API key di OpenRouter                | `sk-or-v1-...`                 |
| **Modello**  | Qualsiasi modello disponibile su OpenRouter | `google/gemini-3-pro-preview`  |
| **Base URL** | Base URL dell'API di OpenRouter             | `https://openrouter.ai/api/v1` |

Le funzioni IA di Notifuse possono quindi usare qualsiasi modello di OpenRouter, Qwen compreso. Lo stesso campo funziona con qualsiasi altro endpoint compatibile con OpenAI: Azure OpenAI, oppure un runtime in self-hosting come Ollama, vLLM o LiteLLM.

> [!TIP]
>
> Confronta i modelli disponibili su [openrouter.ai/models](https://openrouter.ai/models).

> [!WARNING]
>
> L'agente IA genera template email MJML strutturati e articoli del blog completi in HTML. Solo i modelli forti nella scrittura di codice (per esempio GPT-4.1, Claude Sonnet, Gemini Pro) producono un risultato corretto. I modelli più piccoli possono generare template rotti o contenuti malformati.

## Prerequisiti

Ti servono:

1. Un account su [platform.openai.com](https://platform.openai.com)
2. Una API key generata nella dashboard di OpenAI
3. Crediti API sufficienti sull'account

## Note d'uso

> [!NOTE]
>
> Le chiamate API ai modelli GPT vengono conteggiate nell'utilizzo del tuo account OpenAI. Puoi seguire la spesa nella dashboard di OpenAI.

> [!TIP]
>
> **GPT-4.1** va bene per la maggior parte degli usi. Passa a un modello di reasoning per il lavoro creativo complesso, oppure a una variante mini o nano per compiti semplici e ad alto volume.
