OpenAI Responses API
Introducción
OpenAI Responses API es el provider de inteligencia artificial más avanzado disponible en AsisteClick para construir chatbots inteligentes. Combina los modelos más recientes de OpenAI (familia GPT-5) con herramientas integradas como búsqueda web, ejecución de código, generación de imágenes y análisis de documentos, todo en una sola configuración.
¿Por qué elegir Responses API?
- Modelos de última generación: Acceso a GPT-5, GPT-5-mini, GPT-5-nano y toda la familia GPT-4.1
- Herramientas builtin: Web Search, Code Interpreter e Image Generation se activan automáticamente, sin configuración adicional
- Soporte multimodal: El bot puede recibir y procesar imágenes, documentos, archivos CSV/Excel y audio
- Structured Output: Respuestas en formato JSON validado, que permiten extraer variables, detectar intenciones y clasificar conversaciones de forma confiable
- Contexto conversacional automático: El historial se mantiene automáticamente entre mensajes, sin necesidad de reenviarlo cada vez
1. Cómo Configurar un Bot con Responses API
Paso 1: Crear un nuevo Bot o Skill LLM
Desde el panel de administración, creá un nuevo bot o abrí la configuración de un skill LLM existente.
Paso 2: Seleccionar el Provider
En el selector de Provider, elegí "OpenAI Responses API (Beta)".
Paso 3: Ingresar tu API Key de OpenAI
Pegá tu API Key de OpenAI en el campo API Key. Podés verificar que la conexión sea correcta haciendo clic en el botón de verificación (ícono de enchufe).
- Usá el ícono del ojo para mostrar/ocultar la key
- El botón de enchufe verifica la conexión con OpenAI
Paso 4: Seleccionar el Modelo
Elegí el modelo que mejor se ajuste a tu caso de uso. Los modelos disponibles para Responses API son:
- GPT 5.4
- GPT 5.4-mini (recomendado para la mayoría de casos)
- GPT 5.4-nano
- GPT 5.2
- GPT 5
- GPT 5-mini
- GPT 5-nano
- GPT 4.1
- GPT 4.1-mini
Paso 5: Escribir el System Prompt (Instrucciones)
En el campo de instrucciones, describí el comportamiento del bot: su personalidad, qué información maneja, cómo debe responder, y qué debe hacer cuando no sabe algo.
Ejemplo de system prompt:
Sos el asistente virtual de TiendaOnline. Tu rol es ayudar a los clientes
con consultas sobre productos, envíos y devoluciones.
Reglas:
- Respondé siempre en español
- Sé amable y profesional
- Si no sabés la respuesta, ofrecé transferir a un agente humano
- Usá la información del Knowledge Base para responder sobre productosPaso 6: Configurar Knowledge Base (Opcional)
Si querés que el bot responda en base a documentos específicos (catálogos, manuales, FAQs), configurá un Knowledge Base:
- Subí los archivos en la sección de Knowledge Base
- Selecciona los Knowledge Bases que quieras vincular a este bot
- El sistema realizará un proceso de incorporación de la KB al bot de manera automática
En cualquier momentos podés "resetear" toda la base de conocimientos activa del bot de la siguiente manera:
- Hacé clic en el botón Regenerar (ícono de recarga junto al selector de provider)
- Esto creará un Vector Store en OpenAI que el bot usará para buscar información relevante
Paso 7: Grabar bot
Hacé clic en Grabar Bot para guardar la configuración y activar el bot.
2. Modelos Disponibles y Costos
Modelo | Input (USD/1M tokens) | Output (USD/1M tokens) | Ideal para |
|---|---|---|---|
GPT-5.4 | $2.5 | $15.00 | Modelo más avanzado. Tareas complejas, máxima calidad. |
GPT-5.4-mini | $0.75 | $4.50 | Balance óptimo entre calidad y costo. |
GPT-5.4-nano | $0.20 | $1.25 | El más rápido y económico de la familia 5.4. |
GPT-5.2 | $1.75 | $14.00 | Coding, ciencia, razonamiento complejo |
GPT-5 | $1.25 | $10.00 | Flagship general, reducción significativa de alucinaciones |
GPT-5-mini | $0.25 | $2.00 | Recomendado: mejor relación costo/rendimiento |
GPT-5-nano | $0.05 | $0.40 | Alto volumen, respuestas ultra-rápidas |
GPT-4.1 | $2.00 | $8.00 | Contexto ultra-largo (1 millón de tokens) |
GPT-4.1-mini | $0.40 | $1.60 | Contexto largo, económico |
¿Qué modelo elegir?
Caso de uso | Modelo recomendado | Por qué |
|---|---|---|
Alto volumen / respuestas simples | GPT-5-nano | El más económico ($0.05/1M input), ideal para FAQs y respuestas cortas |
Uso general / mejor balance | GPT-5-mini | Excelente calidad a un precio accesible, cubre el 90% de los casos |
Máxima calidad | GPT-5 o GPT-5.2 | Para consultas complejas que requieren razonamiento profundo |
Documentos muy largos | GPT-4.1 o GPT-4.1-mini | Ventana de contexto de 1 millón de tokens para procesar documentos extensos |
3. Herramientas Builtin (Tools)
Responses API incluye herramientas integradas que se activan automáticamente. No necesitás configurar nada extra: el bot decide cuándo usarlas según la consulta del cliente.
3.1 Web Search (siempre activa)
El bot puede buscar información actualizada en internet cuando lo necesita.
Casos de uso:
- El cliente pregunta por precios actuales, disponibilidad o novedades
- Consultas sobre temas que cambian frecuentemente
- Verificación de datos en tiempo real
Ejemplo:
3.2 Code Interpreter (siempre activo)
Ejecuta código Python en tiempo real dentro de un entorno seguro de OpenAI.
Casos de uso:
- Análisis de datos: el cliente sube un CSV o Excel y el bot lo procesa
- Cálculos complejos: presupuestos, conversiones, estadísticas
- Generación de gráficos y visualizaciones
Ejemplo:
3.3 Image Generation (siempre activa)
Genera imágenes a partir de descripciones de texto usando DALL-E / gpt-image-1.
Casos de uso:
- El cliente pide que le generen una imagen, logo o diseño
- Visualizaciones creativas para propuestas
Ejemplo:
3.4 File Search / Knowledge Base (activa cuando hay KB configurada)
Busca información dentro de los documentos cargados en el Knowledge Base usando RAG (Retrieval Augmented Generation).
Requisitos:
- Tener archivos subidos en el Knowledge Base del bot
- Haber hecho clic en Regenerar para crear el Vector Store
Casos de uso:
- Consultas sobre catálogos de productos
- Preguntas frecuentes basadas en documentos internos
- Manuales técnicos o políticas de la empresa
3.5 Function Calling / AI Tools (activa cuando hay tools configurados)
Ejecuta herramientas personalizadas definidas en el playbook para conectar el bot con sistemas externos.
Casos de uso:
- Consultar el estado de un pedido en tu sistema
- Crear un ticket en tu CRM
- Buscar disponibilidad en tu calendario
- Cualquier integración con APIs externas
Nota: Los AI Tools se configuran en la sección de herramientas del playbook y funcionan de la misma manera que en otros providers. Responses API soporta schema estricto para validación de parámetros.
4. Soporte Multimodal
El bot puede recibir y procesar múltiples tipos de archivos enviados por los clientes, sin importar el canal (Web, WhatsApp, Telegram, Facebook, etc.):
Tipo | Formatos soportados | Cómo lo procesa |
|---|---|---|
Imágenes | JPG, PNG, GIF, WebP | Análisis visual directo (el modelo "ve" la imagen) |
Documentos | PDF, DOC, DOCX, PPTX, TXT | Se suben a OpenAI como archivos adjuntos para análisis |
Hojas de cálculo | XLS, XLSX | Se suben a OpenAI para procesamiento con Code Interpreter |
CSV | CSV | Se envía como texto inline para análisis directo |
Audio | MP3, WAV, OGG, AAC, AMR | Transcripción automática vía Whisper, luego se procesa el texto |
¿Cómo funciona el audio?
Cuando un cliente envía un mensaje de voz o audio:
- El audio se descarga automáticamente
- Se transcribe usando OpenAI Whisper
- La transcripción se envía al modelo como texto
- El bot responde en base al contenido del audio
Esto funciona en todos los canales que soportan audio, incluyendo WhatsApp (notas de voz) y Telegram.
5. Variables en el System Prompt (Custom Assignments)
Las variables permiten que el bot extraiga información estructurada de la conversación de forma automática. Se configuran en la sección Custom Assignments del skill LLM.
Modo Estructurado (Array)
Definí cada variable con su nombre y descripción, una por línea:
nombre_cliente: nombre completo del cliente
monto_compra: monto en dólares que desea gastar
producto_interes: producto por el cual consulta
motivo_contacto: razón principal del contactoEl bot extraerá estos valores a medida que el cliente los mencione en la conversación. El resultado es un JSON con cada variable y su valor:
[
{"nombre_cliente": "Juan Pérez"},
{"monto_compra": "500"},
{"producto_interes": "laptop"},
{"motivo_contacto": "compra nueva"}
]Modo Texto Libre
Si preferís dar instrucciones en lenguaje natural:
Extrae el nombre del cliente, su email y número de teléfono de la conversación.
Si menciona un producto específico, extrae también el nombre del producto.El bot retornará pares {key, value} genéricos con los datos extraídos.
¿Cómo se usan las variables?
Las variables extraídas se guardan automáticamente en la memoria del playbook. Podés usarlas en:
- Otros skills del mismo playbook con la sintaxis {{nombre_variable}}
- Notas privadas: /private El cliente {{nombre_cliente}} consultó por {{producto_interes}}
- Mensajes de derivación o cierre
6. Tags Personalizados (Custom Tags)
Los tags permiten que el bot clasifique automáticamente las conversaciones agregando o quitando etiquetas.
Cómo configurarlos
En la sección Custom Tags del skill LLM, definí los tags y cuándo deben aplicarse:
venta: agregar si el cliente muestra intención de compra
soporte: agregar si el cliente reporta un problema
urgente: agregar si el cliente expresa urgencia o frustración
resuelto: agregar si la consulta fue resuelta satisfactoriamenteAcciones posibles
Para cada tag, el bot puede ejecutar dos acciones:
- add: Agregar el tag a la conversación
- remove: Quitar el tag de la conversación
Casos de uso
- Segmentar conversaciones por tipo (venta, soporte, reclamo)
- Marcar intenciones del cliente para seguimiento
- Priorizar tickets automáticamente
- Alimentar reportes y métricas
7. Comando /private - Notas Privadas
El bot puede generar notas internas que no se envían al cliente. Estas notas se insertan como eventos privados en el ticket, visibles solo para los agentes.
Cómo funciona
Cuando el bot genera una respuesta que comienza con /private, el texto que sigue se guarda como nota privada en lugar de enviarse al cliente.
Ejemplo en el system prompt:
Después de cada interacción, generá una nota privada con el resumen.
Formato: /private Resumen: el cliente {{nombre_cliente}} consultó por {{producto_interes}}.
Estado: {{motivo_contacto}}.Soporte de variables
Las notas privadas soportan variables de memoria con la sintaxis {{variable}}. Las variables se reemplazan automáticamente con los valores almacenados en la memoria del playbook.
Casos de uso
- Logging interno: Registrar información relevante para el equipo
- Resumen de conversación: Generar un brief automático cuando se transfiere a un agente
- Alertas internas: Marcar situaciones que requieren atención especial
- Datos extraídos: Documentar los datos que el bot capturó durante la conversación
8. Mensajes de Seguimiento (Follow-up)
Cuando la respuesta de OpenAI tarda más de lo habitual (por ejemplo, al usar Web Search, Code Interpreter o File Search), el bot envía mensajes de espera automáticos para mantener al cliente informado.
Tiempos de envío
Tiempo transcurrido | Acción |
|---|---|
20 segundos | Envía primer mensaje de espera |
50 segundos | Envía segundo mensaje de seguimiento |
100 segundos | Envía tercer mensaje |
140 segundos | Envía cuarto mensaje |
Características
- 3 idiomas disponibles: Español, inglés y portugués (20 frases por idioma)
- Selección aleatoria: Las frases se eligen al azar de un pool para no repetirse
- Multi-canal: Se envían por el mismo canal que usa el cliente (Web, WhatsApp, Telegram, etc.)
- Cancelación automática: Los mensajes programados se cancelan cuando llega la respuesta de OpenAI
- Detección de idioma: El idioma se selecciona según la configuración del playbook
Ejemplos de mensajes (español):
- "Un momento por favor..."
- "Estoy procesando tu consulta..."
- "Ya casi tengo tu respuesta..."
- "Estoy buscando la mejor respuesta..."
9. Timeout Extendido a 3 Minutos
Responses API tiene un timeout de 180 segundos (3 minutos), significativamente mayor que los 30-60 segundos típicos de otros providers.
¿Por qué un timeout más largo?
Las herramientas builtin pueden requerir tiempo adicional:
- Code Interpreter: Ejecutar código Python, procesar archivos grandes
- File Search: Buscar en documentos extensos del Knowledge Base
- Web Search: Consultar múltiples fuentes en internet
- Image Generation: Generar imágenes a partir de texto
¿Qué pasa si se excede el timeout?
Si OpenAI no responde dentro de los 3 minutos, se genera un error claro y el bot no queda colgado. Mientras tanto, los mensajes de seguimientomensajes de seguimiento mantienen al cliente informado durante la espera.
10. Debounce Inteligente
Cuando un cliente envía varios mensajes seguidos rápidamente (algo muy común en WhatsApp), el sistema acumula todos los mensajes antes de enviarlos a OpenAI.
Cómo funciona
- El cliente envía un mensaje
- El sistema espera 2 segundos por si llegan más mensajes
- Si llega otro mensaje dentro de esos 2 segundos, reinicia el timer
- Cuando pasan 2 segundos sin mensajes nuevos, envía todo junto a OpenAI
- Si ya había un request en vuelo a OpenAI, lo cancela y reenvía todo junto
Beneficios
- Ahorro de tokens: En lugar de hacer 3 llamadas separadas, hace una sola con los 3 mensajes combinados
- Mejores respuestas: El bot ve el contexto completo del cliente antes de responder
- Menor costo: Menos llamadas a la API = menor gasto
Ejemplo:
Cliente (18:30:01): "Hola" Cliente (18:30:02): "Quería consultar por un producto" Cliente (18:30:03): "Es una laptop Dell"
(El bot recibe los 3 mensajes juntos y responde una sola vez de forma coherente)
11. Preguntas Frecuentes
¿Puedo usar Responses API y Assistants en paralelo?
Sí. Podés tener bots con diferentes providers activos al mismo tiempo. Cada bot usa su propio provider de forma independiente.
¿Los archivos de mi Knowledge Base se mantienen al cambiar de provider?
Los archivos fuente se mantienen en AsisteClick, pero necesitás hacer clic en Regenerar para crear un nuevo Vector Store compatible con Responses API.
¿Funciona con todos los canales?
Sí. Responses API funciona con todos los canales soportados por AsisteClick: Web, WhatsApp, Telegram, Facebook Messenger, Instagram y más.
¿Cómo veo el costo de cada consulta?
El costo se calcula automáticamente en base a los tokens de input y output usando las tarifas de cada modelo. Podés ver el detalle en los reportes de consumo de tu cuenta.
¿Las herramientas builtin tienen costo adicional?
Sí. Web Search, Code Interpreter e Image Generation pueden generar costos adicionales según el uso. Estos costos los cobra OpenAI directamente sobre tu API Key.
12. Migración desde OpenAI Assistants
¿Por qué migrar?
- Assistants API dejará de funcionar después del 26 de agosto de 2026
- Responses API ofrece modelos más nuevos (familia GPT-5), herramientas más potentes y menor costo
- Las herramientas Web Search, Code Interpreter e Image Generation se activan automáticamente
Pasos para migrar
Paso 1: Clonar el bot existente
Antes de modificar el bot en producción, cloná el bot actual usando el botón Clonar en la configuración del bot. Esto te permite hacer pruebas sin afectar al bot activo.
Paso 2: Cambiar el Provider
En el bot clonado, cambiá el provider a "OpenAI Responses API (Beta)" en el selector de provider.
Paso 3: Seleccionar el modelo equivalente
Los modelos de Assistants (como GPT-4o) no están disponibles en Responses API. Elegí un modelo equivalente de la familia GPT-5:
Modelo Assistants | Modelo Responses API recomendado |
|---|---|
GPT-4o | GPT-5-mini (mejor y más barato) |
GPT-4o-mini | GPT-5-nano (más barato) o GPT-5-mini (mejor calidad) |
Paso 4: Regenerar el Knowledge Base
Si tu bot usaba Knowledge Base con Assistants, necesitás crear un nuevo Vector Store:
- Hacé clic en el botón Regenerar (ícono de recarga junto al selector de provider)
- Esperá a que se complete el proceso ("Creating Vector Store")
- El sistema creará un nuevo Vector Store y eliminará el anterior automáticamente
[SCREENSHOT: botón de regenerar junto al selector de provider]
Paso 5: Adaptar el System Prompt
El system prompt funciona de la misma manera, pero podés aprovechar las nuevas capacidades:
- Configurá Custom Assignments para extraer variables automáticamente
- Usá /private para generar notas internas
- Revisá y ajustá las instrucciones si es necesario
Paso 6: QA - Probar antes de activar
Probá el bot clonado en un canal de prueba:
- Verificá que responda correctamente a las consultas habituales
- Probá el Knowledge Base con preguntas que requieran buscar en documentos
- Verificá que los AI Tools (function calling) funcionen correctamente
- Probá el envío de archivos, imágenes y audio
Paso 7: Switch a producción
Una vez que estés conforme con las pruebas:
- Cambiá el bot default en los canales de producción al bot clonado
- Monitoreá las primeras conversaciones para confirmar que todo funcione
Diferencias clave a tener en cuenta
Aspecto | Assistants API | Responses API |
|---|---|---|
Web Search | No incluida | Siempre activa, automática |
Code Interpreter | Requería configuración | Siempre activo, automático |
Image Generation | No incluida | Siempre activa, automática |
AI Tools / Function Calling | Funciona igual | Funciona igual, sin cambios necesarios |
Knowledge Base | Vector Store del Assistant | Nuevo Vector Store (requiere Regenerar) |
Timeout | ~30-60 segundos | 180 segundos (3 minutos) |
Debounce | No incluido | Automático (2 segundos) |
Mensajes de seguimiento | No incluidos | Automáticos (20s, 50s, 100s, 140s) |
Modelos | GPT-4o, GPT-4o-mini | GPT-5.2, GPT-5, GPT-5-mini, GPT-5-nano, GPT-4.1, GPT-4.1-mini |