Los capítulos anteriores suponen una instalación que ya existe. Este es para quien instala la plataforma en su propia infraestructura: una agencia que quiere sus datos en su cuenta de AWS, o una empresa que no puede usar una instalación compartida.
Lo primero que hay que saber es que una instalación propia se configura casi toda fuera del admin: en un archivo de configuración, en un secreto de AWS y en tu proveedor de identidad. Las pantallas de administración del sistema muestran el estado de la instalación, pero casi nunca lo cambian.
El instalador
aiaccelerator es la herramienta de línea de comandos que instala y actualiza los productos de la plataforma: la plataforma completa, el ejecutor local, el Voice Edge y el kit de administración. Descarga cada versión desde el admin de tu proveedor, verifica la firma del paquete y la integridad de cada archivo, y recién entonces ejecuta el instalador de ese producto.
Para la plataforma completa necesitás:
- Una máquina con Node 22, AWS CLI v2 y Docker en ejecución: las imágenes pasan por esa máquina.
- Una cuenta de AWS con permisos de administración, un dominio y dos certificados emitidos en AWS: uno para el dominio, en us-east-1, y otro para
runtime.<dominio>, en la región de la instalación. - Un cliente OIDC en tu proveedor de identidad, con la redirección
https://<dominio>/admin/auth/callback. - De tu proveedor de la plataforma: los datos de la licencia, la dirección de su admin y la autorización para descargar las imágenes.
La primera instalación es guiada: genera las claves, arma la configuración, revisa los requisitos, prepara la cuenta, muestra los cambios y despliega. El despliegue tarda entre 30 y 60 minutos. Al final indica los dos registros DNS que hay que crear.
Qué queda fuera del admin
| Dónde | Qué guarda |
|---|---|
customer.json | Región, dominio, red y base de datos (crear o usar existentes), proveedor de identidad, perfil basic o resilient, tamaño del servidor y variables de entorno |
| Secreto de la aplicación en AWS | Cuatro claves internas que generás vos y los tres datos de la licencia |
| Tu proveedor de identidad | Quién puede entrar al admin |
customer.json.installed.json | La versión instalada y lo que hace falta para actualizar |
customer.json no acepta variables cuyo nombre parezca un secreto —SECRET, TOKEN, PASSWORD, API_KEY—: los secretos van en el secreto de AWS.
Guardá customer.json.installed.json. Sin ese archivo, el instalador no puede actualizar: lo trata como una instalación nueva.
El primer administrador
La primera persona que inicia sesión en una instalación nueva queda como propietaria con acceso a todo. Antes de publicar la dirección del admin, iniciá sesión vos.
Actualizar y volver atrás
aiaccelerator update platform instala una versión nueva si la versión instalada está entre las que la nueva acepta como punto de partida, y si no cambiaron la base de la infraestructura ni la imagen del almacén de vectores. Antes pide confirmar que hay un respaldo.
Durante la actualización, la plataforma entra en mantenimiento: deja de recibir pedidos, actualiza la base de datos, aplica las migraciones y despliega los servicios. Si algo se interrumpe, se queda en mantenimiento a propósito, para no servir con la base a medio migrar; el instalador tiene un comando para retomar.
Volver atrás solo es posible a una versión que la instalada declare compatible, con la misma versión de la base de datos. Las migraciones de la base no se deshacen.
La plataforma no se desinstala con el instalador: la baja es un procedimiento manual, para que nadie borre una instalación por error.
La licencia
La licencia es un token firmado por el proveedor. La plataforma la valida sin conectarse a nadie: firma, emisor y vencimiento.
- Qué habilita. Pone un techo a las funcionalidades de todos los tenants: voz, WhatsApp, Slack, marca propia, acceso por API, editor de workflows, planes, facturación y el resto (capítulo 8). Un tenant no puede tener una funcionalidad que la licencia no incluye.
- Renovación. Una vez por día, la plataforma pide al proveedor la licencia vigente. Necesita salida a internet hacia el proveedor; si falla, sigue con la que tiene.
- Período de gracia. Si la licencia lo prevé, después del vencimiento hay unos días de gracia en los que la plataforma sigue funcionando.
- Al vencer. Los servidores se detienen. Sin una licencia válida no arrancan, y si vence con la plataforma en marcha, se apagan al terminar la gracia. Para los usuarios, el widget y el admin dejan de responder.
La licencia no se carga en el admin: está en el secreto de AWS, y los servicios la leen al arrancar. Cambiarla es actualizar ese secreto.
Hoy, la renovación diaria no alcanza. Por un defecto conocido, cuando vence la licencia guardada en el secreto, los servidores se comportan como si hubiera vencido, aunque la renovación haya traído una nueva. Hasta que se corrija, actualizá el secreto con la licencia vigente antes de cada vencimiento.
Lo que muestra el admin
En Administración, solo para el super admin:
- Plataforma: el estado de la instalación, con sus servicios, versiones, perfil y componentes. Es de consulta.
- Licencia: titular, plan, funcionalidades, emisión, vencimiento y días restantes. Avisa cuando faltan 30 días o menos.

Descargas lista los productos que tu organización puede bajar. Las descargas vienen siempre del admin del proveedor: en una instalación propia esa pantalla aparece sin versiones publicadas.
Correo, dominios y cobros
- Correo. La plataforma manda correos por Amazon SES si se configuran la región y el remitente en las variables de entorno; si no, los correos solo quedan en los registros. La identidad de SES hay que verificarla en AWS.
- Un solo dominio. La instalación tiene un dominio; no se pueden sumar dominios adicionales.
- Cobros con Stripe. Hoy no se pueden configurar en una instalación propia: la clave de Stripe no está entre los secretos que acepta el instalador.
Dónde termina
- Casi todo se configura fuera del admin: archivo, secreto de AWS y proveedor de identidad.
- Sin licencia válida, la plataforma no funciona. No hay modo degradado.
- La renovación necesita salida a internet hacia el proveedor, y hoy no reemplaza la licencia del secreto: hay que actualizarlo antes de que venza.
- La pantalla de licencia no muestra el período de gracia: la etiqueta de estado queda vacía.
- Las migraciones de la base no se deshacen al volver atrás.
- Un dominio por instalación, sin cobros con Stripe.
- Si se pierde el archivo de estado de la instalación, el instalador no puede actualizar.
Para revisar
- Iniciaste sesión vos antes de publicar la dirección del admin.
customer.jsonycustomer.json.installed.jsonestán respaldados fuera de la máquina de instalación.- Hay respaldo de la base antes de cada actualización.
- La instalación tiene salida a internet hacia el proveedor para renovar la licencia.
- Alguien revisa la pantalla Licencia, tiene anotada la fecha de vencimiento y actualiza el secreto antes.
- La identidad de SES está verificada y los correos de prueba llegan.