ADAdministrador Demo

CONFIGURACIÓN DEL SISTEMA

Credenciales e integraciones

Falta clave maestra

Introduce aquí las credenciales de los servicios externos. Los secretos se cifran en el backend, se muestran como “configurado” y nunca se devuelven a la pantalla. Si un secreto ya está configurado, el campo aparecerá vacío: déjalo vacío para conservarlo.

La API no está leyendo SETTINGS_ENCRYPTION_KEY. Está en el archivo `.env` del proyecto y requiere reiniciar `pnpm dev`.

Cargando configuración…

PRUEBA CONTROLADA

Llamada real de prueba

Inicia una llamada desde tu número Twilio para verificar el flujo de voz. En una cuenta de prueba, el destinatario debe estar verificado y se aplican las limitaciones de Twilio.

Integración

Telegram

Simulado

Telegram real necesita un túnel HTTPS hacia la API en el puerto 3001. La prueba local no sale a Internet ni envía mensajes al bot.

Últimos eventos

Los eventos están persistidos en PostgreSQL.

Integración

WhatsApp Business

Simulado

Webhook y adaptador preparados. La conexión con Meta se activará en una fase posterior.

Endpoint: /v1/webhooks/whatsapp

ARQUITECTURA

Agente operativo

Preparado

El agente compartirá las reglas de la aplicación, pero cada acción queda vinculada a organización, incidencia y parte.

Cómo funcionará

Consulta: puede leer incidencias, proveedores, partes y visitas.

Acción sensible: asignar proveedores, enviar mensajes, aceptar presupuestos, cerrar incidencias o borrar datos siempre requiere confirmación.

Voz: transcripción → intención → confirmación → acción → respuesta hablada y auditoría.

Los adaptadores reales se activarán por variables de entorno en el servidor. El modo simulado seguirá disponible para pruebas.

CONTROL DEL AGENTE

Herramientas permitidas

Restringido

El agente solo podrá utilizar estas herramientas y siempre dentro de la organización, incidencia o parte correspondiente.

Consultar incidencia

Ejemplo: “¿Cuál es el estado de la fuga de agua?”

Lectura
Consultar proveedores

Ejemplo: “Busca un proveedor de fontanería activo.”

Lectura
Consultar parte

Ejemplo: “¿Cuándo está prevista la visita?”

Lectura
Crear incidencia

El agente recopila los datos y los muestra antes de guardar.

Preparación
Asignar proveedor

Nunca cambia el proveedor sin autorización explícita.

Requiere confirmación
Crear parte

Solo usa el proveedor asignado a la incidencia.

Requiere confirmación
Programar visita

Ejemplo: “Propone el jueves a las 16:30”, pero no lo confirma solo.

Requiere confirmación
Enviar comunicación

Muestra destinatario, canal y mensaje antes de enviarlo.

Requiere confirmación
Cerrar incidencia

Solicita validar que la reparación está terminada.

Requiere confirmación

Las acciones sensibles se preparan primero y se ejecutan solo tras confirmación explícita.

VOZ · SIMULACIÓN

Probar conversación de voz

Simulado

Escribe lo que diría el usuario. Esta prueba representa la transcripción; no utiliza micrófono, no inicia llamadas y no cambia datos.

Flujo futuro: audio → transcripción → intención → confirmación → herramienta → respuesta hablada → auditoría.