Tools es el puesto de control.
Permite gestionar un cliente desde su alta hasta la supervisión de llamadas, evitando operar manualmente en múltiples sistemas.
Informe ejecutivo · Octubre 2026
Sonora Tools,
explicado con claridad.
Una visión completa de qué hace la aplicación, qué APIs utiliza, cómo funciona su backend y qué se puede simplificar para mejorar la operación de la empresa.
Centro operativoTOOLSConfigura · Ejecuta · Supervisa
Clientes
Agentes
Campañas
Métricas
01 · Resumen ejecutivo
La consola que coordina la operación
Sonora Tools no es una única API ni un backend aislado. Es una aplicación Angular que reúne en una sola interfaz seis servicios especializados.
Administración, datos, agentes, operación y soporte.
Cada una cubre una responsabilidad diferente.
sonora-soul-back es la columna vertebral.
¿Qué problema resuelve?
Sin Tools, el equipo tendría que entrar por separado en bases de datos, AWS, servicios de llamadas, almacenamiento, Retell, analítica y telefonía. Tools unifica esas operaciones y presenta al usuario una experiencia única.
02 · Funcionalidades
Qué permite hacer Sonora Tools
Las funciones se agrupan por el objetivo empresarial que resuelven, desde la configuración inicial hasta el soporte.
Administrar clientes
Alta y edición de clientes, usuarios, planes, agentes, bases y configuración operativa.
- Login y sesión
- Ficha completa del cliente
- Contratos y números
Construir agentes
Creación de prompts, configuración de comportamiento y diseño visual de conversaciones.
- Creador de agentes
- Editor de agente
- Constructor visual
Preparar datos
Importación, limpieza y transformación de CSV o Excel antes de lanzar una campaña.
- Gestor CSV
- Creador BBDD
- Validación de columnas
Ejecutar campañas
Subida de bases, prueba de llamadas, lanzamiento real y programación de horarios.
- Procesamiento de ficheros
- Llamadas de prueba
- Automatización
Gestionar agendas
Configuración de las herramientas que permiten al agente consultar huecos y crear citas.
- Servicios y trabajadores
- Disponibilidad
- Creación de citas
Medir y diagnosticar
Métricas de negocio, llamadas, insights, horarios y registros técnicos de AWS.
- Panel analítico
- Diagnóstico IA
- Logs Lambda
03 · APIs y endpoints
Las seis APIs que utiliza Tools
Selecciona una API para entender su responsabilidad, dónde participa y qué endpoints ejecuta.
API PRINCIPAL
Soul Back
Es la columna vertebral de Tools. Mantiene identidad, clientes, usuarios, agentes y estado operativo, y ofrece acceso controlado a contratos, calendarios y diagnóstico.
¿POR QUÉ EXISTE?
Centraliza la información común y evita que Tools acceda directamente a bases de datos o consolas AWS.
DÓNDE SE UTILIZA
Login, Dashboard, Clientes, Agentes, BBDD, Calendario, Diagnóstico, Logs, Contratos y números.
SI FALLA
El usuario no puede iniciar sesión ni operar clientes; gran parte de Tools queda bloqueada.
RecibeCredenciales, IDs, configuración y fechas
DevuelveSesión, clientes, estados, llamadas y logs
POST /auth/loginAutentica al operador y devuelve el token de sesión.GET /auth/validate · POST /auth/register-clientValida la sesión activa o crea una cuenta de cliente.GET /clientsLista todos los clientes que puede gestionar Tools.GET · PUT /clients/{clientKey}Consulta y actualiza la ficha, agentes, plan y bases.PUT /users/{userId}Actualiza los usuarios vinculados a un cliente.POST /clients/{clientKey}/agentsAñade un agente al cliente seleccionado./create-schedules · /enable-schedules · /disable-schedulesCrea, activa o pausa la automatización de una campaña./get-schedules-status · /delete-scheduleComprueba el estado real o elimina una programación./calls/search · /calls/agent/{agentId}Localiza llamadas y recupera el historial de un agente./diagnostics/agent/logs · /diagnostics/log-eventsEntrega trazas técnicas para investigar errores sin entrar en AWS./retell/services-and-workers · /available-slots · /create-appointmentConsulta servicios, encuentra huecos y crea citas./phone-directory · /tools/legal-agreementsGestiona números y contratos firmados.Valor empresarialUna única fuente de verdad para la operación: reduce ediciones manuales, simplifica soporte y mantiene trazabilidad por cliente.
OPERACIÓN
Sonora Dev
Es el motor que inicia las llamadas. Tools prepara la campaña; esta API realiza la prueba o la ejecución real con el cliente y el agente elegidos.
¿POR QUÉ EXISTE?
Separa y escala la ejecución telefónica sin sobrecargar el backend administrativo.
DÓNDE SE UTILIZA
Ejecutar BBDD y procesos de actualización del estado de llamadas.
SI FALLA
Tools puede configurar clientes, pero no lanzar pruebas ni campañas.
RecibeCliente, agente y datos de campaña
DevuelveEjecución y estados de las llamadas
POST /dynamic-calls-testing/{clientKey}/{agentKey}Ejecuta llamadas de prueba antes del lanzamiento.POST /dynamic-calls/{clientKey}/{agentKey}Inicia la campaña real sobre la base procesada./status-callback/{clientKey}/{agentKey}Recibe los cambios de estado comunicados por el proveedor.Valor empresarialConvierte una base de contactos y un agente configurado en una campaña real, separando pruebas y producción.
DATOS
File Processor
Recibe y prepara las bases de contactos. Para archivos grandes genera una URL temporal que permite subir directamente a almacenamiento sin sobrecargar el navegador ni otros backends.
¿POR QUÉ EXISTE?
Aísla el tratamiento pesado de CSV y permite procesarlo de forma asíncrona.
DÓNDE SE UTILIZA
Ejecutar BBDD, durante la carga previa al lanzamiento.
SI FALLA
No se pueden importar nuevas bases de contactos.
RecibeCSV y metadatos de campaña
DevuelveArchivo almacenado y procesado
POST /api/process-fileProcesa una carga directa.POST /api/process-file/presigned-uploadGenera una URL temporal para archivos grandes.PUT {presignedUrl}Sube el fichero directamente a almacenamiento S3.POST /api/process-file/complete-uploadConfirma la carga e inicia el procesamiento.Valor empresarialReduce fallos de carga, soporta ficheros grandes y desacopla el tratamiento de datos.
INTELIGENCIA
Analytics
Convierte la actividad de llamadas en información de gestión: indicadores globales, rendimiento por cliente y agente, evolución mensual e insights.
¿POR QUÉ EXISTE?
Agrega grandes volúmenes de información sin ralentizar la operación diaria.
DÓNDE SE UTILIZA
Métricas llamadas, combinada con el catálogo de Soul Back.
SI FALLA
La operación continúa, pero dirección pierde visibilidad de resultados y consumo.
RecibeCliente, fechas, ciclo y paginación
DevuelveKPIs, series, llamadas e insights
GET /analytics/global · /overviewPresenta visión global y resumen por cliente.GET /analytics/agents · /monthlyCompara agentes y muestra evolución temporal.GET /analytics/callsDevuelve el detalle paginado de llamadas.GET /analytics/call-insights · /lake-insightsExtrae patrones y conclusiones agregadas.POST /analytics/refreshSolicita actualizar la información analítica.Valor empresarialPermite evaluar rentabilidad, detectar desviaciones y comparar agentes con datos objetivos.
TELEFONÍA
Sonora Management API
Aplica la asignación técnica de números en los workspaces de Sonora Studio. Complementa el directorio operativo almacenado por Soul Back.
¿POR QUÉ EXISTE?
Aplica en Studio la configuración telefónica que Tools gestiona operativamente.
DÓNDE SE UTILIZA
Control de números, junto al directorio de Soul Back.
SI FALLA
No se pueden asignar o retirar números de los workspaces.
RecibeWorkspace, número e IDs internos
DevuelveAsignaciones telefónicas de Studio
GET /api/internal/phone-directoryConsulta el estado técnico de los números.POST /api/workspaces/{workspaceId}/phone-numbersAsigna un número a un workspace.DELETE /api/internal/workspaces/{workspaceId}/phone-numbers/{phoneId}Retira la asignación.Valor empresarialReduce discrepancias entre el número asignado al cliente y el realmente activo en Studio.
ASISTENCIA IA
OpenAI
Ayuda a redactar y transformar contenido. No almacena clientes ni ejecuta llamadas: asiste al operador mientras crea agentes, calendarios, flujos o transforma datos.
¿POR QUÉ EXISTE?
Reduce el tiempo para redactar prompts y convertir requisitos en instrucciones.
DÓNDE SE UTILIZA
Creador de agentes, Constructor visual, Calendario y Gestor CSV.
SI FALLA
La gestión básica continúa; la generación asistida deja de funcionar.
RecibeInstrucciones y contexto del operador
DevuelveTexto y configuraciones generadas
POST /v1/chat/completionsGenera prompts, conversaciones, configuración de agenda y transformaciones CSV.Mejora prioritaria: esta llamada sale actualmente del navegador. Debe pasar por un backend seguro para proteger credenciales, controlar costes y mantener auditoría.
Valor empresarialAcelera la configuración y estandariza resultados, con revisión humana y control de costes.
04 · Funcionamiento del backend
Cómo colaboran los servicios
Un ejemplo real permite entender mejor el reparto de responsabilidades: el lanzamiento y seguimiento de una campaña.
CONFIGURACIÓN
Tools + Soul Back
El operador elige cliente, agente y horario. Soul Back entrega la configuración central.
DATOS
File Processor
Recibe el CSV, lo almacena y prepara los contactos.
EJECUCIÓN
Sonora Dev
Realiza la prueba y después lanza las llamadas reales.
CONTROL
Soul + Analytics
Tools consulta estados, diagnóstico, resultados e indicadores.
Distinción importante
El portal “Documentación de APIs” no es el backend.
Es un catálogo que abre los Swagger de distintos proyectos. Tools no consume todos los proyectos mostrados allí. Del catálogo utiliza directamente sonora-soul-back, sonora-dev, file-processor y sonora-management-api; además consume Analytics y OpenAI.
05 · Simplificación y mejoras
Qué sobra y qué conviene mejorar
El análisis distingue entre código que puede retirarse con seguridad y funciones que requieren una decisión de producto.
2.300+líneas desconectadas que podrían retirarse
1,6 MBde imagen duplicada
3flujos principales que conviene consolidar
CRITERIO DEL ANÁLISIS
No todo lo duplicado debe eliminarse.
Se ha comprobado si cada elemento está conectado a una pantalla, utiliza datos reales, llama a alguna API y aporta una función distinta. “Retirar” identifica código vacío o desconectado; “consolidar” exige validar primero el uso con el equipo.
HallazgoEvidenciaImpactoDecisión
Gestión de agentes antiguaNo está importada y usa personas ficticias.Mantenimiento y confusión sin aportar operación real.Eliminar
Generador de presupuestosNo está conectado, no guarda datos y contiene precios fijos.Riesgo de precios obsoletos si alguien lo reactiva.Validar y retirar
Backup y archivos vacíosGit ya conserva historial; hay modelos sin contenido.Ruido técnico y pruebas potencialmente rotas.Eliminar
Agentes en tres pantallasCreación, edición y visual comparten el mismo dominio.Más formación, navegación y código duplicado.Unificar
Datos en tres pantallasCSV y BBDD repiten columnas, tablas y exportación.El operador debe romper el flujo de campaña.Flujo único
DEV y PROD duplicadosLas copias locales son idénticas y están en
develop.Riesgo de modificar o desplegar la copia equivocada.Un solo clonALTA SEGURIDAD
Retirar
Gestión de agentes antigua
Componente desconectado que utiliza personas y datos simulados. Ya está sustituido por Clientes, Creador y Editor.
agent-management/Resultado: menos código que mantener sin pérdida funcional visible.
Generador de presupuestos
No aparece en la aplicación, no usa API y contiene precios fijos. Confirmar primero que Comercial no prevé reactivarlo.
quote-generator/Resultado: evitar precios obsoletos y una falsa expectativa de facturación.
Archivos residuales
Backup versionado, interfaz vacía, archivo accidental y restos de un componente inexistente.
*.backup · section-selector · modelos vacíosResultado: repositorio más limpio y pruebas más fiables.
Código visual sin función
Campana sin evento, títulos inaccesibles y métodos antiguos sin uso.
Resultado: interfaz sin controles que aparenten una función inexistente.
DECISIÓN DE PRODUCTO
Consolidar
Tres herramientas de agentes
Unificar Creador, Editor y Constructor Visual en una sola área “Agentes”, manteniendo los tres modos.
Resultado: continuidad de trabajo, menos formación y menos duplicación.
Tres herramientas de datos
Crear un asistente: preparar → asociar → validar → probar → ejecutar.
Resultado: menos errores y menor tiempo de lanzamiento de campaña.
Plantillas y Compilador PRO
Medir su uso; después integrarlas en Agentes o moverlas a una zona técnica.
Resultado: el menú conserva solo tareas frecuentes.
Aplicaciones externas
Dash Nora, Leads, Horario y Nexora deben aparecer en un bloque “Aplicaciones externas”.
Resultado: queda claro qué mantiene Tools y qué pertenece a otros productos.
RIESGO EMPRESARIAL
Corregir
Separación de entornos
Producción conserva URLs /dev. Añadir una validación de pipeline que bloquee el despliegue.
Riesgo evitado: mezclar datos u operar en el entorno incorrecto.
Credenciales en navegador
Rotar la clave interna y hacer que OpenAI y Management API pasen por un backend autenticado.
Riesgo evitado: exposición, consumo no autorizado y falta de auditoría.
Dos copias DEV/PROD
Usar un solo clon, ramas y configuración por entorno.
Riesgo evitado: modificar o desplegar desde la copia equivocada.
Gobierno de APIs
Inventariar propietario, entorno, autenticación, SLA, coste, datos tratados y alertas.
Resultado: incidencias con responsable claro y cambios controlados.
06 · Hoja de ruta
Orden recomendado de actuación
Una secuencia práctica para reducir riesgo primero y mejorar después la experiencia operativa.
Proteger
Rotar claves expuestas, retirar secretos del front y bloquear URLs DEV en producción.
Limpiar
Eliminar código desconectado, duplicados y configuraciones obsoletas con pruebas de regresión.
Consolidar
Unificar los flujos de Agentes y Datos para reducir pasos, formación y mantenimiento.
Gobernar
Crear inventario vivo de APIs, propietarios, entornos, costes y trazabilidad extremo a extremo.
Conclusión
Tools tiene un valor operativo claro.
Ahora necesita simplificación y gobierno.
La plataforma cubre el ciclo completo de clientes, agentes, campañas y soporte. La prioridad no es sustituirla, sino hacerla más segura, coherente y fácil de mantener.
Volver al inicio ↑