VIVAitwiki - Contribuciones del usuario [es]

Manual de operación de vFlow

2026-03-27T06:58:45Z

Alfredo.rodriguez: /* Puesta en marcha de nodo vFlow */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <code>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333 (requiere crear credencial)
<div style="display:none;">* Record Manager --> SQLite}}</div>
* Record Manager --> MySQL (requiere crear credencial)
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|1000px|miniaturadeimagen|centro|alta loader vFlow|link=]]

 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-27T06:56:57Z

Alfredo.rodriguez: /* Puesta en marcha de nodo vFlow */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
<div style="display:none;">* Record Manager --> SQLite}}</div>
* Record Manager --> MySQL
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|1000px|miniaturadeimagen|centro|alta loader vFlow|link=]]

 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-27T06:55:56Z

Alfredo.rodriguez: /* Puesta en marcha de nodo vFlow */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
<div style="display:none;">* Record Manager --> SQLite}}</div>
* Record Manager --> MySQL
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]

 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-27T06:51:07Z

Alfredo.rodriguez: /* Puesta en marcha de nodo vFlow */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
<div style="display:none;">* Record Manager --> SQLite}}</div>
* Record Manager --> MySQL
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
[[Archivo:Alta API Loader mysql|800px|miniaturadeimagen|centro|Alta API Loader_mysql]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Archivo:Alta loader vflow.png

2026-03-27T06:49:32Z

Alfredo.rodriguez: Alfredo.rodriguez subió una nueva versión de Archivo:Alta loader vflow.png

Alta loader vflow

Archivo:Alta loader vflow.png

2026-03-27T06:48:12Z

Alfredo.rodriguez: Alfredo.rodriguez revirtió Archivo:Alta loader vflow.png a una versión anterior

Alta loader vflow

Archivo:Alta loader vflow.png

2026-03-27T06:45:02Z

Alfredo.rodriguez: Alfredo.rodriguez subió una nueva versión de Archivo:Alta loader vflow.png

Alta loader vflow

Manual de operación de vFlow

2026-03-27T06:44:31Z

Alfredo.rodriguez:

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
<div style="display:none;">* Record Manager --> SQLite}}</div>
* Record Manager --> MySQL
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]

 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-27T06:43:11Z

Alfredo.rodriguez:

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
<div style="display:none;">* Record Manager --> SQLite}}</div>
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-27T06:41:41Z

Alfredo.rodriguez:

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
{{void|* Record Manager --> SQLite}}
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Telefonía

2026-03-25T12:54:21Z

Alfredo.rodriguez:

{| class="wikitable"
|-
! '''Producto: '''!! VIVAit Call
|-
|}
<big>
[[File:mdtel_20.png|100px|center]]
 
Utilizar los enlaces siguientes para acceder a los manuales de las distintas aplicaciones de supervisión del sistema '''''VIVA'''it'' Call.
 
::[[Usuario de Vivait Call | <big>Usuario de Vivait Call</big>]] 
:::Funciones generales del usuario de '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Vivait Web Call | <big>Portal de Web Call (VWC)</big>]] 
:::Manual de la aplicación '''''Web Call''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Vivait Call Business | <big>VIVAit Call Business (VCB)</big>]] 
:::Manual de la aplicación '''''Vivait Call Business''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Vivait Call Cellular | <big>VIVAit Call Cellular (VCC)</big>]] 
:::Manual de la aplicación '''''Vivait Call Cellular''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Equipos en Vivait Web Call | <big>Equipos en Vivait Web Call</big>]] 
:::Manual de la opción '''''Equipos''''' para ''Vivait Web Call'' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Terminales | <big>Terminales Telefónicos</big>]] 
:::Manuales de los distintos hardphones disponibles en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
[[Página_principal | Volver a la Página Principal]]
 
[[Category:tecnico]]
[[Category:usuario]]
[[Category:administrador]]
[[Category:VIVAit Call]]

Telefonía

2026-03-25T12:53:34Z

Alfredo.rodriguez:

{| class="wikitable"
|-
! '''Producto: '''!! VIVAit Call
|-
|}
<big>
[[File:mdtel_20.png|100px|center]]
 
Utilizar los enlaces siguientes para acceder a los manuales de las distintas aplicaciones de supervisión del sistema '''''VIVA'''it'' Call.
 
::[[Usuario de Vivait Call | <big>Usuario de Vivait Call</big>]] 
:::Manual de la aplicación '''''Vivait Usuario''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Vivait Web Call | <big>Portal de Web Call (VWC)</big>]] 
:::Manual de la aplicación '''''Web Call''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Vivait Call Business | <big>VIVAit Call Business (VCB)</big>]] 
:::Manual de la aplicación '''''Vivait Call Business''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Vivait Call Cellular | <big>VIVAit Call Cellular (VCC)</big>]] 
:::Manual de la aplicación '''''Vivait Call Cellular''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Equipos en Vivait Web Call | <big>Equipos en Vivait Web Call</big>]] 
:::Manual de la opción '''''Equipos''''' para ''Vivait Web Call'' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Terminales | <big>Terminales Telefónicos</big>]] 
:::Manuales de los distintos hardphones disponibles en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
[[Página_principal | Volver a la Página Principal]]
 
[[Category:tecnico]]
[[Category:usuario]]
[[Category:administrador]]
[[Category:VIVAit Call]]

Telefonía

2026-03-25T12:53:05Z

Alfredo.rodriguez:

{| class="wikitable"
|-
! '''Producto: '''!! VIVAit Call
|-
|}
<big>
[[File:mdtel_20.png|100px|center]]
 
Utilizar los enlaces siguientes para acceder a los manuales de las distintas aplicaciones de supervisión del sistema '''''VIVA'''it'' Call.
 
::[[Usuario de Vivait Call | <big>Usuario de Vivait Call</big>]] 
:::Manual de la aplicación '''''Vivait Usuario''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Vivait Web Call | <big>Portal de Web Call (VWC)</big>]] 
:::Manual de la aplicación '''''Vivait Web Call''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Vivait Call Business | <big>VIVAit Call Business (VCB)</big>]] 
:::Manual de la aplicación '''''Vivait Call Business''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Vivait Call Cellular | <big>VIVAit Call Cellular (VCC)</big>]] 
:::Manual de la aplicación '''''Vivait Call Cellular''''' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Equipos en Vivait Web Call | <big>Equipos en Vivait Web Call</big>]] 
:::Manual de la opción '''''Equipos''''' para ''Vivait Web Call'' en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
::[[Terminales | <big>Terminales Telefónicos</big>]] 
:::Manuales de los distintos hardphones disponibles en el sistema '''''VIVA'''''it Call de '''''MD'''''Tel en sus distintas versiones.
 
[[Página_principal | Volver a la Página Principal]]
 
[[Category:tecnico]]
[[Category:usuario]]
[[Category:administrador]]
[[Category:VIVAit Call]]

Manual de operación de vFlow

2026-03-24T11:26:56Z

Alfredo.rodriguez: /* Ejemplos para omnisuite */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

==== Ejemplo de chat ====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

==== Ejemplo de voz ====

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:26:01Z

Alfredo.rodriguez: /* Generales */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

===== Ver configuración =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

===== Ver versión =====

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:25:21Z

Alfredo.rodriguez: /* Generales */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

'''Ver configuración'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

'''Ver versión'''

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
00.00.02
</pre>

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:24:41Z

Alfredo.rodriguez: /* Generales */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

'''Ver configuración'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

'''Ver versión'''

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite version
</pre>

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:22:40Z

Alfredo.rodriguez: /* Generales */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

'''Ver configuración'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

'''Ver versión'''

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "version"
</pre>

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:21:18Z

Alfredo.rodriguez: /* Generales */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

'''Ver configuración'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

'''Ver versión'''

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> version
</pre>

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:16:40Z

Alfredo.rodriguez: /* Generales */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
==== Generales ====

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:15:55Z

Alfredo.rodriguez: /* Ejemplos para omnisuite */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:15:31Z

Alfredo.rodriguez: /* Enviar texto */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:15:11Z

Alfredo.rodriguez: /* Cerrar 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:14:44Z

Alfredo.rodriguez: /* 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:14:35Z

Alfredo.rodriguez: /* 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:14:24Z

Alfredo.rodriguez: /* Para canales de texto */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1200px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:14:13Z

Alfredo.rodriguez: /* Generales */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1500px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1200px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:13:59Z

Alfredo.rodriguez: /* Descripción general */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1500px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1200px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:13:31Z

Alfredo.rodriguez: /* Para probar desde vFlow */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1500px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1200px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:12:57Z

Alfredo.rodriguez: /* Diagnósticos */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1500px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1200px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:12:19Z

Alfredo.rodriguez: /* Puesta en marcha de nodo vFlow */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1500px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1200px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:11:25Z

Alfredo.rodriguez: /* Puesta en marcha de nodo vFlow */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;max-width: 1000px; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
 
/etc/init.d/vFlowProxy.service stop
 
/etc/init.d/vFlowProxy.service start
 
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1500px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1200px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:10:54Z

Alfredo.rodriguez: /* Puesta en marcha de nodo vFlow */

== 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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;max-width: 1000px; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
/etc/init.d/vFlowProxy.service stop
/etc/init.d/vFlowProxy.service start
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1500px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1200px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Manual de operación de vFlow

2026-03-24T11:10:05Z

Alfredo.rodriguez: /* Invocació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 vFlow; corresponde a un par plataforma/agentflow de orquestador
* Servicio--> Cada elemento de negocio en la plataforma de CU (por ejemplo VDN)

[[Archivo:Arquitectura Vflow - v2.jpg|1000px|center|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

== Puesta en marcha de nodo vFlow ==
 

Existe un nodo vFlow en los repositorios habituales proporcionados

 

Para '''dar de alta nodo vflow en un cliente''' hay que:
* Configurar IP (por defecto la maquina va configurada por DHCP)
* Adaptar el firewall, para ello REVISAR el fichero <code>/etc/firewall/vars.sh</code>
* Certificados validos en apache
* REVISAR ficheros <code>/etc/apache2/sites-enabled/flowise.conf</code> y <code>/etc/apache2/sites-enabled/vFlow.conf</code> la variable <code>ServerName</code> (nombre valido de la maquina)
 

'''Accesos vFlow''' (se debe cambiar tras instalación):
* Usuario ssh y de SO por defecto es sat y clave a proporcionar.
* Para el portal de flowise las credenciales son usuario: vfloadmin@vflow.com clave: A proporcionar
* Para el portal de vflow las credenciales son usaurio sat y clave a proporcionar.
 

'''Accesos BBDD vFlow'''
* Para acceder a la base de datos desde el workbenck solo desde localhost (o tunel):
* BBDD Vlfow (admin) vflowadmin // clave a proporcionar
* BBDD Vlfow (no_admin) vflow // clave a proporcionar
 

'''Portal orquestador Flowise'''

ubicado en https://host.cliente.xx:4567

 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;max-width: 1000px; margin-left: 50px">
'''⚠️ ATENCION !!'''
'''Los cambios en tablas de configuración de BBDD de vFlow (orquestadores, plataformas, agentes) requieren reinicio del servicio vFlowProxy'''
</div>

 

<div style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', 'Monaco', 'Courier New', monospace;">
/etc/init.d/vFlowProxy.service status
/etc/init.d/vFlowProxy.service stop
/etc/init.d/vFlowProxy.service start
</div>

 

El fichero de configuración del demonio <cvode>vFlowProxy</code> se encuentra en <code>/etc/MDtel/vFlowProxy.conf</code>, si bien este fichero de configuración no se modificará habitualmente (los parámetros generales de configuración de vFlowProxy se encuentran en la BBDD de vFlow)
 
 

Relevante para poder '''poner en marcha un loader''':
* Subir el fichero inicial previamente a la carpeta destino según entorno (p. ej <code>/var/www/html/storages/production</code>
* Tipo de loader --> API
* Método --> GET
* URL --> (ejemplo: http://172.25.129.242/storages/test/fichero-pru.txt)
::* Existirán URL "production", "staging" y "test"
* Text Splitter: Recursive
* Qdrant --> localhost:6333
* Record Manager --> SQLite
 
Se adjunta imagen a modo de ejemplo
[[Archivo:Alta loader vflow.png|800px|miniaturadeimagen|no|alta loader vFlow|link=]]
 

== Gestión en vFlow ==
vFlow prevé la existencia de tres entornos que permita hacer una gestión segura de agentes y RAG:

* Producción
* Preproducción
* Pruebas

Para cada agente o store de RAG se podrá desplegar un entorno (producción), dos o los tres entornos

<div style="background-color: #f0fff4; border: 3px solid #c6f6d5; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
✅ '''Recomendación''' 

::En la mayoría de los casos con disponer de entorno de producción y preproducción tanto para agente como para RAG será suficiente
</div>
 
Para realizar una gestión completa en vFlow (suponiendo tres entornos y gestión de agentes y RAG), deberemos tener
 
[[Archivo:Gestión RAG.png|1000px|miniaturadeimagen|centro|Gestión RAG en vFlow|link=]]
 

'''En orquestador'''
* Crear '''tres stores''' (pro/pre/pru); en cada store:
::* En total '''tres loaders'''. Crear un loader por entorno (p.ej /pro/nombrefich).
::* Subir un primer "nombrefich"
::::* tipo texto (versión 0)
::::* el mismo para todos los entornos
::::* se sube por medios convencionales (p. ej SCP)
* Asegurar que los stores queden totalmente creados (estado "UPSERTED")
* Crear '''tres agentes''' (pro/pre/pru)
::* Asociar a stores (pro/pre/pru)
 

'''En flow'''
* Crear '''un agente'''
::* Vincularlo a los tres agentes de orquestador (pro/pre/pru)
* Crear '''un store'''
::* Vinculado a los tres stores de orquestador (pro/pre/pru)
* Crear '''un loader'''
::* Loader vinculado a agente de vflow
::* C_NAME loader coincidirá con los de orquestador (p.ej "nombrefich")
::* Subir nueva versión v1 (".txt", ".pdf", ".doc", ".docx"

== Diagnósticos ==
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/vFlowProxy/vFlowProxy.log
</pre>

::En nodo vFlowProxy
::para cualquier canal
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
nc localhost 1131
</pre>

::En nodo vFlowProxy
::Monitoriza estado del proceso vflowProxy
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"proceso": {
"nombre": "vFlowProxy",
"version": "00.00.01",
"inicio_ts": 1771315153,
"inicio_cad": "20260217 085913",
"log_alarmas_val": 8,
"log_alarma_ultimo_ts": 1771970401,
"log_alarma_ultimo_ts_cad": "20260224 230001"
},
"diagnostico": {
"gmp": {
"msj_val": 1022,
"msj_max": 1024,
"buf_val": 1024,
"buf_max": 1024,
"tarea_val": 7,
"tarea_max": 15
},
"tiempo": {
"uptime": 716665,
"uptime_dias": 8,
"uptime_horas": 7,
"uptime_minutos": 4,
"uptime_segundos": 25
},
"wws": {
"conexiones_val": 0,
"conexiones_max_periodo": 0,
"hilos_val": 4,
"hilos_max": 4,
"wsi_cad": "sesiones=0/200"
}
},
"alarmas_nivel_max": 0,
"alarmas": []
}
</pre>

Es relevante la monitorización de sesiones <code>"wsi_cad": "sesiones=0/200"</code> (usadas/máximas)
 
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
asterisk -rv | grep callsquare_name
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/agi-combined.yyyy-mm-dd.log
</pre>
::en nodo Omnisuite
::para canal voz
 
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
tail -f /var/log/xcally/routing-combined.yyyy-mm-dd.log
</pre>
::para canal voz

== Para probar desde vFlow ==

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

Es útil comenzar con
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/home/sat/vFlowProxy/vFlowGetInfo.sh
</pre>
que sin parámetros adicionales confirma el correcto estado de vFlowProxy
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"app": "vFlowProxy",
"version": "00.00.01",
"sessions_opened": 0,
"sessions_limit": 200,
"sessions_sleep_timeout_s": 3600,
"alarms": 8
}
</pre>

== 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)
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite (OPCIÓN PREFERENTE)
/usr/local/sbin/vFlowOmnisuite.py (LEGACY)
</pre>

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 <code>/etc/MDtel/vFlow/platform.ini</code>

EJEMPLO ".INI" DE PLATAFORMA
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
platform=1d111530-e22d-11f0-b0f2-5254008bef96
</pre>

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 <code>/etc/MDtel/vFlow/agent_loop_01.ini</code>

EJEMPLO ".INI" DE AGENTE
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[uuids]
agent=1a3a1020-ea1d-11f0-b4a5-5254008bef96
</pre>

Un '''".ini" por servicio''' --> Configuración de cada servicio en Omnisuite; se entrega un ".ini" a modo de ejemplo en <code>/etc/MDtel/vFlow/service.ini</code>
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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
[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
</pre>
 

La imagen siguiente muestra el esquema de relación entre orquestador/plataforma/agente/servicio en la plataforma y en vFlow

[[Archivo:Relaciones vFlow plat orq ag serv.png|800px|miniaturadeimagen|centro|Relación orquestador-plataforma-agente-servicio]]
 

=== Invocación ===
=== Generales ===

Ver configuración
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> configPrint <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

Ejemplo de respuesta

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
Configuration:
agent_arch_uuid=/etc/MDtel/vFlow/agent_fse_rapido.ini
agent_uuid=3487af28-1d14-11f1-803c-525400ef204c
platform_arch_uuid=/etc/MDtel/vFlow/platform_labomsui.ini
platform_uuid=9a54ea74-f050-11f0-bdf1-5254008bef96

vflow_host_port=labvflow.mdnova.local
vflow_timeout_s=50
vflow_environment=production
vflow_channel_type=voice
vflow_language=es

omnisuite_channel_text_type=chat
omnisuite_service_id=287
omnisuite_service_name=desarrollo
{
"errorNum": 0,
"errorCad": "OK"
}
</pre>

Ver versión

Ejemplo de respuesta JSON

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

Para canales de texto en Omnisuite existe un único Comando de invocación "omnisuiteText"
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1500px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> omnisuiteText <omnisuite_id> <omnisuite_websiteId> <omnisuite_createdAt> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email> <question>
</pre>

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

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "e926548d-fdcf-11f0-a793-525400ef204c",
"language": "es",
"response": "HOLA"
}
</pre>

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

===== Abrir sesión =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1200px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionOpen <omnisuite_UniqueId> <vflow_client_id> <vflow_client_phone_number> <vflow_client_email>
</pre>

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
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "ec73df29-f08a-11f0-a8ec-525400ef204c",
"platform_id": "146"
}
</pre>

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

===== Enviar texto =====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 700px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> textRequest <vflow_session_uuid> <question>
</pre>

Parámetros:

{| class="wikitable"
! Parámetro !! Requisito !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><question></code> || OBLIGATORIO || Texto a enviar al orquestado (p. ej. Flowise) (normal, abandoned, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 0,
"errorStr": "OK",
"session": "c6f6fad7-f6c1-11f0-a793-525400ef204c",
"language": "ES",
"response": "Cristóbal Colón."
}
</pre>

===== Cerrar sesión=====
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 800px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite <config_arch> sessionClose <vflow_session_uuid> <vflow_cause>
</pre>

Parámetros (Los OPCIONALES son "" si no se envía valor):
{| class="wikitable"
! Parámetro !! Estado !! Descripción
|-
| <code><config_arch></code> || OBLIGATORIO || ".ini" del servicio
|-
| <code><vflow_session_uuid></code> || OBLIGATORIO || Variable "session" almacenada en el "sessionOpen"
|-
| <code><vflow_cause></code> || OPCIONAL || (normal, abandoned, expired, other)
|}

Ejemplo de respuesta JSON
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 400px; margin-left: 50px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
{
"errorNum": 104,
"errorStr": "Wrong session"
}
</pre>

=== Ejemplos para omnisuite ===

'''Ejemplo de chat'''
<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_chat.ini" "omnisuiteText" "{{interaction.id}}" "{{account.id}}" "{{interaction.createdAt}}" "" "" "" "{{message.body}}" | jq -r '.response'
</pre>

'''Ejemplo de voz'''

[[Archivo:Imagen cally square.jpg|1024px|none|miniatura|Ejemplo de flujo de Cally Square]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_voice.ini" "sessionOpen" "{UNIQUEID}" "" "" "" | jq -r '.session' </pre>
::salida del comando almacenado en variable "vflow_sessionopen_response" para su posterior uso en cally square

[[Archivo:Imagen sessionopen.jpg|550px|center|miniatura|Abrir sesión en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1400px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "textRequest" "{vflow_sessionopen_response}" "{OPENAI_WHISPER_TRANSCRIPT}" | jq -r '.response'
</pre>
::la voz se ha transcrito con OpenAI, por eso se usa como parámetro {OPENAI_WHISPER_TRANSCRIPT})

[[Archivo:Imagen textrequest.jpg|550px|center|miniatura|Enviar texto en vFlow]]
 
 
 

<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; max-width: 1000px; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
/usr/local/sbin/vFlowOmnisuite "/etc/MDtel/vFlow/service_desa_voz.ini" "sessionClose" "{{vflow_sessionopen_response}}" "normal"
</pre>

[[Archivo:Imagen sessionclose.jpg|900px|center|miniatura|Cerrar sesión en vFlow]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:Omnisuite]]
[[Category:IA]]

Howto's 5.0

2026-03-18T10:47:39Z

Alfredo.rodriguez: /* Puesta en marcha SIPREC */

== <big>Guías Prácticas versión 5.0</big> ==
 
<big>Utilizar los siguientes enlaces para descargar las guías practicas, sobre las funcionalidades indicadas en cada apartado, de la versión 5.0 de '''''VIVA'''it CALL''.</big>
 
=== Conexión con Teams ===
:<big>[[:media:Conexión Teams modelo Smart.pdf| Guía práctica para la configuración de la ''Conexión con Teams'', modelo Smart]]</big>
 
=== Puesta en marcha direc ===
:<big>[[:media:Puesta en marcha direc.pdf| Guía práctica para la ''Puesta en marcha de direc'']]</big>
 
=== Puesta en marcha SIPREC ===
:<big>[[:media:Puesta en marcha SIPREC.pdf| Guía práctica para la ''Puesta en marcha de SIPREC'']]</big>
 

=== Puesta en marcha TBC ===
:<big>[[:media:Puesta en marcha TBC.pdf| Guía práctica para la ''Puesta en marcha de TBC'']]</big>
 
=== Importación masiva de usuarios ===
:<big>[[:media:importación+masiva_V5+(2).pdf| Guía práctica para la ''Importación masiva'' de usuarios]]</big>
 
[[Página_principal | Volver a la Página Principal]]
 
[[Category:tecnico]]
[[Category:usuario]]
[[Category:administrador]]
[[Category:VIVAit Call]]
[[Category:IA]]

Terminales

2026-03-18T10:37:31Z

Alfredo.rodriguez: /* Terminales telefónicos */

<big>
== Terminales telefónicos ==

 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]] (En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]] (En Inglés)
|-
|}
 
[https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Terminales Volver al indice]

Terminales

2026-03-18T10:37:16Z

Alfredo.rodriguez: /* Terminales telefónicos */

<big>
== Terminales telefónicos ==
HOLA
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]] (En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]] (En Inglés)
|-
|}
 
[https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Terminales Volver al indice]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:36:48Z

Alfredo.rodriguez:

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[[Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 | Volver al indice]]

 

 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 

{{:Terminales}}

 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:36:07Z

Alfredo.rodriguez:

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[[Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 | Volver al indice]]

 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 

{{:Terminales}}

 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:33:58Z

Alfredo.rodriguez: /* Terminales telefónicos */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[[Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 | Volver al indice]]

 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 

{{:Terminales}}

{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]](En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]]
|-
|}
 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:30:40Z

Alfredo.rodriguez: /* Introducción */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[[Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 | Volver al indice]]

 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]](En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]]
|-
|}
 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:29:53Z

Alfredo.rodriguez: /* Introducción */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[[Manual_de_operación_de_vFlow | Volver al indice]]

 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]](En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]]
|-
|}
 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:29:21Z

Alfredo.rodriguez: /* Introducción */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[Manual de operación de vFlow | Volver al indice]]

 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]](En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]]
|-
|}
 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:28:20Z

Alfredo.rodriguez: /* Introducción */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[[Documentación_de_usuario_VIVAit_Call_5.1 | Volver al indice]]

 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]](En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]]
|-
|}
 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:27:57Z

Alfredo.rodriguez: /* Introducción */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[[#Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 | Volver al indice]]

 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]](En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]]
|-
|}
 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:27:39Z

Alfredo.rodriguez: /* Introducción */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[[Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 | Volver al indice]]

 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]](En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]]
|-
|}
 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:27:10Z

Alfredo.rodriguez: /* Introducción */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[[Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1|Volver al indice]]
 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]](En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]]
|-
|}
 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:26:53Z

Alfredo.rodriguez: /* Introducción */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

[[Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 | Volver al indice]]
 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]](En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]]
|-
|}
 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Documentación de usuario VIVAit Call 5.1

2026-03-18T10:26:37Z

Alfredo.rodriguez: /* Introducción */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
|-
|}
 <big>
Versiones anteriores de [[Usuario Vivait Call versiones| Usuario Vivait Call]]

[[Guía_rápida_Web_Call_V.2.3.0 | Guía rápida Web Call]]

 

== Introducción ==
 
Los usuarios del sistema '''''VIVA'''''it Call disponen de una serie de herramientas de gestión que permiten manejar y configurar las principales características del sistema a nivel de usuario final:
 
* Terminal telefónico, con diferentes características en función de la marca y modelo que el usuario disponga.
* Facilidades del sistema, accesibles desde cualquier terminal telefónico mediante la pulsación de combinaciones del teclado.
* Portal de usuario, para poder acceder a facilidades del sistema y otros servicios de manera más sencilla e intuitiva.
* Aplicación '''''VIVA'''''it Tracker, que permite realizar el seguimiento, escucha y descarga de grabaciones de llamadas para usuarios con permiso de acceso.
 
[[#Introducción | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
[[Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 | Volver al indice]]
 

== Terminales telefónicos ==
 
'''''VIVA'''''it Call está preparado para poder soportar gran cantidad de terminales telefónicos, de diversas marcas y modelos; se adjuntan manuales de usuario de los más habituales
 
{| class="wikitable"
|-
! Marca !! Modelo !! Manual de uso
|-
| Grandstream || 1160 y 1165 ||[[medio:Guia rapida Grandstream 1160_1165.pdf|Guía rápida Grandstream 1160 y 1165]]
|-
| Grandstream || 1400 y 1405 ||[[medio:Guia rapida Grandstream 1400_1405.pdf|Guía rápida Grandstream 1400 y 405]]
|-
| Grandstream || GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170||[[medio:Guia rapida Grandstream GXP2130_GXP2140_GXP2160.pdf|Guía rápida Grandstream GXP2130 ,GXP2140, GXP2160, GXP2135 y GXP2170]]
|-
| Grandstream || DP715 y DP710 ||[[medio:Guia rapida Grandstream DP715_DP710.pdf|Guía rápida Grandstream DP715 y DP710]]
|-
| Huawei || 7910 ||[[medio:Guia rapida Huawei 7910.pdf|Guía rápida Huawei 7910]] (En Inglés)
|-
| Huawei || 7950 || [[medio:Guia rapida Huawei 7950.pdf|Guía rápida Huawei 7950]] (En Inglés)
|-
| Mitel || 6865i ||[[medio:Guia rapida Mitel 6865i.pdf|Guía rápida Mitel 6865i]]
|-
| Mitel || 6867i ||[[medio:Guia rapida Mitel 6867i.pdf|Guía rápida Mitel 6867i]]

|-
| Aastra (Mitel)|| 6730i y 6731i || [[medio: 6730i_6731i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6730i y 6731i]] (En Inglés)

|-
| Aastra (Mitel)|| 6753i || [[medio:6753i_qrg_symbol_keypad_English_270710.pdf | Guía rápida Aastra Mitel 6753i ]] (En Inglés)
|-
| Snom || 710 ||[[medio:Guia rapida Snom 710.pdf|Guía rápida Snom 710]]
|-
| Yealink || T20P ||[[medio:Guia rapida Yealink T20p.pdf|Guía rápida Yealink T20P]]
|-
| Yealink || T21P ||[[medio:Guia rapida Yealink T21p.pdf|Guía rápida Yealink T21P]]
|-
| Yealink || T23G y T23P ||[[medio:Guia rapida Yealink T23P_T23G.pdf|Guía rápida Yealink T23G y T23P]] (En Inglés)
|-
| Yealink || T26P ||[[medio:Guia rapida Yealink T26p.pdf|Guía rápida Yealink T26P]]
|-
| Yealink || T27P ||[[medio:Guia rapida Yealink T27P.pdf|Guía rápida Yealink T27P]](En Inglés)
|-
| Yealink || T28P ||[[medio:Guia rapida Yealink T28p.pdf|Guía rápida Yealink T28P]]
|-
| Yealink || VP530 ||[[medio:Guia rapida Yealink VP530.pdf|Guía rápida Yealink VP530]]
|-
| Cisco Unified || SIP 3905 ||[[medio:Guia rapida Cisco SIP 3905.pdf|Guía rápida Cisco SIP 3905]]
|-
| Cisco Unified || IP 6921 ||[[medio:Guia rapida Cisco IP 6921.pdf.pdf|Guía rápida Cisco IP 6921]]
|-
| Cisco Unified || IP 7960G y 7940g||[[medio:7940g_y_7960g REFER RAPIDA.pdf|Guía rápida Cisco IP 7960G y 7940g]]
|-
| Cisco Unified || IP 7962G y 7942g||[[medio:cisco_ipphone_7942g.pdf |Guía rápida Cisco IP 7962G y 7942g]]
|-
| Zoiper || Business Windows || [[medio:User Guide Zoiper 5 v.1.0.7.pdf| Manual de usuario de Zoiper 5]]
|-
|}
 
[[#Terminales_telefónicos | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Facilidades del sistema ==
 
Una de las maneras que tiene un usuario para poder realizar operaciones básicas sobre su extensión es mediante el uso de combinaciones de teclas, que le dan acceso a la activación o desactivación de diferentes facilidades en el sistema; la tabla adjunta muestra las facilidades disponibles por defecto.
 
{| class="wikitable"
|-
! '''Código a marcar '''!! Funcionalidad !! Modo de uso
|-
|*21#||Desvío extensión incondicional a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*21*numero||Desvío extensión incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211#||Desvío extensión por no contesta a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*211*numero||Desvío extensión por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212#||Desvío extensión por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*212*numero||Desvío extensión por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213#||Desvío extensión por fuera de servicio a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*213*numero||Desvío extensión por fuera de servicio||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación

|-
|*31#||Desvío usuario incondicional mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*31*numero||Desvío usuario incondicional||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311#||Desvío usuario por no contesta mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*311*numero||Desvío usuario por no contesta||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312#||Desvío usuario por ocupado a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*312*numero||Desvío usuario por ocupado||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313#||Desvío usuario por no login a mensajería||Activación: Pulsar código + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*313*numero||Desvío usuario por no login||Activación: Pulsar código + destino + marcar; locución informa de correcta activación
Desactivación: Pulsar código + marcar; locución informa de correcta desactivación
|-
|*32#||Desvio usuario por calendario. ||Activación: Pulsar código + marcar
|-
|*33#||Desvio extensión por calendario.||Activación: Pulsar código + marcar
|-
|*401#||Login movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*402#||Logout movilidad avanzada||Activación: Pulsar código + destino + marcar
|-
|*41*||Capturar extensión||Activación: Pulsar código + destino + marcar
|-
|*8||Capturar llamada de grupo de captura||Activación: Pulsar código + marcar
|-
|*42#||Leer buzón|| Uso: Pulsar código + marcar
|-
|*43#||Activar retrollamada||Uso: Pulsar código + marcar
|-
|*44#||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|*45#||Login movilidad||Uso: Pulsar código + marcar
|-
|*46#||Logout movilidad||Uso: Pulsar código + marcar
|-
|*47#||Login en grupos corporativos||Uso: Pulsar código + marcar
|-
|*48#||Logout en grupos corporativos||Uso: Pulsar código + marcar
|-
|*491#||Pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*492#||Quitar pausa en grupos corporativos||Uso: Pulsar código + marcar
|-
|*50#||Movilidad||Uso: Pulsar código + marcar
|-
|*54#||Intrusión a extensión||Uso: Pulsar código + marcar
|-
|*55#||Intrusión a VDN o Grupo||Uso: Pulsar código + marcar
|-
|*500#||Eco||Uso: Pulsar código + marcar
|-
|*501#|| Tono de prueba||Uso: Pulsar código + marcar
|-
|*60#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|*61#||Categoría usuario en llamada||Uso: Pulsar código + marcar
|-
|*65#||Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*66#||Fin Categoría temporal de teléfono||Uso: Pulsar código + marcar
|-
|*72#||Movilidad llamada a llamada||Uso: Pulsar código + marcar
|-
|70106 ||Cancelar retrollamada||Uso: Pulsar código + marcar
|-
|}
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

=== Retrollamadas ===
 
El funcionamiento será el siguiente:
 
*La retrollamada queda programada de extensión física "A" a extensión física "B" (no queda programada a numeraciones de usuarios); esto no quiere decir que no podamos programar una retrollamada cuando hemos llamado a una numeración de usuario, pero queda programada en la extensión física en la que está ese usuario en ese momento.
 
*El número llamado "B" podrá ser derivado de varias causas:
 
::"A" ha llamado a "B"
::"A" ha llamado a un usuario ubicado en "B"
::"A" ha llamado a un destino desviado a "B"
::"A" ha llamado a un destino y por preruta acaba en "B"
::...
 
*Las causas por las que se podrá programar una retrollamada son:
::"B" está ocupada
::"B" no contesta
::"B" está ocupada y no contesta (ha sonado en línea 2--> )
 
'''Solo podremos programar la retrollamada si el sistema devuelve: extensión ocupada o no contesta'''
 
Estas dos últimas casuísticas son iguales a efectos de usuario, pero no a efectos internos...
 
Si una llamada va a buzón, salta a un grupo ACD, a una IVR...entonces NO habrá retrollamada (porque se considera contestada)
 
*Para programar una retrollamada se pulsa el código de facilidad (*43#) una vez colgada la misma; el sistema recordará la última llamada durante un período de tiempo configurable; aunque entre una llamada en "A", este podrá programar retrollamada a la última saliente si sigue dentro del período
*Se podrá abortar una retrollamada ( (*44#), pero esto no borrará la última llamada (podemos arrepentirnos de haber abortado la retrollamada)
 
[[#Facilidades_del_sistema | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_5.1 Volver al indice]
 

== Portal de usuario ==

El portal de usuario VIVAit Call permite que determinadas funcionalidades del sistema puedan ser accesibles por los usuarios finales desde una interfaz mucho más cómoda y amigable que el telefónico; de esta forma, desde un portal fácilmente accesible los usuarios finales podrán:

Gestionar las principales características del sistema, incluyendo:

• Principales datos de contacto

• Gestionar desvíos en telefonía corporativa

• Gestionar la agenda de contactos

• Acceder al sistema de mensajería vocal con el objeto de escuchar y administrar los mensajes de voz

== Aspecto general ==

El acceso al portal se realiza tras el correspondiente proceso de validación, tal y como se muestra en la imagen siguiente:

::[[File:webcall1.png |250px|center]]

Una vez se ha accedido al portal, éste se compone de seis pestañas:

• Contactos

• Historial

• Mensaje de voz

• Desvíos

• Ajustes

• Información

::[[File:webcall2-2.png |950px|center]]

En la parte superior derecha del portal, se encuentran los siguientes botones:

::[[File:webcall3.png |450px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| [[File:webcall4.png |50px|center]] || Botón para mostrar u ocultar la ventana del teléfono.
|-
| [[File:webcall5.png |250px|center]] || Muestra si una extensión está disponible o no dependiendo del color (verde = disponible, rojo = no disponible). Cada usuario puede configurar esta funcionalidad en la pestaña Ajustes\Extensiones\Disponibilidad General [[File:webcall6.png |200px|]]
|-
| [[File:webcall7.png |50px|center]] || Este botón se muestra cuando hay configurado uno o varios desvíos. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall8.png |50px|center]] || Este botón se muestra cuando hay configurado un desvío incondicional por calendario. Esta funcionalidad se explica en el apartado 4.4
|-
| [[File:webcall9.png |50px|center]] || Botón para salir del portal.
|-
|}

== Pestañas en el portal de VIVAit Call ==

=== Pestaña Contactos ===

La pestaña de contactos muestra al usuario los datos de los contactos añadidos en su agenda. Los datos que se muestran de cada contacto son: Nombre, Apellido, Empresa, Tipo agenda y Teléfono.

::[[File:WEBCALL1.png |800px|center]]

Para añadir un nuevo contacto, hay que seleccionar el botón de la parte superior derecha "Añadir nuevo contacto".

Al darle a "añadir un nuevo contacto", nos aparecerá una ventana con las siguientes opciones:

::[[File:webcall13.png |800px|center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Nombre en pantalla'''
| | Nombre del usuario en pantalla. ('''Obligatorio''')
|-
| font-weight: bold;" | '''Empresa'''
| | Nombre de la empresa.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Código postal'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''Localidad'''
| | Provincia del usuario .
|-
| font-weight: bold;" | '''Número de teléfono'''
| | Número de teléfono del usuario . ('''Obligatorio''')
|-
| font-weight: bold;" | '''Tipo'''
| | Fijo / Móvil
|-
|}

=== Pestaña Historial===

La pestaña de Historial muestra al usuario el listado de las llamadas realizadas y recibidas.

::[[File:webcall22.png |800px|center]]

=== Pestaña Mensaje de voz===

La pestaña de mensajes de voz muestra los mensajes que han llegado a nuestro buzón de voz.

::[[File:web-call5.png|800px|center]]

=== Pestaña Desvíos ===

La pestaña Desvíos permite al usuario visualizar información de relevancia como usuario de telefonía corporativa, y realizar desvíos de usuario (no a nivel de extensión) en diferentes casuísticas.

::[[File:webcall16.png |800px|center]]

En esta pestaña podremos configurar cinco tipos de desvío:

• Desvío incondicional: Todas las llamadas se desvían.

• Desvío por calendario: Desvío de la llamada cuando se configura una fecha en el calendario.

• Desvío por no conectado: Desvío en caso de que se dirija una llamada al número de un usuario que no está registrado en el teléfono.

• Desvío por ocupado: Desvío cuando el usuario está ocupado (comunicando).

• Desvío por no contestado: Desvío de la llamada cuando el usuario no contesta.

Las opciones de la pestaña Desvíos se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"

|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''INCONDICIONAL'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío incondicional a mensajería'''
|| Desvía todas las llamadas que recibe el usuario al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
|| Número al que se desvía la llamada.
||
|-
| font-weight: bold;" | '''Desvío incondicional por calendario'''
|| Permite al usuario gestionar su desvío por calendario
||
|-
| font-weight: bold;" | '''Desvío por calendario'''
|| Pestaña para seleccionar fechas para el desvío
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONECTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no conectado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no está registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no conectado'''
|| Número al que se desvía la llamada cuando el usuario no está registrado en el teléfono.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''OCUPADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por ocupado a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario está ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
|| Número al que se desvía la llamada cuando el usuario está ocupado.
||
|-
! align=center style="background-color:#0099ff;border-top:0.05pt solid #0099ff;border-bottom:0.05pt solid #0099ff;border-left:0.05pt solid #0099ff;border-right:none;padding:0cm;color:#ffffff;" | '''''NO CONTESTADO'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
! align=center style="background-color:#0099ff;border:0.05pt solid #0099ff;padding:0cm;color:#0099ff;" |
|-
| font-weight: bold;" | '''Desvío por no contestación a mensajería'''
|| Desvía la llamada al buzón de voz cuando el usuario no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío por no contestación'''
|| Número al que se desvía la llamada cuando el usuario no contesta.
||
|-

|}

=== Pestaña Ajustes ===

El área de ajustes del portal nos da acceso a tres pestañas de gestión.

La pestaña de '''Ajustes/Dispositivos''' se muestra en la siguiente imagen:

::[[File:webcall17.png |900px|center]]

En esta pestaña se configura el dispositivo de entrada y salida de audio, también sirve para establecer un tono de timbre.

La pestaña de '''Ajustes/Usuario''' se muestra en la siguiente imagen:

::[[File:WEBCALL2.png |900px|center]]

En esta pantalla los campos que se muestran sombreados no serán editables.

Algunos campos son solo informativos por lo que siempre aparecerán sombreados, en otras ocasiones el usuario no dispondrá de permisos para editar los campos, pero los campos siempre aparecerán.

Las opciones de la pestaña de usuario se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario ('''Obligatorio''').
|-
| font-weight: bold;" | '''Apellido 1'''
| | Primer apellido del usuario.
|-
| font-weight: bold;" | '''Apellido 2'''
| | Segundo apellido del usuario.
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
|-
| font-weight: bold;" | '''Localidad'''
| | Código postal del usuario.
|-
| font-weight: bold;" | '''Código Postal'''
| | Localidad del usuario .
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario .
|-
| font-weight: bold;" | '''Mensaje de texto'''
| | Mensaje de texto a mostrar.
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
|-
| font-weight: bold;" | '''Fecha de expiración'''
| | Nombre de la cuenta del usuario. (solo lectura)
|-
| font-weight: bold;" | '''Fecha último cambio de clave'''
| |Clave de la cuenta (obligatorio).
|}

La pestaña '''Ajustes/extensiones''' muestra al usuario final las extensiones del sistema que tiene asignadas.

::[[File:WEBCALL3.png |1000px|center]]

Guía rápida VIVAit Call Cellular

2026-03-18T10:17:03Z

Alfredo.rodriguez: /* Pestaña de panel de marcado */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call Cellular
|-
|}
 <big>
Versiones anteriores de [[VIVAit Call Cellular versiones| VIVAit Call Cellular]]
 

== Aplicación móvil VIVAit Call Cellular ==
 

mdtel ha desarrollado la aplicación de gestión VIVAit Call Cellular (VCC) para smartphone Android e IOS para la plataforma VIVAit Call
 

Esta aplicación permite a los usuarios gestionar determinadas funcionalidades de usuario de su telefonía VIVAit Call desde su terminal móvil, incluyendo:
* Agenda integrada VIVAit e interna del móvil
* Historial de llamadas del usuario en VIVAit Call (entrantes, salientes, perdidas,...)
* Gestión de disponibilidad de usuario y terminales
* Además, el uso de VIVAit Call Cellular asociado al terminal externo de VIVAit Call permitirá la realización de llamadas desde la aplicación, usando como red de transporte de voz la telefonía celular convencional (GSM)

 

== Instalación y acceso ==
 

La aplicación está disponible para su descarga e instalación en las tiendas Play store de Google o la App Store de Apple.
 

::[[File:vcc1.png|300px|center]]
 

Una vez instalada, al abrir la aplicación el usuario ha de introducir las credenciales de seguridad necesarias, incluyendo:
* Servidor (dato proporcionado por el administrador de VIVAit Call)
* Nombre de usuario (de VIVAit Call)
* terminal externo (opcional); en caso de que el usuario disponga de terminal externo deberá introducirlo en este campo; solo puede ser el número de teléfono registrado como terminal externo por el administrador de VIVAit Call
* Contraseña
 

::[[File:vcc2.png|250px|center]]

== Pestañas ==
 

En la parte inferior de la aplicación, el usuario tendrá acceso a las principales funciones que esta proporciona
* Panel de marcado (solo si dispone de terminal externo)
* Contactos
* Historial de llamadas
* Gestión de terminales

::[[File:vcc12.PNG|700px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| Contactos || Pestaña con los contactos añadidos.
|-
| Historial || Historial de llamadas.
|-
| Configuración || Pestaña para configurar los terminales.
|-
| Botón de borrado|| Botón para borrar los números marcados.
|-
|}

=== Pestaña de panel de marcado ===
 
<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
⚠️ Esta pestaña solo estará disponible en caso de que el usuario disponga de terminal externo
</div>

La pestaña de panel de marcado se compone de:

::[[File:vcc13.PNG|700px|center]]

{| class="wikitable"
|-
! Botón !! Función
|-
| LLamar|| Botón para realizar la llamada.
|-
| Panel de marcado|| Botón de acceso a pestaña de panel de marcado.
|-
| Botón de borrado|| Botón para borrar los números marcados.
|-
|}

Al realizar el marcado, el usuario recibirá una llamada entrante GSM desde VIVAit Call, que tras responder le pondrá en contacto con el destino marcado
 

::[[File:vcc25.png|800px|center]]

=== Contactos ===
 

La pestaña de contactos permite la búsqueda en cuatro tipos de agendas (todos, personal, móvil y corporativa)
En función del tipo de agenda y de la configuración de VIVAit Call, la búsqueda podrá ser inmediata o requerir la introducción de un mínimo de caracteres antes de realizarse

::[[File:vcc14.PNG|250px|center]]

Al seleccionar un contacto, se abre una pestaña en la que se puede editar o visualizar todos los datos de ese contacto.

Para los contactos de la agenda "personal", el usuario tendrá la opción de añadir/modificar/eliminar contactos

::[[File:vcc15.PNG|250px|center]]

=== Pestaña historial de llamadas ===
 

Esta pestaña muestra el historial de llamadas de VIVAit Call para el usuario logado.
 

Si el usuario dispone de terminal externo, dispondrá además de un botón de llamada
 

::[[File:vcc16.PNG|250px|center]]

=== Pestaña de terminales ===

 
En VIVAit Call, un usuario puede tener más de un terminal

 
Desde la pestaña de terminales, el usuario podrá gestionar:
* Su disponibilidad global en la plataforma VIVAit (conmutador "disponible")
* La prioridad (menor número mayor prioridad) y activación o desactivación de cada terminal

 
En la imagen inferior, ante la entrada de una llamada al usuario, sonarán simultánemente los dos terminales activados y con prioridad "1"; el terminal desactivado no sonará

 
::[[File:vcc26.PNG|700px|center]]

En caso de que el usuario desee que la aplicación vuelva a la pantalla inicial de autenticación, dispone del botón "resetear APP", que deberá pulsar tres veces para volver a la pantalla de inicio