MediaWiki:Sidebar

2026-02-20T09:43:09Z

Admin:

**mainpage|mainpage-description

* Usuario
** Documentación de usuario VIVAit Call|VIVAit Call
** Documentacion de usuario VIVAit Suite|VIVAit Suite
** Documentacion de usuario VIVAit Alert|VIVAit Alert


* Administrador
** Arquitectura VIVAit|Arquitectura
** Release Notes|Release Notes
** Funcionalidades | Funcionalidades
** Portales de administración VIVAit |Portales de administración
** Preguntas frecuentes administración | Preguntas frecuentes

* Servicio técnico
** Manuales de instalación|Instalación
** Actualización|Actualización
** Manuales de operación plataforma VIVAit |Manuales de operación
** Homologación de Terminales | Terminales
** Hylafax + IAXmodem en VIVAit Call| Solución de fax para VIVAit Call
** Howtos| Howtos
** Formación| Formación
** Incidencias| Incidencias
** Base de datos| Base de datos

* Desarrollo
** APIs integracion|API's de integración
** Kit argumentarios|Desarrollo de argumentarios

* vFlow
** Manual de operación de vFlow|Operación
** Portal de administración de vFlow|Administración

* VIVAit Fax
** Documentación de usuario VIVAit Fax|Usuario
** Arquitctura VIVAit Fax|Arquitectura
** Instalación VIVAit Fax|Instalación
** Documentacion técnica|Servicio Técnico

* Proyectos en desarrollo
** Pago asistido| Pago asistido

2026-02-05T12:11:33Z

Admin: /* 'Abrir sesión */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en el orquestadores
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|800px|none|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)

'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Integración de vFlow desde Omnisuite ==

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)

/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en /etc/MDtel/vFlow/platform.ini
EJEMPLO ".INI" DE PLATAFORMA
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise /etc/MDtel/vFlow/agent_loop_01.ini
EJEMPLO ".INI" DE AGENTE
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en /etc/MDtel/vFlow/service.ini
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test

EJEMPLO ".INI" DE SERVICIO
[arch_uuids]
agent=/etc/MDtel/vFlow/agent_loop_01.ini
platform=/etc/MDtel/vFlow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name

=== Invocación ===

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"

/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

===== Abrir sesión =====

/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>

<config_arch> --> OBLIGATORIO --> ".ini" del servicio
<vflow_session_uuid> --> OBLIGATORIO --> Variable "session" almacenada en el "sessionOpen"
<question> --> OBLIGATORIO --> Texto a enviar al orquestado (p. ej Flowise) (normal, abandoned, other)

Ejemplo de respuesta JSON
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}

/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>

<config_arch> --> OBLIGATORIO --> ".ini" del servicio
<vflow_session_uuid> --> OBLIGATORIO --> Variable "session" almacenada en el "sessionOpen"
<vflow_cause> --> OPCIONAL --> (normal, abandoned, expired, other)

Ejemplo de respuesta JSON
{
"errorNum": 104,
"errorStr": "Wrong session"
}

PARA PROBAR DESDE vFlow

En /home/sat/vFlow hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow

Manual de operación de vFlow

2026-02-05T12:11:24Z

Admin: /* Para canales de voz */

== Descripción general vFlow ==

vFlow es un módulo de conexión a sistemas de inteligencia artifical para sistemas de comunicaciones unificadas, ya sean sistemas corporativos o contact center
Gracias a vFlow, las plataformas de UC dispondrán de una solución para comunicarse con sistemas IA utilizando un mismo mecanismo independientemente de la solución de inteligencia artificial que se utilice

Para proporcionar el servicio de manera completa, vFlow (en concreto el orquestador) se conectará a sistemas de inteligencia artificial (LLM) que permitirán desarrollar los agentes definidos en los orquestadores

'''Conceptos:'''
* Plataforma--> Plataforma de comunicaciones unificadas; por ejemplo Omnisuite o VIVAit Call
* Orquestador--> Plataforma agéntica de IA (por ejemplo Flowise)
* vFlowProxy--> Módulo VIVAit que conecta multiples plataformas con múltiples orquestadores
* LLM--> Modelo de lenguaje natural que usará un orquestadores
* Agente--> Cada uno de los flujos creados en el orquestadores
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|800px|none|Arquitecura de vFlow]]

Los '''módulos principales''' de vFlow son:
* vFlowProxy: Recibe las conexiones de los sistemas de comunicaciones unificadas, y conecta con los orquestadores de Inteligencia Artificial de manera segura y adaptada al tipo de servicio; el acceso a vFlow Proxy desde las plataformas se realizará mediante:
* Programa cliente: Se utiliza en el sistema de comunicaciones unificadas (actualmente VIVAit Call y Omnsisuite) para invocar a vFlow
* API REST: Alternativa al programa cliente, vFlowProxy proporciona una API REST que facilita que cualquier plataforma pueda comunicarse mediante un procedimiento estándar y documentado
* Portal de administración vFlow: Permite visualizar las interaciones realizadas y configurar el sistema
* Orquestador de IA: Herramienta de Inteligencia Artificial que permitirá la creación de aplicaciones personalizadas (agentes)

'''Otros elementos''' relevantes serán:
* Base de datos vFlow:
:* Almacena información sobre sesiones y transacciones realizadas
:* Almacena información de configuración sobre vFlow
:* Gestiona el RAG de las inteligencias artificiales a usar

== Integración de vFlow desde Omnisuite ==

=== Descripción general ===
En Omnisuite, la integración con vFlow, se realiza con el programa vFlowOmnisuite, que podrá ser invocado como ejecutable (más rápido, para debian), o como Python (más universal)

/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)

Asociado al programa existen los siguientes ficheros de configuración (.ini):

Un '''".ini" de plataforma''' Omnisuite en vFlow --> Solo contiene uuid de la plataforma; se entrega un ".ini" a modo de ejemplo en /etc/MDtel/vFlow/platform.ini
EJEMPLO ".INI" DE PLATAFORMA
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96

Un '''".ini" por agente''' en vFlow --> Solo contiene uuid del agente según su identificación en vFlow ('''NO''' en un orquestador, por ejemplo flowise); se entrega un ".ini" asociado a un agente "loop" existente en Flowise /etc/MDtel/vFlow/agent_loop_01.ini
EJEMPLO ".INI" DE AGENTE
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en /etc/MDtel/vFlow/service.ini
En cada fichero de servicio configuraremos
::* Donde está Vflow
::* Agente
::* Plataforma
::* timeout_s --> Importante, es afectado por el LLM
::* channel_text_type --> IMPORTANTE si el servicio es de texto que esté bien (vacio solo si el servicio es de texto, NO COMENTARLO)
::* environment --> production, staging, test

EJEMPLO ".INI" DE SERVICIO
[arch_uuids]
agent=/etc/MDtel/vFlow/agent_loop_01.ini
platform=/etc/MDtel/vFlow/platform.ini

[vflow]
host_port=172.25.129.242:7900
timeout_s=20
# channel_type=[voice|chat|email]
channel_type=chat
# environment=[production|staging|test]
environment=production
language=es

[omnisuite]
# channel_text_type=[chat|mail|sms|whatsup]
channel_text_type=chat
service_id=vflow_service_id
service_name=vflow_service_name

=== Invocación ===

==== Para canales de texto ====

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"

/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Obligatoriedad !! Descripción
|-
| `<config_arch>` || OBLIGATORIO || ".ini" del servicio
|-
| `<omnisuite_id>` || OBLIGATORIO || Identificativo de la interacción en Omnisuite
|-
| `<omnisuite_websiteId>` || OBLIGATORIO || Identificativo del servicio en Omnisuite (ej. website id en chat)
|-
| `<omnisuite_createdAt>` || OBLIGATORIO || Creación de la interacción
|-
| `<vflow_client_id>` || OPCIONAL || Id de cliente en Omnisuite
|-
| `<vflow_client_phone_number>` || OPCIONAL || Telf de cliente en Omnisuite
|-
| `<vflow_client_email>` || OPCIONAL || Email de cliente en Omnisuite
|-
| `<question>` || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise)
|}

Ejemplo de respuesta JSON
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}

==== Para canales de voz ====
Para canales de voz, existen comandos para "abrir sesión", "enviar texto" y "cerrar sesión"

====='Abrir sesión =====

/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>

Parámetros ( Los OPCIONALES son "" si no se envía valor):

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><omnisuite_UniqueId></code> || OBLIGATORIO || Unique_ID de asterisk de la llamada en Omnisuite
|-
| <code><vflow_client_id></code> || OPCIONAL || Id de cliente en Omnisuite
|-
| <code><vflow_client_phone_number></code> || OPCIONAL || Telf de cliente en Omnisuite
|-
| <code><vflow_client_email></code> || OPCIONAL || Email de cliente en Omnisuite
|}

Ejemplo de respuesta JSON
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}

'''El value correspondiente al key "session" deberá ser guardado en una variable para siguientes invocaciones'''

/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>

<config_arch> --> OBLIGATORIO --> ".ini" del servicio
<vflow_session_uuid> --> OBLIGATORIO --> Variable "session" almacenada en el "sessionOpen"
<question> --> OBLIGATORIO --> Texto a enviar al orquestado (p. ej Flowise) (normal, abandoned, other)

Ejemplo de respuesta JSON
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}

/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>

<config_arch> --> OBLIGATORIO --> ".ini" del servicio
<vflow_session_uuid> --> OBLIGATORIO --> Variable "session" almacenada en el "sessionOpen"
<vflow_cause> --> OPCIONAL --> (normal, abandoned, expired, other)

Ejemplo de respuesta JSON
{
"errorNum": 104,
"errorStr": "Wrong session"
}

PARA PROBAR DESDE vFlow

En /home/sat/vFlow hay scripts de prueba (se configuran en el vars.sh); para usar los scripts de prueba tendremos que tener también ".ini" en vFlow