--- title: OpenAI Responses API slug: openai-responses-api docTags: createdAt: 2026-02-15T21:08:12.121Z --- ## 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 :::BlockQuote **Nota importante**: OpenAI Assistants API será deprecada el 26 de agosto de 2026. Se recomienda configurar nuevos bots directamente con Responses API. Si ya tenés un bot con Assistants, consultá la [sección de migración](docId:) al final de este tutorial. ::: *** ## 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)"**. `` ![](https://api.archbee.com/api/optimize/1084p5usHR6NhBhJbNXtr/v8ANRrR0XBAcEKUJrDKdT_image.png) ### 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:** ```javascript 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 productos ``` ### Paso 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: 1. Subí los archivos en la sección de Knowledge Base 2. Selecciona los Knowledge Bases que quieras vincular a este bot 3. 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: 1. Hacé clic en el botón **Regenerar** (ícono de recarga junto al selector de provider) 2. 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:** :::BlockQuote **Cliente:** "¿Cuál es el tipo de cambio del dólar hoy?" **Bot:** *(busca en internet y responde con el dato actualizado)* ::: ### 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:** :::BlockQuote **Cliente:** *(sube un archivo Excel con ventas)* **Bot:** "Analicé tu archivo. Las ventas totales del mes fueron $45,230. El producto más vendido fue..." ::: ### 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:** :::BlockQuote **Cliente:** "Generame una imagen de un logo moderno para una cafetería" **Bot:** *(genera y envía la imagen)* ::: ### 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: 1. El audio se descarga automáticamente 2. Se transcribe usando OpenAI Whisper 3. La transcripción se envía al modelo como texto 4. 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: ```javascript 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 contacto ``` El 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: ```json [ {"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: ```javascript 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: ```javascript 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 satisfactoriamente ``` ### Acciones 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:** ```javascript 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 seguimiento](./#8-mensajes-de-seguimiento-follow-up) 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 1. El cliente envía un mensaje 2. El sistema espera **2 segundos** por si llegan más mensajes 3. Si llega otro mensaje dentro de esos 2 segundos, reinicia el timer 4. Cuando pasan 2 segundos sin mensajes nuevos, envía todo junto a OpenAI 5. 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:** :::BlockQuote **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 :::BlockQuote **Importante**: OpenAI Assistants API será deprecada el **26 de agosto de 2026**. Se recomienda migrar a Responses API antes de esa fecha. ::: ### ¿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: 1. Hacé clic en el botón **Regenerar** (ícono de recarga junto al selector de provider) 2. Esperá a que se complete el proceso ("Creating Vector Store") 3. 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: 1. Cambiá el bot default en los canales de producción al bot clonado 2. 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 |