Instalación: servicios encendidos y apagados

Qué servicios tiene esta instalación de StockAI, cuáles están encendidos, qué se pierde con los que no, y los canales propios de tu empresa.

En esta página
  1. Qué ve cada lector
  2. Estado de la instalación
  3. Una tarjeta de servicio
  4. Un servicio apagado
  5. De dónde viene cada valor
  6. Mis canales
  7. Ejemplo: encender el asistente

Abre Instalación desde Configuración → Instalación. Tiene dos pestañas que responden a dos personas distintas:

Esta instalación
De quien opera el servidor: las credenciales de correo, WhatsApp, IA, pagos, etc. No la abre el rol administrador de una empresa sino las direcciones que el servidor nombra en INSTANCE_ADMIN_EMAILS. (Si en el servidor hay una sola empresa y nadie está nombrado, su administrador opera la instalación mientras siga siendo la única; la pantalla lo avisa.)
Mis canales
De tu empresa: su propio remitente de correo y su propio número de WhatsApp. Lo configura cualquier administrador de la empresa.

Qué ve cada lector

  • Analista o solo lectura: la fila no aparece en Configuración, y la dirección muestra «Esta cuenta no opera la instalación».
  • Administrador que no opera la instalación: entra directo a Mis canales, con una línea que explica por qué; la pestaña Esta instalación muestra «Esta cuenta no opera la instalación». Si el servidor no nombra a nadie, verás «Esta instalación no tiene operador».
  • Operador de la instalación: ambas pestañas, editables. La cuenta de demostración de estas capturas es operadora.

Estado de la instalación

Pestaña Esta instalación con la tarjeta Estado de la instalación, sus indicadores, la latencia por familia de rutas y el aviso de la llave de cifrado generada

Arriba, un resumen de salud con «Actualizar»: cola de trabajos, trabajos en curso, latido del worker, conexiones a la base, disco de storage, disco de respaldos, último respaldo y latencia, cada uno Listo, Sin configurar o Con problemas. Si alguno se sale de su umbral, el título lo dice («Hay algo fuera de su umbral»). Debajo: trabajos en cola y en ejecución, fallidos en 24 horas, consultas lentas y la latencia por familia de rutas (de este proceso, últimos 15 minutos).

Pueden aparecer avisos: la llave de cifrado generada por la propia instalación (respalda esa carpeta), que no se puede guardar ningún secreto, que la configuración guardada no se pudo leer, el acceso de operador «por ser la única empresa» o ajustes sin documentar.

Una tarjeta de servicio

Tarjeta del servicio Correo con su estado Listo, el botón Probar conexión y los campos RESEND_API_KEY, EMAIL_FROM y SMTP

Cada servicio (Núcleo, Asistente, Correo, WhatsApp, SMS, Búsqueda en documentos, Cifrado de secretos, Contacto comercial, Pago en línea, inicio de sesión con Google/Microsoft/Apple, Ventas por correo, inicio de sesión de empresa, Worker, Techos de tamaño, Bases de datos de clientes, IA propia de cada empresa, Modo solo-API, Operación) tiene:

Estado
Listo, Encendido, Sin configurar, Apagado o Con problemas (configurado pero fallando: por ejemplo una llave revocada en el proveedor).
Probar conexión
Comprueba la credencial contra el proveedor y dice el resultado: responde correctamente, rechazó la credencial, no se pudo alcanzar, no respondió a tiempo…
Cada variable
Su nombre, si es Obligatoria, si es Solo entorno (se cambia en el archivo .env y requiere reiniciar; el panel la muestra pero no la escribe), y Manda: de dónde sale el valor que rige (de este panel, del entorno, de tu empresa o valor por defecto).
Secretos
Nunca se muestran: el campo está vacío y debajo dice «Guardada · ••••abcd» o «Sin guardar». Escribir reemplaza; dejarlo vacío y guardar vuelve al valor del entorno.
Guardar / Volver al entorno
Guardar aplica sin reiniciar. Volver al entorno borra lo que el panel guardó para ese servicio (pide confirmación).

Un servicio apagado

Tarjeta Pago en línea (Stripe y PayPal) Sin configurar con el recuadro de lo que se pierde y la lista de variables que faltan

Un servicio sin su credencial no es un error: está apagado y lo dice. El recuadro amarillo explica qué se pierde mientras siga así y Falta: nombra las variables (con «o bien» cuando hay dos caminos, como Stripe o PayPal).

De dónde viene cada valor

Cada campo dice qué valor está mandando («Manda»): de tu empresa, de este panel, del entorno (el archivo .env del servidor) o el valor por defecto. Lo que se guarda en el panel gana sobre el archivo y toma efecto sin reiniciar.

  • Los campos «Solo entorno» se muestran pero no se editan: el servidor los lee al arrancar.
  • Una llave guardada no se vuelve a mostrar; como mucho ves sus últimos cuatro caracteres, para reconocer cuál pegaste.
  • «Volver al entorno» borra lo que el panel guardó para ese servicio y deja mandando otra vez el archivo del servidor.

Mis canales

Pestaña Mis canales con las tarjetas Correo, WhatsApp y SMS de la empresa

Los canales que llevan la identidad de tu empresa a tu propia gente y a tus proveedores: tu remitente de correo y tu número de WhatsApp o SMS. Lo que dejes vacío usa lo que tenga la instalación («La usa la instalación. Deja esto vacío para seguir usándola»). La verificación de correo, el reseteo de contraseña y las invitaciones siempre salen por el correo de la instalación.

Ejemplo: encender el asistente

  1. En «Esta instalación», busca la tarjeta «Asistente (DeepSeek)».
  2. Si dice «Sin configurar», la tarjeta nombra la variable que falta: DEEPSEEK_API_KEY.
  3. Pega la llave y pulsa «Guardar».
  4. Pulsa «Probar conexión»: tiene que decir «Responde correctamente.»
  5. Abre el asistente: el aviso de «no disponible» ya no está.