🤖 Funciones de IA: entrada de voz, autocompletado y campos de ChatGPT

propform integra OpenAI para ofrecer tres funciones basadas en IA: entrada de voz con transcripción automática, autocompletado del formulario mediante voz o texto, y generación de texto con ChatGPT en campos individuales.

Todas las funciones de IA se ejecutan a través de tu propia clave API de OpenAI: tú mantienes el control y los costes directamente con OpenAI.

Contenido

• Configuración: introducir la clave API de OpenAI
• Entrada de voz (transcripción de Whisper)
• Autocompletado mediante voz o texto
• Campos de generación de texto con ChatGPT
• Costes y límites
• Aspectos de privacidad
• Solución de problemas

Configuración: Introducir la clave API de OpenAI

1. Crear una cuenta en platform.openai.com
2. En «API keys», crear una nueva clave (sk-…)
3. Configurar un método de pago en OpenAI (crédito prepagado o tarjeta de crédito); sin un pago activo, las llamadas a la API no funcionarán
4. En propform → Configuración de la cuenta → Integraciones → Clave API de la plataforma OpenAI, introducir la clave y guardar

Una vez guardado, las opciones de IA estarán habilitadas en la configuración del formulario.

> 💡 Importante: La clave de la plataforma OpenAI es diferente de la clave de suscripción a ChatGPT Plus (para la página web del chat). Necesitas la clave API con un método de pago asociado.

## Entrada de voz (transcripción de susurros)

En lugar de escribir, el usuario del formulario puede hacer clic en un botón de grabación de audio, hablar al micrófono y el texto se transcribirá automáticamente.

Activación

1. En el editor de formularios → Configuración del formulario → Más opciones → «Activar entrada de voz»
2. Tras la activación, aparecerá un botón de micrófono en la parte superior del formulario

Cómo funciona

• El usuario hace clic en el micrófono → El navegador solicita acceso al micrófono → Se inicia la grabación
• El usuario habla (p. ej., «Me llamo Max Mustermann, busco un piso en Múnich por un máximo de 600 000 euros»)
• Se detiene la grabación → El audio se envía a OpenAI Whisper → Se recibe el texto
• El texto aparece en el campo de entrada para su posterior procesamiento

Modelo utilizado: gpt-4o-mini-transcribe (a fecha de abril de 2026; lo actualizaremos cuando haya actualizaciones del modelo de OpenAI).

---

Autocompletado mediante voz o texto

La función de IA más interesante: el texto libre transcrito (o escrito directamente) se distribuye automáticamente en los campos del formulario.

Cómo funciona

• El usuario habla o escribe un texto libre con toda la información
• propform envía el texto + un esquema de los campos de formulario disponibles a GPT-4o
• GPT-4o proporciona una respuesta JSON estructurada con fields → values
• propform rellena automáticamente los campos correspondientes del formulario

Ejemplo de entrada:

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.

Resultado:

• Nombre: Anna
• Apellidos: Müller
• Correo electrónico: anna.mueller@example.com
• Tipo de propiedad: Haus (asignado a partir de «Casa adosada»)
• Clase de propiedad: Doppelhaushälfte
• Región: Hamburg-Eppendorf (asignado a partir de opciones de selección múltiple)
• Superficie habitable de: 130
• Precio de compra hasta: 800000
• Estado: Erstbezug nach Sanierung

Asignación de selección única/múltiple

GPT-4o recibe todos los valores clave disponibles de los campos de selección única/múltiple. Si el texto hablado coincide con una opción, se establece el valor clave correcto, no el nombre claro.

Si no es posible una asignación única: GPT no genera ningún valor, sino una nota clarifications que el frontend puede mostrar («Opción desconocida: <gehörter_text>»). El usuario puede entonces seleccionar manualmente.

Heurísticas de negocio

Se indica a GPT-4o que mantenga la coherencia en determinadas asignaciones:

• «para la venta» / «objeto de venta» → Tipo de comercialización = kauf
• «vivienda en alquiler» / «en alquiler» → Tipo de comercialización = miete
• Si se establece «Tipo de propiedad», se establece automáticamente el «Tipo de objeto» correspondiente.

Modelo utilizado: gpt-4o con response_format=json_object y temperature=0 (salida determinista).

---

Campos de generación de texto de ChatGPT

Tipo de campo propio para textos generados automáticamente en un formulario — p. ej., generar una descripción del objeto a partir de los datos clave introducidos.

Configuración

1. En el editor de formularios → Añadir campo → Tipo de campo «Campo ChatGPT»
2. Definir plantilla de prompt con macros a otros campos, p. ej.:

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.

3. Al enviar (o al hacer clic en «Generar»), propform envía el prompt a GPT-4o → la respuesta se escribe en el campo

Casos de uso

• Generar automáticamente la descripción del inmueble a partir de datos clave
• Propuesta de correo electrónico de captación para el propietario
• Justificación de la valoración a partir de datos comparativos
• Puntos destacados para el informe del inmueble

> 💡 Consejo de flujo de trabajo: Mostrar el texto generado como propuesta; el usuario lo edita antes de que se acepte definitivamente — La IA no es perfecta, la revisión humana mejora significativamente el resultado.

Costes y límites

Precios de OpenAI (a fecha de abril de 2026, ¡sujetos a cambios!)

Ejemplos de costes realistas:

• 100 entradas de voz de 30 segundos cada una ≈ 0,30 $
• 100 operaciones de autocompletado con 200 palabras de entrada + esquema cada una ≈ 0,50 $
• 100 generaciones de descripciones de objetos ≈ 1,50 $

→ Muy económico para la mayoría de los casos de uso. En caso de llamadas masivas (p. ej., formulario de búsqueda público con mucho tráfico), los costes pueden acumularse rápidamente; es recomendable establecer límites en OpenAI.

Establecer límites en OpenAI

En tu cuenta de OpenAI → Límites de uso → define los límites máximos mensuales. Esto te protege de sorpresas en caso de tráfico de bots o configuraciones erróneas.

## Aspectos de protección de datos

Al activar las funciones de IA, los datos del formulario se envían a OpenAI, lo que tiene implicaciones en materia de protección de datos:

Qué se envía

• Entrada de voz: archivo de audio + indicación de idioma
• Autocompletado: texto libre + esquema de los campos del formulario (ID de campos, opciones)
• Campos de ChatGPT: prompt con macros resueltas (= contenido actual de otros campos)

Consecuencias en materia de protección de datos

• OpenAI es un proveedor externo con sede en EE. UU. — relevante para el RGPD
• OpenAI se compromete a NO utilizar los datos de la API para entrenamiento (a diferencia de la entrada del chat web de ChatGPT)
• No obstante: necesitas el consentimiento explícito del visitante del formulario si se envían datos personales a OpenAI
• Celebrar un ACV con OpenAI (disponible en el panel de control de OpenAI) — obligatorio según el RGPD

Aplicación práctica

• Documenta el uso de OpenAI en tu política de privacidad
• Incluye en el formulario una nota + casilla de verificación de consentimiento «Acepto que mis datos se transmitan a OpenAI para su procesamiento mediante IA» antes de activar la función de IA
• Para clientes bancarios y otros sectores regulados: Es mejor desactivar las funciones de IA o utilizarlas solo para campos no personales (por ejemplo, la mera generación de descripciones de objetos)

📖 Más información sobre protección de datos en general: Protección de datos y minimización de datos

Solución de problemas

«missing_or_invalid_openai_key»

La clave API no está registrada o es incorrecta. Comprueba:

• Ajustes de la cuenta → Integraciones → Clave API de OpenAI
• La clave comienza por sk- y no está truncada
• En OpenAI: la clave sigue activa (no se ha eliminado ni rotado)

«asr_upstream_error» (el lenguaje no se transcribe)

• ¿Se ha configurado un método de pago en OpenAI? Sin pago, las llamadas a la API no funcionan
• ¿Se han alcanzado los límites? Panel de control de OpenAI → Comprobar el uso
• ¿El tamaño del archivo de audio es demasiado grande? Whisper tiene un límite de 25 MB por archivo (algo muy poco frecuente en entradas de voz)

El autocompletado realiza asignaciones incorrectas

• Comprobar valores clave: GPT recibe los valores clave del campo de selección única o múltiple; si son crípticos (p. ej., ind_3673), GPT no puede realizar la asignación. Solución: Las etiquetas personalizadas en el campo (véase Campos → Etiquetas personalizadas) ayudan a GPT con la asignación
• En caso de asignaciones erróneas frecuentes: añadir una heurística explícita en el prompt del campo de ChatGPT («Si el usuario dice X, se refiere a Y»)

Costes elevados inesperados

• ¿Tráfico de bots? Comprueba la lista blanca de IP o la protección contra honeypots (véase Protección de formularios)
• ¿Campos de ChatGPT con un esquema demasiado grande o activación frecuente? Optimización de la indicación
• Establece un límite de OpenAI por seguridad (véase más arriba)

Relacionado

• 📖 Configuración de la cuenta → OpenAI — Configuración de la clave API
• 📖 Campos → Campo ChatGPT — Tipo de campo especial para generación de IA
• 📖 Protección de datos — Avisos del RGPD sobre la transmisión a terceros
• 📖 Protección de formularios — La protección contra bots reduce los costes de API no deseados</gehörter_text>