Orquestador entre Nexudus y Central Telefónica IP

El proyecto

Desarrollamos un orquestador de integración capaz de conectar Nexudus con una central telefónica IP, permitiendo que información operativa del sistema de gestión pueda convertirse automáticamente en acciones dentro de la infraestructura de telefonía.

La solución funciona como una capa intermedia entre ambas plataformas, interpretando eventos, transformando datos y ejecutando procesos sin depender de tareas manuales.

El objetivo fue conseguir que dos sistemas originalmente independientes pudieran trabajar como parte de una misma operación.

El reto

Nexudus concentra información relacionada con clientes, membresías, espacios, usuarios y operación del negocio, mientras que la central telefónica administra extensiones, llamadas y servicios de comunicación.

El problema era que ambos sistemas funcionaban de manera aislada.

Esto podía generar procesos manuales como:

• creación o actualización de extensiones;
• asignación de servicios telefónicos;
• actualización de usuarios;
• sincronización de información;
• activación o desactivación de servicios;
• seguimiento de cambios;
• validación manual entre plataformas.

El reto consistió en construir una capa capaz de entender ambos sistemas y mantenerlos sincronizados de forma segura y controlada.

La solución

BermoLabs desarrolló un orquestador independiente ubicado entre Nexudus y la central telefónica.

Su función es recibir información desde uno de los sistemas, aplicar reglas de negocio y comunicarse con el otro mediante sus mecanismos de integración.

En lugar de conectar ambas plataformas directamente y crear una dependencia rígida, el orquestador mantiene separada la lógica de negocio de cada sistema.

Esto permite controlar qué información se intercambia, cuándo se procesa y qué debe ocurrir ante cada evento.

Arquitectura

La arquitectura puede representarse de forma sencilla:

Nexudus → Orquestador → Central Telefónica

y, cuando el proceso lo requiere:

Central Telefónica → Orquestador → Nexudus

El orquestador funciona como una capa de integración bidireccional encargada de:

• consumir APIs;
• interpretar eventos;
• transformar datos;
• aplicar reglas;
• ejecutar acciones;
• controlar estados;
• registrar resultados;
• manejar errores;
• mantener trazabilidad.

Integración con Nexudus

Nexudus actúa como una de las fuentes principales de información operativa.

El orquestador puede trabajar con datos relacionados con clientes, miembros, espacios, servicios y cambios administrativos para determinar cuándo debe ejecutarse una acción en la infraestructura telefónica.

Esto permite que determinados procesos realizados desde Nexudus tengan una consecuencia automática en otros sistemas.

Integración con la central telefónica

Del otro lado se encuentra la infraestructura de telefonía IP.

El orquestador traduce los eventos del sistema de gestión a instrucciones que puedan ser comprendidas por la central.

Dependiendo de las reglas configuradas, la solución puede intervenir en procesos relacionados con:

usuarios, extensiones, servicios, configuraciones, estados y comunicaciones.

La central continúa funcionando como sistema especializado de telefonía, mientras que el orquestador administra la lógica necesaria para integrarla con el resto del ecosistema.

Automatización

Uno de los principales objetivos fue eliminar operaciones repetitivas.

Cuando ocurre un evento relevante, el orquestador puede procesarlo automáticamente sin requerir que un operador reproduzca el mismo cambio en varias plataformas.

El flujo pasa de ser:

evento → revisión manual → acceso a otro sistema → cambio manual

a convertirse en:

evento → orquestador → validación → ejecución automática → registro.

Reglas de negocio

La solución no actúa únicamente como un transportador de información.

Entre ambos sistemas existe una capa de lógica que permite definir qué debe ocurrir ante diferentes situaciones.

Esto permite implementar condiciones, validaciones, correspondencias entre entidades y procesos específicos de la operación del cliente.

Así, la integración puede evolucionar sin modificar directamente Nexudus ni la central telefónica.

Trazabilidad

Cada integración empresarial necesita saber qué ocurrió cuando algo falla.

Por eso el orquestador contempla trazabilidad sobre las operaciones procesadas.

La arquitectura puede registrar información como:

• evento recibido;
• sistema de origen;
• acción solicitada;
• resultado;
• fecha y hora;
• respuesta del sistema destino;
• errores de comunicación;
• reintentos;
• estado final.

Esto facilita soporte, auditoría y diagnóstico.

Manejo de errores

Una integración crítica no puede asumir que todos los sistemas estarán disponibles permanentemente.

Por ello el diseño considera situaciones como:

• pérdida temporal de conectividad;
• respuestas inválidas;
• timeouts;
• credenciales vencidas;
• servicios externos no disponibles;
• inconsistencias de información.

El orquestador permite aislar estos problemas y evitar que una falla puntual comprometa toda la operación.

Seguridad

La comunicación entre sistemas se mantiene separada de las interfaces utilizadas por los usuarios finales.

Las credenciales, endpoints y reglas de integración permanecen dentro de la infraestructura del orquestador.

Esto permite aplicar controles específicos para:

autenticación, autorización, almacenamiento de credenciales, validación de solicitudes y registro de actividad.

Operación dentro de red privada

La solución puede trabajar directamente dentro de la infraestructura interna del cliente, comunicándose mediante direcciones IP privadas cuando los sistemas involucrados están disponibles en la misma red.

Esto permite integrar infraestructura local con servicios empresariales sin exponer innecesariamente componentes internos a Internet.

Una capa preparada para crecer

El valor del orquestador no termina en esta primera integración.

Una vez existe una capa central de orquestación, puede convertirse en el punto donde se conecten nuevos sistemas.

Por ejemplo:

Nexudus ↔ Orquestador ↔ Telefonía

puede evolucionar hacia:

Nexudus ↔ Orquestador ↔ Telefonía / Pagos / Accesos / CRM / Notificaciones / otros servicios

De esta manera, la empresa evita construir integraciones independientes cada vez que necesita conectar una nueva herramienta.

El resultado

El resultado es una infraestructura donde el software de gestión y la plataforma de comunicaciones pueden trabajar coordinadamente.

Procesos que anteriormente requerían intervención humana pueden convertirse en flujos automáticos, controlados y trazables.

Para BermoLabs, este proyecto representa un ejemplo claro de nuestra capacidad para trabajar con:

APIs + infraestructura local + telefonía IP + automatización + reglas de negocio + integración empresarial.

Cierre del caso

No reemplazamos los sistemas que ya funcionan. Construimos la capa que hace que trabajen juntos.