Clientes
Manual de uso · Superadmin

Clientes

El módulo donde se crean y administran las organizaciones que usan SIAC: su marca, sus límites de consumo, su forma de pago y qué módulos tienen habilitados. Solo lo ven los superadmins de la plataforma.

Identidad corporativaLímitesFacturación
Clientes
AC
Acme Corp
acme-corp
● Activo
Usuarios
24
Consumo
$62.10
Peticiones
1,204
Prepago Saldo $84.20
Cada cliente es una tarjeta: marca, uso, saldo — todo de un vistazo.
← Centro de manuales

Qué es Clientes

La ficha maestra de cada organización

Cada organización (tenant) que usa SIAC tiene aquí su ficha completa: cuántos usuarios tiene, cuánto ha consumido este mes, qué tan cerca está de su límite y cómo se le cobra.

🎨

Marca propia

Logo, nombre visible y colores corporativos que se reflejan en toda la plataforma para los usuarios de ese cliente.

📊

Consumo en vivo

Usuarios activos, costo del mes y peticiones, con barra de progreso hacia su límite mensual.

💳

Modo de cobro

Postpago, prepago (con saldo) o a crédito (con cupo autorizado) — cada uno con su propia lógica de suspensión.

🖥️

Dev Studio

Activa o no el módulo de servidores propios, con su margen de infraestructura y límites de entornos.

Crear un cliente

Un formulario, cuatro secciones

Pulsa + Nuevo cliente. El formulario está organizado en secciones claras: identidad corporativa, datos comerciales, límites y facturación, cobro y seguridad, y Dev Studio.

El slug (identificador único, ej. acme-corp) no se puede cambiar después de crear el cliente.

Identidad corporativa

Que la plataforma se vea como del cliente

Sube el logo (PNG, JPEG, SVG o WebP, máx. 2MB), define un nombre visible (si es distinto al nombre comercial) y elige color primario y secundario. Una vista previa en vivo muestra cómo se verá la barra de marca antes de guardar.

Estos mismos colores y logo se usan también al instalar soluciones (como Chatwoot) en el Dev Studio del cliente: todo queda con su marca.

Límites y facturación

Cuánto puede consumir y a qué precio
  • Límite de costo mensual — tope en USD (0 = ilimitado).
  • Quota de tokens/mes y máximo de usuarios — topes adicionales opcionales.
  • Precio mensual — lo que se le cobra al cliente por el servicio.
  • Retención de datos — cuántos días se conservan sus registros.
  • Margen por defecto — el porcentaje que se suma al costo base de cada modelo (ajustable por modelo en Precios).
  • Mostrar costo de sesión en complementos M365 — si el usuario ve el gasto en vivo dentro de Excel/Word/PowerPoint.

Cobro y seguridad

Postpago, prepago o crédito — y verificación por WhatsApp
  • Postpago (sin saldo) — el cliente consume libremente, se le factura aparte.
  • Prepago — necesita saldo cargado para consumir; se le puede otorgar un saldo promocional de bienvenida automáticamente al crearlo (ver Plataforma).
  • Crédito — consume contra un cupo autorizado, se factura al vencerlo.

Define además el email y WhatsApp de facturación para notificaciones de saldo y pagos, y dos interruptores de seguridad:

  • Exigir código WhatsApp en acciones sensibles — cambio de contraseña y datos de facturación piden un código OTP.
  • Exigir código WhatsApp al iniciar sesión — segundo factor en cada login.

Dev Studio del cliente

Servidores propios, con su propio margen

Activa Habilitar Dev Studio para que el cliente pueda crear servidores en la nube, programar con IA y publicar aplicaciones. Configúrale un margen de infraestructura propio (si no, usa el margen por defecto), un límite mensual de infraestructura y un máximo de entornos simultáneos.

La IA de una instancia

Con su cuenta o con la nuestra: los clientes no son iguales

Un cliente con servidor dedicado puede consumir IA de dos formas, y la ficha de su instancia dice cuál:

  • Con su propia cuenta — el cliente trae su cuenta de Huawei MaaS y paga sus tokens directamente al proveedor. Su clave viaja sola cuando se migran sus datos: no hay nada que configurar.
  • Subsidiada, con la nuestra — el cliente usa la cuenta de SIAC y SIAC le factura el consumo. Para esto la plataforma le emite una credencial propia: su servidor consume a través de SIAC, y cada token queda atribuido a ese cliente.

Lo que decide cuál es cada cliente es su modo de cuenta Huawei, en su ficha de cliente. No hay que declararlo dos veces.

La llave de SIAC nunca sale de la plataforma. Lo que se le entrega al servidor del cliente es una credencial suya, revocable, con sus mismos permisos de modelos. Si se filtrara, lo que consuma se le factura a él y se corta con un botón.

Activar o rotar. En la ficha de la instancia, el bloque IA muestra si ya tiene credencial. Activar IA la emite y la aplica; Rotar credencial emite una nueva e invalida la anterior. En los dos casos el servidor se recarga y queda unos segundos sin atender.

Una instancia subsidiada con su credencial emitida pasa sola a activa en el siguiente latido: ya no espera a que nadie configure nada.

Actualizar una instancia

El botón dice en qué paso va, y avisa cuando termina

En la ficha del cliente, pestaña Despliegue, la tarjeta Actualización compara la versión de la instancia con la release estable de producción. Si va por detrás aparece Actualizar a vX, y debajo, plegado, qué trae esa versión: actualizar a ciegas es justo lo que hace que un botón no se pulse.

Al pulsarlo, la ficha se queda contigo: se refresca sola y enseña el paso en curso con su reloj — la conexión con el servidor, el acceso al registro de imágenes, la credencial de IA, la instalación de la plataforma (el paso largo), la recarga del gateway, la comprobación de salud y el examen de salida.

El examen es lo que separa «se instaló» de «funciona»: mira el dominio con su certificado desde fuera, que el panel se sirva y que los contenedores estén arriba. Una instancia puede estar sana por dentro y dar 502 por fuera — ya pasó.

  • Si algo falla, la instancia vuelve sola a su versión anterior y el intento queda con su causa, su consejo y la salida completa.
  • Si pulsas dos veces, la segunda no hace nada peligroso: responde diciendo qué está corriendo y desde cuándo.
  • Si el paso no avanza más de lo razonable, se marca como detenido. La instalación puede tardar hasta 40 minutos; el resto son segundos.
  • Cuando termina —bien o mal— llega un correo con el resultado.
Ya no hay que adivinar si la orden salió. Antes el botón respondía «iniciado» y después no había nada que mirar: un cliente llegó a estar tres días marcado «actualizando» cuando en realidad había fallado dos veces.

Cuando un estreno falla

Qué pasó, dónde, y si reintentar sirve de algo

Estrenar un servidor dedicado son siete pasos y dos de ellos tardan media hora. Si uno falla, la ficha de la instancia lo cuenta en Despliegues recientes: cada intento dice en qué paso murió, con qué causa y qué hacer. La salida completa de la instalación está debajo, plegada — solo la ve SIAC.

Los pasos, en orden:

  • la creación del servidor — se pide la máquina a la nube (3-5 min).
  • la conexión con el servidor — el servidor llama de vuelta a la plataforma.
  • la instalación de la plataforma — baja cinco imágenes y las arranca. Es el paso largo, y donde más se falla la primera vez.
  • el respaldo en la nube y el respaldo continuo — el archivado del que se restaura si algo se pierde.
  • la publicación del dominio — el subdominio y su certificado.

Las causas que el sistema reconoce, y qué significan:

  • descarga de imágenes cortada — el enlace con la región se cayó a mitad. Es transitoria: se reintenta sola hasta tres veces, y cada intento empieza más cerca porque lo ya descargado se conserva.
  • disco lleno o memoria agotada — el servidor se quedó corto. Amplíalo antes de reintentar: repetir sin cambiar nada acaba igual.
  • la release no tiene sus imágenes publicadas — la versión se marcó lista sin estarlo. Se corrige publicando, no reintentando.
  • acceso al registro de imágenes — el servidor no pudo autenticarse para descargar. Es configuración de la plataforma, no del cliente.
  • puerto ocupado — un intento anterior dejó algo vivo en el servidor.
  • falta un valor de configuración — a la instancia le falta un secreto.
Reintentar es seguro y no cuesta un servidor nuevo. Si la máquina sigue viva, el reintento la reaprovecha en vez de crear otra, y se salta lo que ya estaba hecho. Solo si el servidor está muerto se levanta uno nuevo.
Un estreno que falla ya no obliga a llamar a nadie: la ficha dice qué pasó y qué hacer. Antes decía compose up falló (rc=1), que no es información.

Diagnosticar una instancia dedicada

La pestaña Soporte: qué le pasa al servidor, sin entrar en él

En la ficha del cliente, la pestaña Soporte recoge evidencia del servidor de una instancia dedicada y la presenta ya interpretada. Es herramienta de SIAC: el cliente no la ve.

Recoger evidencia lanza doce revisiones de solo lectura a la vez: si el servidor responde, qué contenedores están vivos, si la plataforma contesta por dentro y por fuera, los registros de los cuatro servicios que suelen romperse, el disco y la memoria, y qué se intentó la última vez. Arriba sale el veredicto —la causa probable y qué hacer—; debajo, cada revisión por separado para poder desconfiar de la etiqueta.

Nada de esto se guarda: la evidencia se muestra y se descarta. Lo que perdura es lo que ya guardaba cada intento de despliegue.

Las acciones son una lista cerrada, con su riesgo a la vista: reintentar el arranque, reiniciar un servicio, reautenticar contra el registro de imágenes y liberar disco borrando imágenes sin usar. Ninguna borra datos ni baja la instancia, y todas piden confirmación. Lo que no está en esa lista no se puede hacer desde aquí.

Cada uso queda en la auditoría con quién lo hizo — y distingue si fue una persona o el soporte asistido por IA.

El corte al canal dedicado

Mover a un cliente de la plataforma compartida a SU servidor, con números

Cuando un cliente pasa a instancia dedicada, sus datos se migran… pero su gente sigue entrando por donde entraba. Mientras eso dure, hay dos verdades: lo que escriba en la plataforma compartida no lo verá nunca su instancia, y nadie ve un error.

La tarjeta Corte al canal dedicado (ficha del cliente → Despliegue) enseña el marcador antes de decidir. Tres condiciones, cada una con su porqué:

  • Su instancia sabe manejar Dev Studio. Las máquinas de Dev Studio viven en la plataforma, no en la instancia. Hasta que su versión sepa pedirlas prestadas, cortarle la escritura le apagaría el acceso a sus servidores.
  • La gente ya está allí. Equipos y usuarios activos en su instancia. Cortar antes deja a una empresa sin sitio donde escribir.
  • Aquí ya no se escribe. Escrituras, peticiones de IA directas, entradas y equipos que siguen latiendo en la compartida, en los últimos días.

Con el marcador en verde, Pasar a solo lectura aquí: sus usuarios siguen entrando y viendo su historial, pero al escribir reciben el enlace a su servidor; el escritorio se muda solo y los complementos avisan. Cuando pase una semana sin movimiento, Cerrar.

Sincronizar lo que falta lleva a la instancia las tablas que el censo vea vacías, sin borrar nada y sin duplicar. Las que estén a medias no se tocan: eso se decide una por una.
Deshacer siempre está disponible. Volver a la plataforma compartida no pasa por ninguna comprobación: es la marcha atrás, y tiene que funcionar justo el día en que algo salga mal.
Forzar un corte con el marcador en rojo se puede, pero exige escribir el motivo y queda registrado con quién lo firmó.

Dar de baja una instancia dedicada

El cliente vuelve a la plataforma compartida y su servidor deja de existir

Cuando una instancia dedicada deja de tener sentido —nadie la usa, o el cliente vuelve a la plataforma compartida—, la tarjeta Dar de baja la instancia (ficha del cliente → Despliegue) la desmonta entera y comprueba que no quede nada cobrando.

Antes de decidir, el marcador enseña seis condiciones, cada una con su porqué:

  • El cliente trabaja en la compartida. Si el corte lo manda a su instancia, primero hay que Deshacer el corte: borrarla lo dejaría sin sitio donde trabajar.
  • Nadie trabaja en la instancia. Escrituras, usuarios y equipos de sus reportes de los últimos días. Lo que se escribe allí no existe aquí y se va con el servidor.
  • No hay una actualización en curso.
  • No tiene redundancia contratada. Su servidor de respaldo se da de baja primero, desde su propia tarjeta.
  • Hay una copia completa de menos de 24 horas. Es lo único que queda de lo que nació en la instancia.
  • No es la instancia del anillo 0, donde se valida cada versión. Esa no se da de baja nunca.

Para confirmar hay que escribir el subdominio de la instancia y el motivo. La baja recorre seis pasos y la tarjeta enseña en cuál va: congela la instancia, revoca sus dos credenciales, quita sus dos registros DNS, derriba el servidor con su disco y su IP, comprueba en la nube que no quedó nada facturando y devuelve al cliente a la plataforma compartida.

Si un paso falla, repite la baja. Los pasos ya hechos se reconocen y se saltan: un servidor que ya no existe cuenta como derribado. La ficha dice en qué paso se detuvo y por qué.
La copia de respaldo no se borra con la baja. Se conserva 30 días y la borra una persona con el script deploy/borrar-respaldo-instancia.py, que se niega a hacerlo antes de plazo o si hay una instancia viva con ese nombre.
Si el cliente nunca fue movido a su instancia, sus usuarios no tienen que hacer nada: siguen entrando por la dirección de siempre.

Ajustar saldo manualmente

Para clientes prepago o a crédito

Desde la tarjeta del cliente, pulsa Saldo. Puedes abonar (monto positivo) o debitar (monto negativo), siempre con un motivo obligatorio.

Todo ajuste manual queda registrado de forma inmutable en el historial del cliente y en la auditoría — útil para compensaciones por incidentes.

Preguntas frecuentes

Dudas comunes
  • ¿Puedo cambiar el slug después de crear el cliente? No, es el identificador único; elígelo con cuidado.
  • ¿Qué pasa si un cliente prepago se queda sin saldo? El servicio se suspende hasta que recargue (ver Facturación).
  • ¿Los colores del cliente afectan a todos sus usuarios? Sí, se aplican a toda la experiencia de esa organización en la plataforma y en las soluciones que instale.
  • ¿Cómo veo los usuarios de un cliente? Pulsa la tarjeta para abrir su ficha detallada, con la lista completa de usuarios y su consumo individual.
🏢 Abrir Clientes ← Otros manuales