En este artículo
dropdown icon
Personaliza el botón de acción.
    Configuración de parámetros para llamadas de emergencia
    Configuración de parámetros de servicios personalizados
    Configuración de parámetros de múltiples disparadores
    Un único disparador para la configuración de parámetros de múltiples eventos
Solicitud HTTP POST para el botón de acción.
Configurar el botón de acción (CM unificado)
list-menuEn este artículo
list-menu¿Comentarios?

Este artículo de ayuda está dirigido al teléfono inalámbrico Cisco 9821 registrado en Cisco Unified Communications Manager (Unified CM).

El botón de acción es el botón rojo situado en el lado derecho del teléfono inalámbrico Cisco 9821. Permite a los usuarios acceder rápidamente a servicios específicos, como servicios de emergencia o servicios personalizados. Puedes personalizar el botón para que inicie eventos que se adapten a tus casos de uso específicos.

Personaliza el botón de acción.

1

En la administración de Cisco Unified Communications Manager, realice una de las siguientes acciones según sea necesario:

  • Para configurar todos los teléfonos desplegados, vaya a Sistema > Configuración de teléfono empresarial.
  • Para configurar teléfonos que comparten el mismo perfil de teléfono, vaya a Dispositivo > Configuración del dispositivo > Perfil de teléfono común.
  • Para configurar un teléfono individual, vaya a Dispositivo > Teléfono. Luego, localiza tu teléfono y abre la página de Configuración del teléfono.

La configuración sigue una estructura jerárquica:

  • La configuración de cada dispositivo tiene prioridad sobre la configuración del perfil de teléfono común y la configuración empresarial.
  • La configuración común del perfil telefónico anula la configuración a nivel empresarial.

2

Personaliza los parámetros del botón de acción según tus casos de uso.

El botón de Acción tiene tres grupos de parámetros, cada uno correspondiente a un servicio con un activador único. Si se especifica un activador de servicio en varios grupos, la configuración del Grupo 1 tiene prioridad sobre la de los Grupos 2 y 3, mientras que el Grupo 2 tiene prioridad sobre el Grupo 3.

Para obtener más información sobre estos parámetros, consulte Parámetros de configuración específicos del producto.

3

Seleccione Guardar.

4

Seleccione Aplicar configuración.

Configuración de parámetros para llamadas de emergencia

Configure los siguientes parámetros para las llamadas de emergencia.

Tabla 1. Configuración de parámetros para llamadas de emergencia

Parámetro

Configuración

Función del botón de acción

Seleccione Llamada de emergencia.

Botón de acción Destino del servicio

Introduzca el número de teléfono o la URI del servicio de emergencias.

Nombre del servicio del botón de acción

(Opcional) Especifique un nombre para el servicio asociado con el disparador. Este nombre se mostrará en el mensaje que aparece en pantalla cuando el usuario pulse el botón, indicando qué servicio se activará. Cuando no se especifique ningún nombre, se utilizará Emergency call o Silent emergency call como nombre para mostrar.

Retraso en la llamada saliente

Establezca el tiempo de espera, en segundos, que debe transcurrir antes de que el teléfono inicie un evento tras detectar el desencadenante. El valor predeterminado es de 5 segundos. Cuando se establece en 0, el evento se inicia inmediatamente al detectarse el desencadenante.

La pantalla de retardo muestra un temporizador de cuenta regresiva, lo que permite al usuario cancelar la acción activada por el botón de Acción. En situaciones de llamadas de emergencia, el teléfono inalámbrico Cisco 9821 vibra continuamente mientras se muestra la pantalla de retardo. Sin embargo, para llamadas o señales de emergencia silenciosas, el teléfono inalámbrico Cisco 9821 no vibra.

Disparador de servicio

Seleccione un activador de la lista: Pulsación simple, Pulsación larga, o Pulsación 3 veces.

Llamada de emergencia silenciosa

(Opcional) Por defecto, la llamada de emergencia funciona como una llamada bidireccional, similar a otras llamadas salientes. Cuando se habilita la llamada de emergencia silenciosa, el audio permanece silenciado en el lado de la persona que llama para evitar llamar la atención durante la llamada. Solo la persona que recibe la llamada puede finalizar la llamada de emergencia silenciosa.

Durante una llamada de emergencia silenciosa, la pantalla del teléfono inalámbrico Cisco 9821 se apagará. Todas las demás funciones son inaccesibles. El teléfono vuelve a funcionar con normalidad una vez que el destinatario finaliza la llamada.

Permitir la recuperación silenciosa de llamadas de emergencia

(Opcional) Active esta función si permite que los usuarios pulsen cualquier tecla para restablecer el funcionamiento normal del teléfono mientras mantienen la llamada de emergencia. El audio de la llamada permanece silenciado a menos que el usuario aumente el volumen del altavoz mediante la tecla de volumen.

Configuración de parámetros de servicios personalizados

Configure los siguientes parámetros para los servicios personalizados.

Tabla 2. Configuración de parámetros de servicios personalizados

Parámetro

Configuración

Función del botón de acción

Seleccione Personalizado.

Botón de acción Destino del servicio

Introduzca la URL del servicio personalizado. La URL debe comenzar con http:// o https://, por ejemplo, https://10.11.20.159/path/service.xml.

Nombre del servicio del botón de acción

(Opcional) Especifique un nombre para el servicio asociado con el disparador. Este nombre se mostrará en el mensaje que aparece en pantalla cuando el usuario pulse el botón, indicando qué servicio se activará. Cuando no se especifica ningún nombre, se utilizará Servicio personalizado como nombre para mostrar.

Campo de contenido personalizado

(Opcional) Si desea habilitar el teléfono para que envíe una solicitud HTTP POST cuando se presione el botón de Acción, ingrese los datos HTTP, como el método, el encabezado y el contenido POST, con una longitud máxima de 1024 caracteres.

Para ver ejemplos de scripts POST y la sintaxis, consulte Solicitud HTTP Post para el botón Acción.

Retraso en la llamada saliente

Establezca el tiempo de espera, en segundos, que debe transcurrir antes de que el teléfono inicie un evento tras detectar el desencadenante. El valor predeterminado es de 5 segundos. Cuando se establece en 0, el evento se inicia inmediatamente al detectarse el desencadenante.

La pantalla de retardo muestra un temporizador de cuenta regresiva, lo que permite al usuario cancelar la acción activada por el botón de Acción. Durante los escenarios de servicios personalizados, el teléfono inalámbrico Cisco 9821 vibra continuamente mientras se muestra la pantalla de retardo.

Disparador de servicio

Seleccione un activador de la lista: Pulsación simple, Pulsación larga, o Pulsación 3 veces.

Secreto de servicio

Establezca una cadena secreta que puede ser un secreto de autenticación, un token o una contraseña. El secreto introducido se muestra como una cadena enmascarada y se puede hacer referencia a él mediante la macro $SS en Campo de contenido personalizado y Destino del servicio del botón de acción.

Configuración de parámetros de múltiples disparadores

Establezca los parámetros en cada grupo respectivamente. Consulte las secciones Llamadas de emergencia y Servicios personalizados anteriores.

Un único disparador para la configuración de parámetros de múltiples eventos

Configure los siguientes parámetros para asignar varios eventos a un disparador.

Tabla 3. Un único disparador para la configuración de parámetros de múltiples eventos

Parámetro

Configuración

Función del botón de acción

Seleccione Personalizado.

Botón de acción Destino del servicio

Introduzca el número de teléfono al que llamar y la URL del servicio XML en este formato:

tel: +

La URL debe comenzar con http:// o https://.

Por ejemplo: tel:1234 + https://10.11.20.159/path/service.xml

Nombre del servicio del botón de acción

(Opcional) Especifique un nombre para el servicio asociado con el disparador. Este nombre se mostrará en el mensaje que aparece en pantalla cuando el usuario pulse el botón, indicando qué servicio se activará. Cuando no se especifica ningún nombre, se utilizará Servicio personalizado como nombre para mostrar.

Campo de contenido personalizado

(Opcional) Si desea habilitar el teléfono para que envíe una solicitud HTTP POST cuando se presione el botón de Acción, ingrese los datos HTTP, como el método, el encabezado y el contenido POST, con una longitud máxima de 1024 caracteres.

Para ver ejemplos de scripts POST y la sintaxis, consulte Solicitud HTTP Post para el botón Acción.

Retraso en la llamada saliente

Establezca el tiempo de espera, en segundos, que debe transcurrir antes de que el teléfono inicie un evento tras detectar el desencadenante. El valor predeterminado es de 5 segundos. Cuando se establece en 0, el evento se inicia inmediatamente al detectarse el desencadenante.

La pantalla de retardo muestra un temporizador de cuenta regresiva, lo que permite al usuario cancelar la acción activada por el botón de Acción. Durante las llamadas de emergencia y los servicios personalizados, el teléfono inalámbrico Cisco 9821 vibra continuamente mientras se muestra la pantalla de retardo. Sin embargo, para llamadas o señales de emergencia silenciosas, el teléfono inalámbrico Cisco 9821 no vibra.

Disparador de servicio

Seleccione un activador de la lista: Pulsación simple, Pulsación larga, o Pulsación 3 veces.

Secreto de servicio

Establezca una cadena secreta que puede ser un secreto de autenticación, un token o una contraseña. El secreto introducido se muestra como una cadena enmascarada y se puede hacer referencia a él mediante la macro $SS en Campo de contenido personalizado y Destino del servicio del botón de acción.

Llamada de emergencia silenciosa

(Opcional) Por defecto, la llamada de emergencia funciona como una llamada bidireccional, similar a otras llamadas salientes. Cuando se habilita la llamada de emergencia silenciosa, el audio permanece silenciado en el lado de la persona que llama para evitar llamar la atención durante la llamada. Solo la persona que recibe la llamada puede finalizar la llamada de emergencia silenciosa.

Durante una llamada de emergencia silenciosa, la pantalla del teléfono inalámbrico Cisco 9821 se apagará. Todas las demás funciones son inaccesibles. El teléfono vuelve a funcionar con normalidad una vez que el destinatario finaliza la llamada.

Permitir la recuperación silenciosa de llamadas de emergencia

(Opcional) Active esta función si permite que los usuarios pulsen cualquier tecla para restablecer el funcionamiento normal del teléfono mientras mantienen la llamada de emergencia. El audio de la llamada permanece silenciado a menos que el usuario aumente el volumen del altavoz mediante la tecla de volumen.

Solicitud HTTP POST para el botón de acción.

El botón de acción del teléfono inalámbrico Cisco 9821 se puede configurar para activar aplicaciones XML mediante solicitudes HTTP POST.

En Campo de contenido personalizado, introduzca su script de solicitud personalizado. Puede especificar el tipo de contenido XML o JSON e incluir macros en la solicitud. Por ejemplo, se puede agregar $SSal script para recuperar el secreto de autenticación, el token o la contraseña proporcionados en el campo Secreto de servicio.

Los siguientes ejemplos están en formato XML y JSON:

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer username:$SS'
--body '' 

Sample #2: JSON
--method POST
--header 'Content-Type: application/json'
--header 'Authorization: $SS'
--body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}' 

Cisco Unified CM requiere codificación porcentual para los caracteres reservados de acuerdo con la RFC 3986.

Tabla 4. Codificación porcentual para caracteres reservados
PersonajeCodificación porcentual
&%26
'%27
"%22
< %3c
> %3e

El siguiente script es un ejemplo que utiliza cadenas codificadas en porcentaje.

--method POST
--header %27Content-Type: application/xml%27
--body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eThis is for HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27
Tabla 5. Macros compatibles
Nombre de la macroExpansión macro
#DEVICENAME#El nombre del dispositivo que se muestra en el sistema de llamadas. Por ejemplo, SEP845A3EC21288
$SSSecreto de servicio que presenta una cadena enmascarada en la página de configuración del teléfono, como un secreto de autenticación, un token o una contraseña.
¿Ha encontrado este artículo útil?
¿Ha encontrado este artículo útil?