Plataforma
Manual de uso · Superadmin

Plataforma

La sala de máquinas de SIAC: tasa de cambio para recargas, promoción de bienvenida, plantillas de WhatsApp aprobadas por Meta, y el estado de salud del correo saliente (SPF, DKIM, DMARC).

Facturación globalWhatsApp (Meta)Correo saliente
Plataforma — Correo
✔SPF publicado y propagado
✔DKIM publicado y propagado
✔DMARC del subdominio
✘PTR (DNS inverso)
Diagnóstico en vivo de la entregabilidad del correo saliente.
← Centro de manuales

Qué es Plataforma

Configuración que afecta a todos los clientes

A diferencia de Clientes (que configura una organización a la vez), este módulo controla ajustes globales de toda la instancia de SIAC: cómo se calculan las recargas, qué promoción reciben los clientes nuevos, y el estado de los canales de notificación (WhatsApp y correo).

Cambios del Proveedor

Retiros de modelos sin dolor: registro → impacto → campaña → curva de extinción

Cuando el proveedor de IA anuncia que retira un modelo (o cambia precios, o publica uno nuevo), el operador lo gestiona desde esta sección en minutos. El runbook:

  1. Registrar el evento — botón «Registrar evento»: tipo, título, modelos afectados (códigos), fecha efectiva y el mapeo de reemplazos («afectado → reemplazo»). Al guardar, los modelos afectados quedan deprecados en el catálogo y salen del pool del Modelo Automático de inmediato.
  2. Revisar el impacto — el módulo calcula solo, por cliente: usuarios y consumo de 30 días de los modelos afectados y el delta de costo estimado con los precios efectivos de cada cliente (verde = baja ✓, ámbar = sube ⚠). Revísalo ANTES de avisar.
  3. Disparar la campaña — «Notificar a los afectados» envía a cada cliente su informe personalizado por correo (no una circular genérica). Es idempotente: no duplica avisos si se reintenta.
  4. Seguir la curva de extinción — el uso diario de los modelos afectados debe caer a cero antes de la fecha; tras el corte, las redirecciones del alias muestran quién sigue llamando al modelo retirado (migró de nombre pero no de configuración).

El día del retiro nadie ve un error: toda petición al modelo retirado se sirve con su reemplazo y queda etiquetada en los registros de ruteo. Si el usuario tenía permiso sobre el modelo retirado, el permiso se hereda al reemplazo automáticamente.

La política visible para clientes está en el manual del Asistente — ¿Qué pasa cuando un proveedor retira un modelo?.

Agentes de plataforma

El catálogo transversal que SIAC entrega a sus clientes

En Centro de Agentes → Agentes de plataforma vive el catálogo de SIAC: los agentes que la plataforma —no el cliente— decide entregar. Tres familias, con reglas distintas:

  • Base — van a todos los clientes y reproducen, como agentes, lo que cualquier persona ya podía hacer en la herramienta: ordenar su escritorio, redactar en Word, analizar en Excel, investigar en Chrome, consultar Power BI y resolver problemas del equipo. Un cliente nuevo nace con ellos entregados.
  • Especializados — aplican a ciertas actividades económicas. La pantalla los sugiere según la actividad de cada cliente; la entrega la confirma una persona.
  • A la medida — hechos para un cliente concreto. Nunca se entregan en masa.
Entregar no autoriza a nadie. Entregar hace que el agente exista en el cliente; quién puede usarlo lo aprueba después su administrador en la ficha del agente. Son dos niveles a propósito: colapsarlos entregaría agentes que nadie autorizó, o escondería agentes que el cliente ya está pagando.
  • Re-entregar actualiza… salvo lo que el cliente adaptó. Si un cliente editó su copia, la pantalla lo marca y la entrega no la pisa: su trabajo manda.
  • Retirar pausa, no borra. La instancia del cliente queda pausada y su historial se conserva: lo que ese agente hizo es información suya.
  • Un cliente sin administrador no recibe. El agente necesita una cuenta bajo la cual provisionar su identidad técnica; la pantalla dice el motivo en vez de callarlo.

Asumir agencias BYOC

La política que le falta a SIAC, no al cliente

Cuando un cliente conecta su cuenta Huawei propia, delega el acceso creando una agencia IAM. Para usarla, SIAC tiene que asumirla: pedir un token temporal en nombre de esa agencia. Ese permiso se evalúa en la cuenta de SIAC, no en la del cliente — y por eso hay que configurarlo aquí una vez, no cliente por cliente.

Sin él, «Validar conexión» falla con este error, que a primera vista parece del cliente:

User: ...:user:siac-obs-user is not authorized to perform: iam:tokens:assume

Política — siac-assume-agency:

{
  "Version": "1.1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "iam:tokens:assume"
      ]
    }
  ]
}

Dónde se asigna, en la consola de Huawei de la cuenta de SIAC:

  • 1. IAM → Permissions → Policies/Roles → Create Custom Policy → pestaña JSON → pega el bloque de arriba y nómbrala siac-assume-agency.
  • 2. IAM → User Groups → el grupo del usuario de infraestructura (aquel cuyas claves están en HUAWEI_ECS_AK/SK) → Authorize.
  • 3. Alcance Global services — no por proyecto: los tokens de agencia no pertenecen a ninguna región.
  • 4. Vuelve a pulsar Validar conexión en la cuenta del cliente. No hace falta redesplegar nada.
Se prefiere esta política a mano antes que el rol Agent Operator de Huawei: concede exactamente una acción en lugar de la administración de agencias completa. Si algún día se separan las credenciales de infraestructura en otro usuario IAM, hay que repetir esta autorización para el usuario nuevo — el permiso viaja con la identidad que asume, no con la agencia.
Si un cliente te escribe con este error en rojo, no le pidas que toque su agencia: no hay nada que pueda hacer de su lado. La propia validación se lo dice («no es un permiso de tu cuenta Huawei»). El arreglo está aquí.

Facturación global

Tasa de cambio y umbrales de aviso
  • Tasa USD → COP — la que se aplica a todas las recargas por Mercado Pago.
  • Umbrales de saldo bajo (%) — a qué porcentajes del saldo se disparan avisos automáticos (ej. 50,20,10).

Promoción de bienvenida

Saldo automático para clientes prepago nuevos

Define el monto en USD (0 = sin promoción) y su vigencia en días (0 = no vence). Se otorga automáticamente al crear un cliente nuevo con modo de facturación prepago.

WhatsApp (notificaciones)

Meta Cloud API, con plantillas aprobadas

Configura el token de acceso, el Phone Number ID y (opcional) el WABA ID de la línea de notificaciones de SIAC. Pulsa Sincronizar plantillas para traer el estado real de aprobación desde Meta (aprobada, en revisión o rechazada). Usa Probar WhatsApp para enviarte una plantilla de prueba y confirmar que todo funciona.

Las plantillas de WhatsApp requieren aprobación de Meta antes de poder enviarse — puede tardar horas o días la primera vez.

Correo de notificaciones

Postfix propio, con DKIM y diagnóstico en vivo

SIAC envía notificaciones desde no-reply@notificaciones.siac.com.co con su propio servidor de correo. El panel diagnostica en tiempo real:

  • SPF, DKIM y DMARC — publicados y propagados correctamente.
  • DMARC raíz — el del dominio principal siac.com.co.
  • PTR (DNS inverso) — se configura en el panel del proveedor del servidor, no aquí.
  • Puerto 25 saliente — necesario para entregar correo directamente sin relay.

Pulsa Publicar DNS en GoDaddy para crear automáticamente los registros faltantes, y Probar correo para enviarte un mensaje de prueba y revisar sus cabeceras.

Canales activos

Encender o apagar por completo

Dos interruptores globales: Notificaciones por correo y Notificaciones por WhatsApp. Desactivarlos detiene el envío de avisos automáticos (saldo bajo, pagos, bienvenida) por ese canal en toda la plataforma.

Preguntas frecuentes

Dudas comunes
  • ¿Por qué el PTR aparece en rojo? El DNS inverso se configura en el panel del proveedor del servidor (VPS), no desde aquí — es informativo.
  • ¿Qué pasa si desactivo un canal de notificaciones? Deja de enviarse a todos los clientes, no solo a uno; para excepciones por cliente usa la configuración en Clientes.
  • ¿Con qué frecuencia debo sincronizar las plantillas de WhatsApp? Cada vez que crees o cambies una plantilla en Meta Business Manager.
⚙️ Abrir Plataforma ← Otros manuales