🤖 KI-Funktionen: Spracheingabe, Auto-Ausfüllen & ChatGPT-Felder
propform integriert OpenAI für drei KI-gestützte Funktionen: Spracheingabe mit automatischer Transkription, Auto-Ausfüllen des Formulars per Sprache oder Text, und ChatGPT-Textgenerierung in einzelnen Feldern.
Alle KI-Funktionen laufen über deinen eigenen OpenAI-API-Key — du behältst Kontrolle und Kosten direkt bei OpenAI.
Inhalt
Setup: OpenAI-API-Key hinterlegen
- Account auf platform.openai.com anlegen
- Unter „API keys" einen neuen Key erstellen (sk-…)
- Zahlungsmethode hinterlegen bei OpenAI (Pre-Paid Credit oder Kreditkarte) — ohne aktive Zahlung funktionieren die API-Aufrufe nicht
- In propform → Account-Einstellungen → Integrationen → OpenAI-Platform-API-Key eintragen + speichern
Nach dem Speichern sind in den Formulareinstellungen die KI-Optionen freigeschaltet.
💡 Wichtig: Der OpenAI-Platform-Key ist anders als der ChatGPT-Plus-Subscription-Key (für die Chat-Webseite). Du brauchst den API-Key mit Zahlungsmethode dahinter.
Spracheingabe (Whisper-Transkription)
Der Formularbesucher kann statt zu tippen einen Audio-Aufnahme-Button anklicken, ins Mikrofon sprechen, und der Text wird automatisch transkribiert.
Aktivierung
- Im Formular-Editor → Formulareinstellungen → Weitere Einstellungen → „Spracheingabe aktivieren"
- Nach dem Aktivieren erscheint im Formular ein Mikrofon-Button oben
Wie es funktioniert
- User klickt Mikrofon → Browser fragt Mikrofon-Zugriff an → Aufnahme startet
- User spricht (z.B. „Ich heiße Max Mustermann, suche eine Wohnung in München für maximal 600.000 Euro")
- Aufnahme stoppen → Audio wird an OpenAI Whisper geschickt → Text kommt zurück
- Der Text steht im Eingabefeld zur weiteren Verarbeitung
Verwendetes Modell: gpt-4o-mini-transcribe (Stand 2026-04 — wir aktualisieren bei OpenAI-Modell-Updates).
Auto-Ausfüllen via Sprache oder Text
Die spannendste KI-Funktion: das transkribierte (oder direkt eingetippte) freie Text wird automatisch in die Formularfelder verteilt.
Wie es funktioniert
- User spricht oder tippt einen Freitext mit allen Infos
- propform sendet den Text + ein Schema der verfügbaren Formularfelder an GPT-4o
- GPT-4o liefert eine strukturierte JSON-Antwort mit
fields → values
- propform befüllt die entsprechenden Felder im Formular automatisch
Beispiel-Eingabe:
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.
Resultat:
- Vorname:
Anna
- Nachname:
Müller
- E-Mail:
anna.mueller@example.com
- Objektart:
Haus (gemappt aus „Doppelhaushälfte")
- Objekttyp:
Doppelhaushälfte
- Region:
Hamburg-Eppendorf (gemappt aus Multi-Select-Optionen)
- Wohnfläche von:
130
- Kaufpreis bis:
800000
- Zustand:
Erstbezug nach Sanierung
Single-/Multi-Select-Mapping
GPT-4o bekommt alle verfügbaren Schlüsselwerte der Single-/Multi-Select-Felder mit. Wenn der gesprochene Text auf eine Option matcht, wird der korrekte Schlüsselwert gesetzt — nicht der Klar-Name.
Wenn keine eindeutige Zuordnung möglich: GPT erzeugt keine Befüllung, sondern eine clarifications-Notiz, die das Frontend anzeigen kann („Option unbekannt: <gehörter_text>"). User kann dann manuell wählen.
Business-Heuristiken
GPT-4o wird angewiesen, bestimmte Mappings konsistent zu machen:
- „zum Kauf" / „Kaufobjekt" → Vermarktungsart =
kauf
- „Mietwohnung" / „zur Miete" → Vermarktungsart =
miete
- Wenn „Objekttyp" gesetzt wird, wird automatisch passend „Objektart" mitgesetzt
Verwendetes Modell: gpt-4o mit response_format=json_object und temperature=0 (deterministische Ausgabe).
ChatGPT-Textgenerierungs-Felder
Eigener Feldtyp für automatisch generierte Texte in einem Formular — z.B. eine Objektbeschreibung aus den eingegebenen Eckdaten generieren lassen.
Setup
- Im Formular-Editor → Feld hinzufügen → Feldtyp „ChatGPT-Feld"
- Prompt-Vorlage definieren mit Makros zu anderen Feldern, z.B.:
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.
- Beim Submit (oder bei Klick auf „Generieren") schickt propform den Prompt an GPT-4o → Antwort wird ins Feld geschrieben
Use-Cases
- Objektbeschreibung automatisch aus Eckdaten generieren
- Akquise-Mail-Vorschlag an Eigentümer
- Bewertungs-Begründung aus Vergleichsdaten
- Highlight-Bullet-Points für Exposé
💡 Workflow-Tipp: Generierten Text als Vorschlag anzeigen, User editiert noch bevor er final übernommen wird — KI ist nicht perfekt, menschliche Review verbessert deutlich.
Kosten & Limits
OpenAI-Preise (Stand April 2026, ändern sich!)
| Modell |
Preis pro 1k Token |
Use-Case |
gpt-4o-mini-transcribe (Whisper) |
~$0.006 / Minute Audio |
Spracheingabe |
gpt-4o |
~$5 input + $15 output / 1M Token |
Auto-Fill, ChatGPT-Felder |
Realistische Beispiel-Kosten:
- 100 Spracheingaben à 30 Sekunden ≈ $0.30
- 100 Auto-Fill-Vorgänge mit jeweils 200 Wörtern Input + Schema ≈ $0.50
- 100 Objektbeschreibungs-Generierungen ≈ $1.50
→ Sehr günstig für die meisten Use-Cases. Bei Mass-Aufrufen (z.B. öffentliches Suchformular mit hohem Traffic) kann es sich schnell summieren — Limits in OpenAI setzen sinnvoll.
Limits in OpenAI setzen
In deinem OpenAI-Account → Usage Limits → monatliche Hard-Limit-Caps definieren. Schützt vor Überraschungen bei Bot-Traffic oder Fehl-Konfigurationen.
Datenschutz-Aspekte
Wenn du KI-Funktionen aktivierst, werden Formulardaten an OpenAI übermittelt — das hat Datenschutz-Implikationen:
Was wird gesendet
- Spracheingabe: Audio-Datei + Sprache-Hinweis
- Auto-Fill: Freitext + Schema der Formularfelder (Feld-IDs, Optionen)
- ChatGPT-Felder: Prompt mit aufgelösten Makros (= aktueller Inhalt anderer Felder)
Datenschutz-Konsequenzen
- OpenAI ist ein Drittanbieter in den USA — DSGVO-relevant
- OpenAI sagt zu, API-Daten NICHT für Training zu verwenden (im Gegensatz zur Web-ChatGPT-Eingabe)
- Trotzdem: Du brauchst eine explizite Einwilligung des Formularbesuchers, wenn personenbezogene Daten an OpenAI gehen
- AVV mit OpenAI abschließen (verfügbar im OpenAI-Dashboard) — verpflichtend für DSGVO
Praktische Umsetzung
- In deiner Datenschutzerklärung den Einsatz von OpenAI dokumentieren
- Im Formular einen Hinweis + Opt-In-Checkbox „Ich bin einverstanden, dass meine Eingabe für die KI-Verarbeitung an OpenAI übermittelt wird" vor der Aktivierung der KI-Funktion einbauen
- Für Bank-Kunden und andere regulierte Branchen: KI-Funktionen besser deaktivieren oder nur für nicht-personenbezogene Felder (z.B. reine Objektbeschreibungs-Generierung) nutzen
📖 Mehr zu Datenschutz allgemein: Datenschutz & Datensparsamkeit
Troubleshooting
„missing_or_invalid_openai_key"
Der API-Key ist nicht hinterlegt oder falsch. Prüfen:
- Account-Einstellungen → Integrationen → OpenAI-API-Key
- Key beginnt mit
sk- und ist nicht gekürzt
- In OpenAI: Key noch aktiv (nicht gelöscht oder rotiert)
„asr_upstream_error" (Sprache wird nicht transkribiert)
- Zahlungsmethode in OpenAI hinterlegt? Ohne Zahlung funktionieren API-Aufrufe nicht
- Limits erreicht? OpenAI-Dashboard → Usage prüfen
- Audio-Dateigröße zu groß? Whisper hat ein 25 MB Limit pro Datei (bei Spracheingaben sehr selten erreicht)
Auto-Fill macht falsche Zuordnungen
- Schlüsselwerte prüfen: GPT bekommt die Schlüsselwerte des Single-/Multi-Select-Felds — wenn die kryptisch sind (z.B.
ind_3673), kann GPT nicht zuordnen. Lösung: Custom-Beschriftungen im Feld (siehe Felder → Custom-Beschriftungen) helfen GPT bei der Zuordnung
- Bei häufigen Fehl-Zuordnungen: Im ChatGPT-Feld-Prompt eine explizite Heuristik ergänzen („Wenn der Nutzer X sagt, ist Y gemeint")
Hohe Kosten unerwartet
- Bot-Traffic? IP-Whitelist oder Honeypot-Schutz prüfen (siehe Formular-Schutz)
- ChatGPT-Felder mit zu großem Schema oder häufiger Auslösung? Prompt-Optimierung
- OpenAI-Limit zur Sicherheit setzen (siehe oben)
Verwandt