Para qué sirve#
Conecta la cuenta de inteligencia artificial de tu organización (proveedor, modelo y API key) y reúne todo lo que la IA hace en Connecto: resúmenes de conversaciones, análisis de metadatos, clasificación de correos entrantes y análisis de sentimiento y quejas. También muestra cuánto estás consumiendo cada mes.
Quién puede usarlo y cómo llegar#
- Solo administradores.
- Avatar → Ajustes de sistema → Configuración IA (en el menú de la izquierda de Configuración).
- Solo aparece si el módulo «Análisis y asistencia IA» está activo. Si no lo está, el elemento se oculta del menú y, si se entra por la dirección directa, la pantalla dice «El módulo de Análisis y asistencia IA está desactivado.» con un enlace a Preferencias para activarlo (ver Preferencias y módulos).
La pantalla en cuatro tarjetas#
- Proveedor de inteligencia artificial (con el consumo del mes).
- Análisis de metadatos con IA.
- Análisis de correo electrónico entrante con IA.
- Análisis de sentimiento y quejas con IA (ver Análisis de sentimiento y quejas con IA).
1. Proveedor de inteligencia artificial#
El título muestra una etiqueta: Configurada (hay proveedor, modelo y API key) o Sin configurar. La API key se guarda cifrada y no vuelve a mostrarse completa.
Campos#
| Campo | Qué hace | Valores |
|---|---|---|
| Proveedor | Servicio de IA que usarás | Anthropic (Claude), OpenAI o Google (Gemini) |
| Modelo | Nombre exacto del modelo. Puedes elegir uno sugerido o escribir el que ofrezca tu proveedor | Letras, números y los símbolos . _ : / -. Máximo 120 caracteres |
| API key | La clave que te dio el proveedor | Entre 10 y 400 caracteres, sin espacios. Se muestra como «••••••••» + las últimas 4 cifras. Déjala en blanco para conservar la guardada |
| Precio por millón de tokens, en dólares (opcional) | Dos campos: Entrada y Salida. Sirve para estimar el costo | Números mayores o iguales a 0. Debes llenar los dos o ninguno |
Modelos sugeridos por proveedor (son solo sugerencias):
| Proveedor | Sugeridos |
|---|---|
| Anthropic (Claude) | claude-sonnet-5, claude-haiku-4-5-20251001, claude-opus-5-5 |
| OpenAI | gpt-4o, gpt-4o-mini |
| Google (Gemini) | gemini-3.8-flash, gemini-flash-latest, gemini-3.1-pro-preview |
Paso a paso: conectar la IA#
- Activa el módulo en Configuración general → Preferencias (si no está activo).
- Entra a Configuración IA.
- Elige el Proveedor.
- Escribe o elige el Modelo.
- Pega la API key.
- (Opcional) Escribe el precio por millón de tokens de Entrada y Salida.
- Haz clic en Guardar. Aparece «Configuración de IA guardada.».
- Haz clic en Probar conexión para confirmar que la clave y el modelo funcionan.
Una vez configurada, el formulario se oculta. Los botones son:
| Botón | Qué hace |
|---|---|
| Editar conexión | Abre el formulario para cambiar proveedor, modelo, clave o precios. Con Cancelar se vuelve a cerrar |
| Probar conexión | Consulta el modelo en el proveedor. No genera texto, así que no consume tokens |
| Quitar credenciales | Borra proveedor, modelo y clave (pide confirmar) y desactiva el análisis de metadatos y el de correo. Aparece «Se quitó la configuración de IA y se desactivó el análisis de metadatos.» |
Resultados de «Probar conexión»:
| Mensaje | Significado |
|---|---|
| «Conexión exitosa: la API key es válida y el modelo está disponible.» | Todo bien |
| «El proveedor rechazó la API key (no es válida o no tiene permisos).» | Revisa la clave |
| «El proveedor no reconoce ese modelo. Revisa el nombre.» | El modelo no existe en tu cuenta |
| «El proveedor respondió con límite de uso (429). La credencial parece válida; inténtalo más tarde.» | Cuota agotada o muchas peticiones |
| «No se pudo contactar al proveedor…» | Problema de red |
Mensajes de error al guardar: «Elige un proveedor de IA válido.», «Indica el modelo (solo letras, números y . _ : / -).», «La API key no parece válida (sin espacios, entre 10 y 400 caracteres).», «Ingresa la API key del proveedor.» y, si cambias de proveedor sin escribir la clave, «Al cambiar de proveedor debes ingresar su API key.».
Consumo del mes actual#
Cuando la IA está configurada, arriba de la tarjeta se muestra «Consumo del mes actual» (mes en curso):
| Indicador | Qué muestra |
|---|---|
| Peticiones | Cuántas veces se le pidió algo a la IA en el mes |
| Tipo de peticiones | Desglose por tipo: Resumen de conversación, Análisis de metadatos, Clasificación de correo, Asistencia, Análisis de sentimiento y quejas |
| Tokens consumidos | Total, y debajo «Entrada» y «Salida» |
| Costo (estimado) | Costo estimado en dólares (US$) y el promedio por petición |
| Consumo por día | Gráfica de barras de cada día del mes, con tres vistas: Tokens, Peticiones y Costo. Pasa el mouse por una barra para ver el detalle. Abajo indica el día de mayor consumo |
Cómo se estima el costo#
- Si escribiste los precios de Entrada y Salida, se usan esos.
- Si no, se usan precios de referencia (dólares por millón de tokens) según una palabra del nombre del modelo:
| Palabra en el modelo | Entrada | Salida |
|---|---|---|
| gpt-4o-mini | 0,15 | 0,60 |
| gpt-4o | 2,50 | 10,00 |
| haiku | 1,00 | 5,00 |
| opus | 5,00 | 25,00 |
| sonnet | 3,00 | 15,00 |
| flash | 0,30 | 2,50 |
| pro | 1,25 | 10,00 |
- Si el modelo no coincide con ninguna palabra, no hay costo y aparece: «No hay precio de referencia para este modelo: indica el precio por millón de tokens en «Editar conexión» para estimar el costo.».
2. Análisis de metadatos con IA#
| Aspecto | Detalle |
|---|---|
| Interruptor | Utilizar la inteligencia artificial para analizar la obtención de metadatos |
| Por defecto | Apagado |
| Requisito | La IA debe estar configurada (proveedor, modelo y API key); si no, el interruptor está bloqueado y aparece «Configura primero el proveedor, el modelo y la API key para poder activarlo.» |
| Al activarlo | El contenido de las conversaciones podrá ser procesado por el proveedor configurado, únicamente para identificar los metadatos que definiste |
| Prompt de análisis | Con el análisis activado, cada metadato (Configuración → Metadatos) permite escribir un criterio de análisis (hasta 4000 caracteres). Si el análisis está apagado, el criterio que ya existía se conserva pero no se puede cambiar |
3. Análisis de correo electrónico entrante con IA#
| Aspecto | Detalle |
|---|---|
| Interruptor | Utilizar la inteligencia artificial para clasificar los correos entrantes |
| Por defecto | Apagado |
| Requisitos | IA configurada y, para que se lean correos, el módulo Correo electrónico activo (Preferencias). Si el módulo de correo está apagado aparece un aviso: «El módulo de Correo electrónico está desactivado (Preferencias): no se leerán correos hasta que lo actives.» |
Cómo funciona:
- Cada correo nuevo se lee del buzón una sola vez.
- Si el remitente es un contacto, la IA lo asigna a la bandeja cuyo prompt de clasificación coincida.
- Si el análisis con IA está desactivado, se usan las palabras clave de cada bandeja.
- Si el remitente no es un contacto, el correo va directamente a la bandeja por defecto, sin gastar IA.
El contenido de los correos se envía al proveedor de IA configurado. Las bandejas y sus prompts se administran en Configuración → Correo electrónico (ver la sección de Correo).
Resumen de conversaciones con IA#
El resumen no tiene una tarjeta propia: se genera solo cuando se resuelve una conversación, siempre que el módulo de IA esté activo y la IA esté configurada.
- Se envía la conversación completa a la IA (si es muy larga, se conserva la parte más reciente, unos 60.000 caracteres) junto con el último resumen que ya exista de ese mismo contacto, para que el nuevo resumen sea el del cliente al día.
- El resumen tiene máximo 150 palabras, está en español y en texto plano.
- La primera línea siempre es «Estado de la oportunidad: …» con uno de estos estados: Nuevo, Interesado, Negociando, Listo para pagar, Ya compró, Perdido o Sin determinar (y el motivo breve entre paréntesis).
- Se guarda como nota del contacto con el título «Resumen IA · conversación #N», sin autor de usuario, para que los asesores lo vean. Si se regenera, reemplaza la nota de esa conversación.
- Se genera después de responder al asesor, así que no demora el botón «Resolver». También se genera cuando el sistema cierra una conversación automáticamente.
- Para que el asesor vea el resumen al tomar un chat, enciende «Mostrar resumen de contacto» en Sesiones de chat (solo disponible si «Vista previa de mensajes» está apagada; por defecto apagado).
Límites y valores por defecto#
| Elemento | Límite o valor por defecto |
|---|---|
| Módulo de IA | Apagado |
| Análisis de metadatos | Apagado |
| Análisis de correo | Apagado |
| Análisis de sentimiento y quejas | Apagado; tope de 50 conversaciones por día (de 1 a 5000) |
| Resumen de conversaciones | Automático con el módulo activo y la IA configurada. No tiene tope diario |
| Tiempo de espera de una petición a la IA | 90 segundos |
| Longitud máxima de respuesta pedida a la IA | 4096 tokens |
Las peticiones de IA que fallan no interrumpen el trabajo del asesor: el error solo se anota en el registro del sistema y esa conversación o correo simplemente no se analiza.
<!-- Fuente: tenant-app/public/configuracion/index.php (acciones ia_guardar, ia_quitar, ia_metadatos_toggle, ia_correo_toggle y pestaña ia), tenant-app/public/configuracion/ia_probar.php, shared/src/Core/IaProviders.php, shared/src/Core/IaUso.php, shared/src/Core/IaResumen.php, shared/src/Core/IaAnalisis.php, shared/src/Core/Secrets.php, shared/src/Core/CorreoClasificador.php, shared/src/Core/ContactMetadatos.php, tenant-app/public/api/conversations.php, tenant-app/public/internal/resumen_ia.php, db/migrations/0018_metadatos_ia.sql, db/migrations/0052_chat_resumen_enabled.sql, db/migrations/0065_modulo_ia.sql, db/migrations/0066_ia_uso.sql, db/migrations/0069_correo_clasificacion.sql -->
Presupuesto, copiloto y consumo por tipo#
En esta misma pantalla hay dos tarjetas más: el presupuesto mensual de la IA, que pone un tope de gasto y desconecta la IA al llegar al 100 %, y el copiloto del asesor, que sugiere respuestas dentro del chat. Sus consumos aparecen en «Consumo del mes actual» como tipo Asistencia.