Ir al contenido
Documentación de Connecto
connecto.lat
Guía de usuarioConfiguración general e IA

Configuración IA

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).
Privacidad. Cuando la IA analiza una conversación o un correo, el texto se envía al proveedor de IA que configuraste. Informa a tus contactos sobre este tratamiento y cumple la normativa de protección de datos personales que te aplique.

La pantalla en cuatro tarjetas#

  1. Proveedor de inteligencia artificial (con el consumo del mes).
  2. Análisis de metadatos con IA.
  3. Análisis de correo electrónico entrante con IA.
  4. 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#

CampoQué haceValores
ProveedorServicio de IA que usarásAnthropic (Claude), OpenAI o Google (Gemini)
ModeloNombre exacto del modelo. Puedes elegir uno sugerido o escribir el que ofrezca tu proveedorLetras, números y los símbolos . _ : / -. Máximo 120 caracteres
API keyLa clave que te dio el proveedorEntre 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 costoNúmeros mayores o iguales a 0. Debes llenar los dos o ninguno

Modelos sugeridos por proveedor (son solo sugerencias):

ProveedorSugeridos
Anthropic (Claude)claude-sonnet-5, claude-haiku-4-5-20251001, claude-opus-5-5
OpenAIgpt-4o, gpt-4o-mini
Google (Gemini)gemini-3.8-flash, gemini-flash-latest, gemini-3.1-pro-preview

Paso a paso: conectar la IA#

  1. Activa el módulo en Configuración general → Preferencias (si no está activo).
  2. Entra a Configuración IA.
  3. Elige el Proveedor.
  4. Escribe o elige el Modelo.
  5. Pega la API key.
  6. (Opcional) Escribe el precio por millón de tokens de Entrada y Salida.
  7. Haz clic en Guardar. Aparece «Configuración de IA guardada.».
  8. 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ónQué hace
Editar conexiónAbre el formulario para cambiar proveedor, modelo, clave o precios. Con Cancelar se vuelve a cerrar
Probar conexiónConsulta el modelo en el proveedor. No genera texto, así que no consume tokens
Quitar credencialesBorra 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»:

MensajeSignificado
«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):

IndicadorQué muestra
PeticionesCuántas veces se le pidió algo a la IA en el mes
Tipo de peticionesDesglose por tipo: Resumen de conversación, Análisis de metadatos, Clasificación de correo, Asistencia, Análisis de sentimiento y quejas
Tokens consumidosTotal, y debajo «Entrada» y «Salida»
Costo (estimado)Costo estimado en dólares (US$) y el promedio por petición
Consumo por díaGrá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 modeloEntradaSalida
gpt-4o-mini0,150,60
gpt-4o2,5010,00
haiku1,005,00
opus5,0025,00
sonnet3,0015,00
flash0,302,50
pro1,2510,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.».
El costo es solo una estimación; la factura real la emite tu proveedor. Los precios de referencia pueden quedar desactualizados: usa tus precios si quieres más exactitud.

2. Análisis de metadatos con IA#

AspectoDetalle
InterruptorUtilizar la inteligencia artificial para analizar la obtención de metadatos
Por defectoApagado
RequisitoLa 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 activarloEl contenido de las conversaciones podrá ser procesado por el proveedor configurado, únicamente para identificar los metadatos que definiste
Prompt de análisisCon 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
Sin verificar: el momento y la forma en que la IA asigna los metadatos a un contacto. El código muestra el interruptor, guarda el criterio de cada metadato y registra el origen «Asistente de IA» en la trazabilidad, pero no se encontró en esta revisión el proceso que realiza el análisis automático.

3. Análisis de correo electrónico entrante con IA#

AspectoDetalle
InterruptorUtilizar la inteligencia artificial para clasificar los correos entrantes
Por defectoApagado
RequisitosIA 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:

  1. Cada correo nuevo se lee del buzón una sola vez.
  2. Si el remitente es un contacto, la IA lo asigna a la bandeja cuyo prompt de clasificación coincida.
  3. Si el análisis con IA está desactivado, se usan las palabras clave de cada bandeja.
  4. 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).
El texto con el que se le pide el resumen a la IA está redactado para una empresa que vende cursos (habla de «cursos», «programas» y estado de la oportunidad). En otros negocios el resumen puede salir con ese enfoque.

Límites y valores por defecto#

ElementoLímite o valor por defecto
Módulo de IAApagado
Análisis de metadatosApagado
Análisis de correoApagado
Análisis de sentimiento y quejasApagado; tope de 50 conversaciones por día (de 1 a 5000)
Resumen de conversacionesAutomático con el módulo activo y la IA configurada. No tiene tope diario
Tiempo de espera de una petición a la IA90 segundos
Longitud máxima de respuesta pedida a la IA4096 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.

¿Te fue útil esta página?
Última actualización: 14/11/2026