Iniciar aplicaciones externas al recibir una llamada telefónica v2

Este artículo ha sido traducido automáticamente. Véase la versión de referencia en inglés.

Rainbow permite recuperar información sobre las llamadas telefónicas entrantes. Puede utilizar esta información transfiriéndola a otra aplicación.
Con esta "Integración de telefonía informática" puede beneficiarse de Rainbow información combinada con otra base de datos.

Se requiere una configuración específica para cada aplicación externa que desee utilizar para este tipo de integración, consulte su documentación para conocer la sintaxis correcta para la transmisión de variables.
Al final de este artículo encontrará algunos ejemplos de integración entre Rainbow y la herramienta de pruebas "MicroCRM".

Configurar el archivo custo-manifest.json

Con esta nueva versión puedes exportar directamente, desde la aplicación de escritorio (1) una plantilla del nuevo archivo custo-manifest . json incluyendo algunas ayudas de sintaxis. Una vez modificado el archivo puedes importar (2) la configuración en la misma página de configuración.

Este archivo contiene una lista de acciones a realizar en un evento predefinido.

Eventos para llamadas entrantes:

Hay 4 eventos disponibles:

• on-incoming-pbx-call-actions (aplicación externa lanzada cuando se presenta una nueva llamada entrante)
• on-incoming-pbx-call-display-actions (mostrar llamadas entrantes) (uso de CPaaS - mostrar más información cuando se presenta una nueva llamada entrante, ya sea desde un archivo, utilizando la API REST o el lanzamiento de un Rainbow Bot)
• on-answering-incoming-pbx-call-actions (aplicación externa lanzada cuando se responde una llamada entrante)
• on-releasing-incoming-pbx-call-actions (aplicación externa que se ejecuta cuando se libera una llamada entrante)
• on-incoming-pbx-call-button-actions (aplicación externa lanzada sólo al hacer clic en un botón añadido en la ventana emergente de llamada entrante)

Para el Evento seleccionado tendrá que configurar al menos la sección "command" compuesta por un "url" y "params". El campo "name" debe ser completado sólo para el evento on-incoming-pbx-call-button-actions, será el nombre mostrado en el botón en la ventana emergente de llamada entrante.

"url" - Ubicación de la aplicación externa

en el campo URL se proporcionará la url o la ruta de la aplicación externa

"params" - Variable a transmitir a la aplicación externa

Hay diferentes variables disponibles:

Llamada (Rainbow usuario actualmente conectado a la aplicación de escritorio):

• ${localUser.firstName}
• ${localUser.lastName}
• ${localUser.email}
• ${localUser.canonicalNumber}
• ${localUser.phoneNumber} ${localUser.phoneNumber}
• ${localUser.internalNumber}

Persona que llama

• ${caller.firstName}
• ${caller.lastName}
• ${caller.phoneNumber}

Called phone number (cuando se redirige la llamada o cuando Rainbow obtiene el número de grupo)

• ${called.phoneNumber}

Contexto de la llamada (sólo para OXE)

• ${call.callId}
• ${call.globalCallId}

Opciones específicas para on-answering-incoming-pbx-call-actions

"RaiseChangeCall": false | true | only

Esta opción permite configurar el comportamiento al recibir una llamada transferida:

• false = sólo las llamadas directas al usuario activarán el evento.
• true = el evento se activa para las llamadas directas al usuario y también para las llamadas que han sido transferidas a este usuario.
• only = sólo las llamadas transferidas al usuario activan el evento.

Archivo de plantilla

{ "version": "2", "extension-points": { "on-incoming-pbx-call-actions": [ { "name": " ", "command": { "url": " ", "params": " "
			} } ],
 " on-incoming-pbx-call-display-actions": [
 {
 "name": " ",
 "command": {
 "commandType": ",
 " url": ",
 "method": ",
 " params": ",
 "header": [
 " "
 ],
 "Jid": ""
                       },
 "responseType": " ",
 "jsonField": " "
 }
       ],
	"on-answering-incoming-pbx-call-actions": [ { "name": " ", "command": { "url": " ", "params": " "},
 " RaiseChangeCall": false } ],"on-releasing-incoming-pbx-call-actions ":[ { "name": " ", "command": { "url": " ", "params": " "
			} } ],"on-incoming-pbx-call-button-actions": [ { "name": " ", "command": { "url": " ", "params": " "
			}, "AnswerOnClick": false } ]},
"help": [ " Este archivo Json contiene la personalización de eventos para la aplicación Rainbow Desktop ",
 " Fuentes de eventos: ",
 " - on-incoming-pbx-call-actions : cuando se presenta una nueva llamada entrante. ",
 " - on-incoming-pbx-call-display-actions : cuando se presenta una nueva llamada entrante. ",
 " - on-answering-incoming-pbx-call-actions : cuando se contesta una llamada entrante. ",
 " - on-releasing-incoming-pbx-call-actions : cuando se libera una llamada entrante. ",
 " - on-incoming-pbx-call-button-actions : al hacer clic en un botón añadido en la ventana emergente de llamada entrante",
 " ",
 " name : se utiliza sólo para el botón de acción como etiqueta del botón. ",
 " filtrar : si se establece con el valor NoShortNumber no se invocará el comando si el número de la persona que llama es un interno. ",
 " AnswerOnClick: sólo para `on-incoming-pbx-call-button-actions` cuando se establece en `true`, el botón click ",
 " responderá la llamada e invocará el comando ",
 " RaiseChangeCall: sólo para `on-answering-incoming-pbx-call-actions` cuando se establece en `true` o `only`",
 " activará el evento en llamadas de transferencia/cambio. ",
 " responseType: sólo para `on-incoming-pbx-call-display-actions` con commandType `file` o `rest`",
 " y puede ser `markdown` o `json`. ",
 " jsonField: sólo para `on-incoming-pbx-call-display-actions` con responseType `json` ",
 " ",
 " Claves de comando disponibles: ",
 " url: es la ruta del ejecutable o una URL ",
 " params: es una cadena con la variable ${xx} que se sustituirá por el valor cuando se invoque el comando ",
 " commandType: sólo para `on-incoming-pbx-call-display-actions` y puede ser `file` o `rest` o `rainbowBot`",
 " method: sólo para `on-incoming-pbx-call-display-actions` con commandType `rest`y puede ser `GET` o `POST`",
 " header: only for `on-incoming-pbx-call-display-actions` with commandType `rest` is optional ",
 " and will be inserted as a header line in REST request ",
 " Jid: only for `on-incoming-pbx-call-display-actions` with commandType `rainbowBot` ",
 " ",
 " Variable para Rainbow usuario (ME) ",
 " ${localUser.firstName} ${localUser.lastName} ${localUser.email} ",
 " ${localUser.canonicalNumber} ${localUser.phoneNumber} ${localUser.internalNumber} ${localUser.phonePbx}",
 " ",
 " Variable para el usuario que llama ",
 " ${caller.firstName} ${caller.lastName} ${caller.phoneNumber} ",
 " ",
 " Variable para el número llamado - cuando la llamada se redirige o cuando Rainbow obtiene el número de grupo ",
 " ${called.phoneNumber} ",
 " ",
 " Variable para el contexto de la llamada ",
 " ${call.callId} ",
 " ${call.globalCallId} (sólo OXE) ",
 " ${call.correlatorData} ",
 " ${call.hexCorrelatorData} " 
 ] }

Ejemplos de configuración con la herramienta MicroCRM

Para abrir o crear un registro en la base de datos MicroCRM, para transmitir el número de teléfono la herramienta debe ejecutarse con el parámetro -number:

MicroCRM.exe -número phonenumber

• Para los ejemplos a continuación utilizaremos el número de teléfono de la persona que llama que es la variable ${caller.phoneNumber}
• MicroCRM está instalado en el PC en la siguiente ubicación C:\MicroCRM\MicroCRM.exe

Ejemplo 1 - Abrir MicroCRM al contestar una llamada entrante

Sólo tiene que modificar la siguiente parte del archivo:

"on-answering-incoming-pbx-call-actions": [ { "name": " ", "command": { "url": " C:³\\MicroCRM\MicroCRM.exe", "params": "-número${caller.phoneNumber}" } ],

Nota: No olvide utilizar el doble \\ para la ruta C:\\MicroCRM\\MicroCRM.exe

Ejemplo 2 - Abrir MicroCRM cuando contesta una llamada usando el botón dedicado en la notificación de llamada entrante

Sólo tiene que modificar la siguiente parte del archivo:

"on-incoming-pbx-call-button-actions": [ { "name": "Abrir MicroCRM", "command": { "url": " C:\\\MicroCRM\\MicroCRM.exe", "params": " -number${caller.phoneNumber}" }, "AnswerOnClick": true} ]

Nota: Para abrir la aplicación externa y responder a la llamada simultáneamente tendrás que establecer el parámetro "AnswerOnClick" en true.

Ejemplo 3 - Abrir una página web de directorio inverso en francés al recibir una llamada

En este ejemplo no utilizamos una aplicación instalada en el PC, sino que abrimos una página web y la variable se introduce directamente en la "url".

"on-incoming-pbx-call-actions": [ { "name": " ", "command": { "url": "https://www.pagesjaunes.fr/annuaireinverse/recherche", "params": "quoiqui=${caller.phoneNumber}&proximite=0" } } ],

Opciones de instalación para desplegar el custo-manifest.json utilizando una herramienta de distribución desoftware

El archivo de manifiesto primero debe ser desplegado en el PC, por ejemplo, el archivo puede ser copiado a una carpeta de usuario C:\sers\username\Rainbow_custom_manifest\.

A continuación, debe iniciarse la configuración de la aplicación Rainbow Desktop con el parámetro /Custom para aplicar el archivo de manifiesto personalizado para el usuario.

Usando configuraciones MSI:

msiexec /i "Rainbow_installer_user.msi" WRAPPED_ARGUMENTS="/Custom=C:\\sers\username\\Rainbow_custom_manifest\\custo-manifest.json"

Usando exe setups:

Rainbow_Installer.exe /Custom=C:\NUsers\username\\\Rainbow_custom_manifest\custo-manifest.json

Desactivar la función

Para una instalación a través de la herramienta de distribución de software

Para desactivar el uso del archivo de manifiesto personalizado, ejecute la instalación con /Custom sin ningún valor
, por ejemplo Rainbow_Installer .exe /Custom o desinstale e instale de nuevo la aplicación de escritorio Rainbow.

Para la instalación Manual/Usuario (importación del archivo custo-manifest)

Vaya a la carpeta C:\Users\username\AppData\Roaming\Alcatel-Lucent Enterprise\Rainbow

Borre el archivo custo-manifest.json

Migración Lanzar aplicaciones externas v1 a v2

Un usuario que ya utilice la versión 1 puede seguir utilizándola sin ningún cambio

La Importación/Exportación no se presentará.

Para migrar de la versión 1 a la versión 2 debe:

1. Guardar el archivo Custom manifest v1
2. Cambia el archivo Rainbow Settings y establece la línea "customizationDirectory": true
   • ubicación del archivo C:\Users\username\AppData\Roaming\Alcatel-Lucent Enterprise\Rainbow
   • nota tendrás que salir de Rainbow antes de cambiar el archivo
3. Ahora en Configuración->Telefonía->Personalización sección se hace visible
4. Exporte la plantilla, añada en este archivo los comandos personalizados de su archivo guardado en el paso 1 y luego impórtelo de nuevo.