Manual de AI Support Sync

1En un minuto

Cada app interna tiene un botón con la cara de Siete. Al abrirlo, una IA atiende a la persona con el manual técnico de esa app. Si con el manual alcanza, lo resuelve ahí. Si no, arma un reporte que la persona revisa y envía. El reporte llega a PM Tech como tarea, con responsable, plazo y aviso por email.

2Cómo funciona

Las dos salidas de una conversación

Plazos según la severidad

El vencimiento sale de la severidad que propone el chat (la persona la puede corregir): urgente vence hoy, alta en 2 días, media en 5 y baja en 10. En PM Tech, el programador lo ajusta con "Elegir plazo…".

Cómo se ve una tarea

El título se entiende sin abrirla: quién · proyecto · SOP-n — título, por ejemplo Carla · Outply · SOP-123 — No carga la bandeja de respuestas. El SOP-n es el número que la persona ve en el chat y en "Mis reportes".

Lo que ve la persona en "Mis reportes"

3Uso diario, por rol

Quien usa una app

• Abre el botón de la cara, abajo a un costado, y cuenta qué pasó con sus palabras.
• Si la IA da una solución, responde "Sí, se resolvió" o "No, sigue igual".
• Si propone un reporte, lo revisa, lo corrige si hace falta ("Corregir") y lo envía.
• En "Mis reportes" sigue cada caso: número, estado, quién lo tiene y para cuándo.

El programador responsable de una app

• Recibe un email por cada reporte que necesita un programador.
• Lo trabaja como cualquier tarea en el proyecto "Soporte - <App>" de PM Tech: cambia la columna, ajusta el plazo y deja notas.
• La descripción de la tarea trae lo que contó la persona, la pantalla donde estaba y el resumen de la conversación.
• Al pasarla a Hecho, la persona lo ve como "Resuelto" en "Mis reportes".

El líder de soporte

• Recibe una copia del aviso de cada reporte de su empresa. Hoy el líder es César Granda.
• En PM Tech → Soporte apps tiene tres vistas: Reportes (urgentes primero, con filtros por severidad, tipo y app), Por usuario (quién reporta y cuánto) y Apps.
• La lista de líderes se cambia arriba de Soporte apps, con Cambiar. Es una lista: pueden ser varias personas.

Quien administra (Jaime)

• Conecta las apps nuevas y les carga el manual (sección 4).
• Mantiene los manuales al día cuando una app cambia de pantallas o mensajes (sección 5).
• Revisa que no haya reportes trabados en cola y rota claves si hace falta (sección 7).
• Decide quién es responsable de cada proyecto de soporte y quiénes son los líderes.

4Conectar una app

Lleva unos 15 minutos y se hace todo desde PM Tech, salvo pegar la clave en el backend de la app. Antes de empezar, la app tiene que tener el cambio que suma el chat: una ruta en su backend que entregue el pase y el script del widget en su frontend. El paso 4 del asistente muestra el código, listo para copiar, para FastAPI, Next.js y Express.

1. PM Tech → Soporte apps → Apps → Conectar appNombre de la app, identificador (minúsculas, números y guiones: es el app que usa el widget), el proyecto de la app en PM Tech y los dominios desde los que carga el chat (uno por línea, con https y sin ruta). Se crea su proyecto "Soporte - <App>" vinculado al de la app.
2. La clave ssk_…Se muestra una sola vez. Va en el backend de la app como SIETE_SOPORTE_KEY (en Coolify, Environment Variables del servicio del backend) y nunca en el código del navegador. Después de guardarla, "Ya la guardé".
3. El manual técnicoSi siete-soporte no tiene el manual de esa app, el asistente lo pide con la estructura que necesita la IA (sección 5). Se puede partir de la plantilla, pegar el texto o subir un .md. Sin manual no se sigue.
4. ActivaciónRedesplegar el backend de la app en Coolify. Al abrir la app con un usuario aparece el botón, y la app pasa sola a Conectada cuando pide su primer pase.
5. ProbarUna pregunta cuya respuesta esté en el manual (no crea reportes). Si quieres probar un reporte, márcalo como prueba y termina la tarea después: los avisos llegan de verdad.

5El manual técnico de cada app

Es lo que lee la IA para resolver. Vive en siete-soporte (una versión por app, con fecha y autor) y se carga desde PM Tech. Se valida la estructura, no lo que dice: eso es responsabilidad de quien lo escribe.

• Lleva un título # <Nombre de la app> — manual de soporte, al menos 300 palabras y como mucho 120.000 caracteres.
• Nunca claves, tokens ni contraseñas: el manual va tal cual al modelo. siete-soporte rechaza los que parecen secretos.
• Se actualiza en Apps → "Actualizar manual" cada vez que la app cambia de pantallas, botones o mensajes. Un manual viejo hace que la IA dé pasos que ya no existen.
• Los de AISDR, Response Manager, Outply y Marketing AI están escritos en el repo siete-soporte, carpeta manuales/. El de Outply se puso al día el 15/10, antes de cargarlo, porque la app había cambiado mucho desde el 05/10; con los de AISDR y Response Manager conviene hacer lo mismo.

6Configuración

Todo corre en Coolify. Las claves se pegan a mano y se ven una sola vez: copiarlas directo al lugar indicado, nunca a un chat ni a un documento. Después de cambiar una variable hay que redesplegar ese servicio.

siete-soporte (Coolify → AI Support Sync → siete-soporte)

PM Tech (Coolify → PM 21 Manager → Platform)

Cada app conectada

7Operación

Despliegues

• siete-soporte, PM Tech y las apps se despliegan solas con cada push a main (webhook de Coolify).
• Un cambio de variables pide Redeploy del servicio, a mano.
• siete-soporte migra la base al arrancar; si la migración falla, no levanta (el anterior sigue andando).
• AISDR: no publicar cambios visibles de lunes a viernes, de 09:00 a 12:00 (Lima).

Chequeos rápidos

• https://soporte.wearesiete.com/health → {"status":"ok"}.
• PM Tech → Soporte apps → Apps: cada app dice Conectada y cuándo pidió su último pase.
• Reportes viejos en "Recibido, enviándolo al equipo…" = algo traba el envío al PM (ver la tabla de abajo).

Qué buscar en los logs (Coolify → Runtime Logs)

Tareas frecuentes

8El widget y sus versiones

Las apps cargan una versión congelada del widget con su hash (SRI): si alguien cambiara el archivo en el servidor, el navegador no lo correría. Por eso una versión publicada nunca se edita; un cambio es una versión nueva.

Cómo publicar una versión nueva (v4)

1. En siete-soporte: copiar static/widget.v3.js a widget.v4.js, hacer el cambio y agregar la ruta y la línea en .gitattributes (sin conversión de fin de línea).
2. Probarlo con las maquetas (npx playwright test) y mirarlo en claro y oscuro antes de fijar nada.
3. Calcular el hash: openssl dgst -sha384 -binary static/widget.v4.js | openssl base64 -A, y fijarlo en tests/test_app.py.
4. Desplegar siete-soporte y comprobar que el archivo en producción da el mismo hash.
5. Un PR por app (y uno en el PM, que muestra el snippet en el asistente) con la URL y el hash nuevos.

9Seguridad

• La clave de cada app vive en su backend. El navegador sólo recibe un pase de 10 minutos para esa persona. siete-soporte guarda un hash de la clave, nunca la clave.
• La app de un reporte sale del pase, no de lo que mande el navegador. Un pase vencido, mal firmado o de larga vida no entra.
• Cada app sólo habla desde sus dominios: los que se registran al conectarla.
• El widget no ejecuta HTML de lo que escribe la persona o la IA, y lo que se teclea en él no dispara atajos de la app.
• La administración es sólo del PM, con SOPORTE_ADMIN_KEY. Las rutas de prueba no existen en producción.
• Los manuales no llevan secretos: van al modelo tal cual.
• La conversación se guarda por persona: si alguien cierra sesión y entra otra en la misma pestaña, no ve el chat anterior.

10Solución de problemas

11Estado y pendientes

Al 15/10/2026, 21:00 (Lima).

Pendientes, en orden

1. Cargar ANTHROPIC_API_KEY en siete-soporte y redesplegar.
2. AISDR: decidir su proyecto y su responsable, y conectarla como Outply (manual: manuales/aisdr.md, del 05/10: ponerlo al día antes de cargarlo).
3. En Coolify, poner las claves como "Not available during build" (sección 6).
4. Response Manager, con el OK de CASA.

12Dónde está todo

Los enlaces exactos de Coolify y del PM están en el documento interno "AI Support Sync" y en el handoff; no van acá porque esta página es pública.

13Glosario

Preparado por Ily Rivas con Claude Code para el traspaso a Jaime · 15/10/2026.