🤖 Funzioni IA: input vocale, compilazione automatica e campi ChatGPT
propform integra OpenAI per tre funzioni basate sull'intelligenza artificiale: input vocale con trascrizione automatica, compilazione automatica del modulo tramite voce o testo e generazione di testo con ChatGPT in singoli campi.
Tutte le funzioni AI funzionano tramite la tua chiave API OpenAI: mantieni il controllo e gestisci i costi direttamente con OpenAI.
Contenuto
Configurazione: inserire la chiave API OpenAI
- Creare un account su platform.openai.com
- Creare una nuova chiave in "API keys" (sk-…)
- Imposta un metodo di pagamento su OpenAI (credito prepagato o carta di credito) — senza un pagamento attivo, le chiamate API non funzionano
- In propform → Impostazioni account → Integrazioni → Chiave API della piattaforma OpenAI inserisci la chiave + salva
Dopo aver salvato, le opzioni AI saranno abilitate nelle impostazioni del modulo.
> 💡 Importante: la chiave della piattaforma OpenAI è diversa dalla chiave di abbonamento a ChatGPT Plus (per il sito web della chat). È necessaria la chiave API con il metodo di pagamento associato.
## Inserimento vocale (trascrizione Whisper)
Invece di digitare, chi visita il modulo può cliccare su un pulsante di registrazione audio, parlare nel microfono e il testo verrà trascritto automaticamente.
Attivazione
- Nell'editor del modulo → Impostazioni del modulo → Altre impostazioni → "Attiva input vocale"
- Dopo l'attivazione, nel modulo compare un pulsante microfono in alto
Come funziona
- L'utente clicca sul microfono → Il browser richiede l'accesso al microfono → La registrazione inizia
- L'utente parla (ad es. "Mi chiamo Max Mustermann, cerco un appartamento a Monaco di Baviera per un massimo di 600.000 euro")
- Interrompi la registrazione → L'audio viene inviato a OpenAI Whisper → Il testo viene restituito
- Il testo è disponibile nel campo di immissione per l'ulteriore elaborazione
Modello utilizzato: gpt-4o-mini-transcribe (aggiornato al 2026-04 — aggiorniamo in caso di aggiornamenti del modello OpenAI).
---
Compilazione automatica tramite voce o testo
La funzione IA più interessante: il testo libero trascritto (o digitato direttamente) viene distribuito automaticamente nei campi del modulo.
Come funziona
- L'utente pronuncia o digita un testo libero con tutte le informazioni
- propform invia il testo + uno schema dei campi del modulo disponibili a GPT-4o
- GPT-4o fornisce una risposta JSON strutturata con
fields → values
- propform compila automaticamente i campi corrispondenti nel modulo
Esempio di input:
Ich heiße Anna Müller, anna.mueller@example.com, suche eine Doppelhaushälfte
in Hamburg-Eppendorf, mindestens 130 qm, höchstens 800.000 Euro, möchte am
liebsten Erstbezug nach Sanierung.
Risultato:
- Nome:
Anna
- Cognome:
Müller
- E-mail:
anna.mueller@example.com
- Tipo di immobile:
Haus (mappato da "villetta bifamiliare")
- Tipo di immobile:
Doppelhaushälfte
- Regione:
Hamburg-Eppendorf (mappato dalle opzioni a selezione multipla)
- Superficie abitabile da:
130
- Prezzo di acquisto fino a:
800000
- Condizioni:
Erstbezug nach Sanierung
Mappatura a selezione singola/multipla
GPT-4o riceve tutti i valori chiave disponibili dei campi a selezione singola/multipla. Se il testo pronunciato corrisponde a un'opzione, viene impostato il valore chiave corretto — non il nome in chiaro.
Se non è possibile un'assegnazione univoca: GPT non genera alcun valore, ma una nota clarifications che il frontend può visualizzare (<gehörter_text>"</gehörter_text>Opzione sconosciuta: <gehörter_text>"). L'utente può quindi selezionare manualmente.
Euristiche aziendali
GPT-4o riceve l'istruzione di rendere coerenti determinati mappamenti:
- "in vendita" / "oggetto in vendita" → Tipo di commercializzazione =
kauf
- "appartamento in affitto" / "in affitto" → Tipo di commercializzazione =
miete
- Se viene impostato "Tipo di immobile", viene automaticamente impostato anche "Categoria immobile" in modo corrispondente
Modello utilizzato: gpt-4o con response_format=json_object e temperature=0 (output deterministico).
---
Campi di generazione di testo ChatGPT
Tipo di campo specifico per testi generati automaticamente in un modulo — ad es. generare una descrizione dell'oggetto dai dati chiave inseriti.
Configurazione
- Nell'editor dei moduli → Aggiungi campo → Tipo di campo "Campo ChatGPT"
- Definire un modello di prompt con macro che rimandano ad altri campi, ad es.:
Schreibe eine ansprechende Objektbeschreibung für eine Immobilie:
- Objektart: _objektart
- Lage: _ort, _strasse
- Baujahr: _baujahr
- Wohnfläche: _wohnflaeche m²
- Kaufpreis: _kaufpreis €
Stil: einladend, sachlich, max 150 Wörter.
- Al momento dell'invio (o cliccando su "Genera"), propform invia il prompt a GPT-4o → la risposta viene scritta nel campo
Casi d'uso
- Generare automaticamente la descrizione dell'immobile dai dati chiave
- Proposta di email di acquisizione al proprietario
- Motivazione della valutazione dai dati comparativi
- Punti salienti per la scheda descrittiva
> 💡 Suggerimento per il flusso di lavoro: Visualizza il testo generato come proposta, l'utente lo modifica prima che venga accettato definitivamente — L'IA non è perfetta, la revisione umana migliora notevolmente il risultato.
Costi e limiti
Prezzi OpenAI (aggiornati ad aprile 2026, soggetti a modifiche!)
| Modello |
Prezzo per 1k token |
Caso d'uso |
gpt-4o-mini-transcribe (Whisper) |
~$0,006 / minuto di audio |
Input vocale |
gpt-4o |
~$5 input + $15 output / 1 milione di token |
Compilazione automatica, campi ChatGPT |
Esempi realistici di costi:
- 100 input vocali da 30 secondi ciascuno ≈ $0,30
- 100 operazioni di compilazione automatica con 200 parole di input + schema ciascuna ≈ $0,50
- 100 generazioni di descrizioni di oggetti ≈ $1,50
→ Molto conveniente per la maggior parte dei casi d'uso. In caso di chiamate di massa (ad es. modulo di ricerca pubblico con traffico elevato) i costi possono aumentare rapidamente — è consigliabile impostare dei limiti in OpenAI.
Impostare i limiti in OpenAI
Nel tuo account OpenAI → Limiti di utilizzo → definisci i limiti massimi mensili. Protegge da sorprese in caso di traffico bot o configurazioni errate.
Aspetti relativi alla protezione dei dati
Quando attivi le funzioni di IA, i dati dei moduli vengono trasmessi a OpenAI — ciò ha implicazioni in materia di protezione dei dati:
Cosa viene inviato
- Input vocale: file audio + indicazione della lingua
- Compilazione automatica: testo libero + schema dei campi del modulo (ID dei campi, opzioni)
- Campi ChatGPT: prompt con macro risolte (= contenuto attuale di altri campi)
Conseguenze in materia di protezione dei dati
- OpenAI è un fornitore terzo con sede negli Stati Uniti — rilevante ai fini del GDPR
- OpenAI si impegna a NON utilizzare i dati API per l'addestramento (a differenza dell'input della chat web ChatGPT)
- Tuttavia: è necessario il consenso esplicito del visitatore del modulo se i dati personali vengono trasmessi a OpenAI
- Stipulare un accordo con OpenAI (disponibile nella dashboard di OpenAI) — obbligatorio ai sensi del GDPR
Attuazione pratica
- Documentare l'utilizzo di OpenAI nella tua informativa sulla privacy
- Inserire nel modulo un avviso + casella di opt-in "Acconsento che i miei dati inseriti vengano trasmessi a OpenAI per l'elaborazione tramite IA" prima dell'attivazione della funzione IA
- Per i clienti bancari e altri settori regolamentati: è preferibile disattivare le funzioni di IA o utilizzarle solo per campi non personali (ad es. pura generazione di descrizioni di oggetti)
📖 Maggiori informazioni sulla protezione dei dati in generale: Protezione dei dati e minimizzazione dei dati
---
Risoluzione dei problemi
"missing_or_invalid_openai_key"
La chiave API non è stata inserita o è errata. Verificare:
- Impostazioni account → Integrazioni → Chiave API OpenAI
- La chiave inizia con
sk- e non è abbreviata
- In OpenAI: la chiave è ancora attiva (non è stata cancellata o sostituita)
„asr_upstream_error" (la lingua non viene trascritta)
- Metodo di pagamento registrato in OpenAI? Senza pagamento le chiamate API non funzionano
- Limiti raggiunti? Dashboard OpenAI → Controllare l'utilizzo
- Dimensione del file audio troppo grande? Whisper ha un limite di 25 MB per file (raggiunto molto raramente con gli input vocali)
L'autocompilazione effettua attribuzioni errate
- Controllare i valori chiave: GPT riceve i valori chiave del campo a selezione singola/multipla — se questi sono criptici (ad es.
ind_3673), GPT non è in grado di effettuare l'assegnazione. Soluzione: le etichette personalizzate nel campo (vedi Campi → Etichette personalizzate) aiutano GPT nell'assegnazione
- In caso di frequenti errori di assegnazione: aggiungere un'euristica esplicita nel prompt del campo ChatGPT ("Se l'utente dice X, si intende Y")
Costi elevati inaspettati
- Traffico bot? Verificare la whitelist IP o la protezione honeypot (vedere Protezione moduli)
- Campi ChatGPT con schema troppo ampio o attivazione frequente? Ottimizzazione del prompt
- Impostare un limite OpenAI per sicurezza (vedere sopra)
Correlati