En este artículo
Personalizar el botón Acción
dropdown icon
Referencias
    Parámetros para el botón Acción
    HTTP Publicar solicitud para el botón Acción
Configure el botón Acción para 9800 (Unified CM)
list-menuEn este artículo
list-menu¿Comentarios?

El botón Acción es el botón rojo ubicado en la parte superior derecha del teléfono. Permite a los usuarios acceder rápidamente a los servicios designados, como servicios de emergencia o personalizados. Puede personalizar el botón para iniciar eventos que se adapten a sus casos de uso específicos. La información de esta página se aplica a Cisco Desk Phone 9800 Series registrado como Cisco Unified Communications Manager (Unified CM).

Personalizar el botón Acción

Las opciones personalizadas para el botón Acción en Cisco Desk Phone serie 9800 requieren soporte específico del firmware de PhoneOS. Consulte la siguiente tabla para obtener más detalles:

CaracterísticaVersión de firmware requerida
Llamada de emergenciaPhoneOS 3.0.1 y posterior
Servicio personalizadoPhoneOS 3.2.1 y posterior
Múltiples desencadenantesPhoneOS 3.3.1 y posterior
Correo HTTPPhoneOS 3.3.1 y posterior
Múltiples eventos en un solo disparadorPhoneOS 3.4.1 y posterior
1

Inicie sesión enCisco Unified Communications Manager Administration.

2

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 busque su teléfono y abra la página Configuración del teléfono.

La configuración sigue una estructura jerárquica:

  • La configuración individual del dispositivo tiene prioridad sobre la configuración en el perfil de teléfono común y a nivel empresarial
  • La configuración común del perfil de teléfono invalida la configuración de nivel empresarial

3

Personalice la configuración del botón Acción con los siguientes parámetros según sus casos de uso.

Hay tres grupos de parámetros para el botón Acción, cada uno correspondiente a un servicio con un disparador único. Si se especifica un activador de servicio en varios grupos, las configuraciones del Grupo 1 tienen prioridad sobre las del Grupo 2 y 3, mientras que el Grupo 2 tiene prioridad sobre el Grupo 3.

  • Llamadas de emergencia

    Configure los siguientes parámetros:

    • Función del botón de acción: Seleccione llamada de emergencia.

    • Destino del servicio del botón de acción: Introduzca el número de teléfono o el URI del servicio de emergencia.

    • Nombre del servicio del botón de acción (opcional): Especifique un nombre para el servicio asociado con el desencadenador de acción. Este nombre aparecerá en el mensaje en pantalla cuando el usuario presione el botón, indicando qué evento se iniciará. Si no se especifica ningún nombre, se utilizará la llamada de emergencia como nombre para mostrar.

    • Retraso de marcado de salida: establezca el período de tiempo de espera (en segundos) para que el teléfono inicie una llamada de emergencia después de que se detecte el disparador. El valor predeterminado es 5 segundos. Si se establece en 0, la llamada se realiza inmediatamente después de detectar el disparador.

    • Activador de servicio Seleccione un disparador de la lista: pulsación simple, pulsación larga o 3 veces.

    • Llamada de emergencia silenciosa (opcional): De forma predeterminada, la llamada de emergencia funciona como una llamada bidireccional, similar a otras llamadas salientes. Cuando la llamada de emergencia silenciosa está activada, el audio es silencioso en el lado de la persona que llama para evitar llamar la atención durante la llamada en curso. Solo el destinatario de la llamada puede finalizar la llamada de emergencia silenciosa.

      Durante una llamada de emergencia silenciosa, la pantalla del teléfono 9811 y 9841 se congelará, mientras que la pantalla del teléfono 9851, 9861 y 9871 se apagará. Todas las demás funciones son inaccesibles. El teléfono restablece el funcionamiento normal después de que el destinatario termina la llamada.

    • Permitir recuperación silenciosa de llamadas de emergencia (opcional): habilite esta función si permite que los usuarios presionen cualquier tecla para restablecer el funcionamiento normal del teléfono mientras mantienen la llamada de emergencia. El audio de la llamada permanece en silencio a menos que el usuario aumente el volumen del altavoz con la tecla Volumen.

  • Servicios personalizados

    Configure los siguientes parámetros:

    • Función del botón de acción: Seleccione Personalizado.

    • Destino del servicio del botón de acción: Introduzca la dirección 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 en pantalla cuando el usuario presione el botón, indicando qué servicio se activará. Cuando no se especifica ningún nombre, se utilizará el servicio personalizado como nombre para mostrar.

    • Campo de contenido personalizado (opcional): Si desea habilitar el teléfono para enviar una solicitud HTTP Post cuando se presiona el botón Acción, ingrese los datos HTTP como método, encabezado y contenido de publicación, con una longitud máxima de 1024 caracteres.

      Para obtener ejemplos de secuencias de comandos POST y la sintaxis, consulte Solicitud HTTP Post para el botón Acción.

    • Retraso de marcado de salida: establezca el período de tiempo de espera, en segundos, para que el teléfono inicie un evento después de detectar el disparador. El valor predeterminado es 5 segundos. Cuando se establece en 0, el evento se inicia inmediatamente después de la detección del disparador.

    • Activador de servicio Seleccione un disparador de la lista: pulsación simple, pulsación larga o 3 veces.

    • Secreto de servicio (opcional): Introduzca el secreto de autenticación, el token o la contraseña si su servicio personalizado requiere autenticación para acceder a él. El secreto ingresado se muestra como una cadena enmascarada y se puede hacer referencia mediante la macro $SSen el campo de contenido personalizado y el destino del servicio del botón de acción.

  • Múltiples desencadenantes

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

  • Un solo disparador para múltiples eventos

    Configure los siguientes parámetros para asignar varios eventos a un desencadenador:

    • Función del botón de acción: Seleccione Personalizado.

    • Destino del servicio del botón de acción: Introduzca el número de teléfono al que llamar y la dirección URL del servicio XML en este formato:

      tel:<phonenumber or SIP URI> + <serviceURL>

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

      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 en pantalla cuando el usuario presione el botón, indicando qué servicio se activará. Cuando no se especifica ningún nombre, se utilizará el servicio personalizado como nombre para mostrar.

    • Campo de contenido personalizado (opcional): Si desea habilitar el teléfono para enviar una solicitud HTTP Post cuando se presiona el botón Acción, ingrese los datos HTTP como método, encabezado y contenido de publicación, con una longitud máxima de 1024 caracteres.

      Para obtener ejemplos de secuencias de comandos POST y la sintaxis, consulte Solicitud HTTP Post para el botón Acción.

    • Retraso de marcado de salida: establezca el período de tiempo de espera, en segundos, para que el teléfono inicie un evento después de detectar el disparador. El valor predeterminado es 5 segundos. Cuando se establece en 0, el evento se inicia inmediatamente después de la detección del disparador.

    • Activador de servicio Seleccione un disparador de la lista: pulsación simple, pulsación larga o 3 veces.

    • Secreto de servicio (opcional): Introduzca el secreto de autenticación, el token o la contraseña si su servicio personalizado requiere autenticación para acceder a él. El secreto ingresado se muestra como una cadena enmascarada y se puede hacer referencia mediante la macro $SSen el campo de contenido personalizado y el destino del servicio del botón de acción.

    • Llamada de emergencia silenciosa (opcional): Si ha incluido un número de teléfono o un URI de marcado en el destino del servicio, activar esta función silenciará las llamadas de emergencia.

      De forma predeterminada, la llamada de emergencia funciona como una llamada bidireccional, similar a otras llamadas salientes. Cuando está activado, el audio es silencioso en el lado de la persona que llama para evitar llamar la atención durante la llamada en curso. Solo el destinatario de la llamada puede finalizar la llamada.

      Durante una llamada de emergencia silenciosa, la pantalla del teléfono 9811 y 9841 se congelará, mientras que la pantalla del teléfono 9851, 9861 y 9871 se apagará. Todas las demás funciones son inaccesibles. El teléfono restablece el funcionamiento normal después de que el destinatario termina la llamada.

    • Permitir recuperación silenciosa de llamadas de emergencia (opcional): habilite esta función si permite que los usuarios presionen cualquier tecla para restablecer el funcionamiento normal del teléfono mientras mantienen la llamada de emergencia. El audio de la llamada permanece en silencio a menos que el usuario aumente el volumen del altavoz con la tecla Volumen.

Para obtener más información sobre estos parámetros, consulte Parámetros para el botón Acción.

4

Seleccione Guardar.

5

Seleccione Aplicar configuración.

Referencias

Parámetros para el botón Acción

Los parámetros están disponibles en Configuración de teléfono empresarial, perfil de teléfono común y configuración de teléfono individual.

Tabla 1. Parámetros para el botón Acción
ParámetroPredeterminado y opcionesDescripción
Función del botón de acción 1~3

Predeterminado: Desactivado

Opciones: Desactivado, Llamada de emergencia, Personalizado

Puede configurar el botón con un servicio específico.

  • Desactivado: Cuando se establece en Desactivado, el botón Acción para un solo servicio en el teléfono no funcionará.
  • Llamada de emergencia: Los usuarios pueden usar el botón Acción para realizar una llamada de emergencia, si está configurado.
  • Personalizado: Los usuarios pueden usar el botón Acción para acceder al servicio personalizado, si está configurado.

Cuando establezca el campo en Llamada de emergencia o Personalizado, asegúrese de introducir el destino del servicio en el campo Destino del servicio del botón Acción. O bien, el teléfono mostrará un error de configuración.

Botón de acción Nombre del servicio 1~3

Predeterminado: Vacío

Opcionalmente, especifique un nombre para el servicio asociado con el botón Acción. Este nombre se mostrará en el mensaje en pantalla cuando el usuario presione el botón, indicando qué servicio se activará.

Si no especifica un nombre, el nombre predeterminado será Llamada de emergencia, Llamada de emergencia silenciosa o Acción personalizada según su selección en el campo Función del botón de acción.

Destino del servicio del botón de acción 1~3

Predeterminado: Vacío

Proporcione el destino del servicio en uno de los siguientes formatos según el servicio asignado al botón Acción:

  • Para los servicios de llamadas de emergencia, ingrese un número de teléfono o el URI del servicio de emergencia.

  • Cuando configure el botón para un servicio personalizado, introduzca la dirección URL del servicio. La URL debe comenzar con http://o https://. Por ejemplo, https://10.11.20.159/path/service.xml.

  • Para configurar el botón para iniciar varios eventos con un solo disparador, escriba tel:<phonenumber or SIP URL> + <Service RUL>. Ejemplo: tel:1234 + https://10.11.20.159/path/service.xml.

    También se admite llamar a URI SIP. Introduzca el URI en el formato de tel: sip 4567@co.webex.com

Si habilita el botón Acción sin establecer un destino de servicio válido, el usuario en el teléfono verá un mensaje que le solicita la configuración. Después de que el usuario cierre esta notificación, el icono de advertencia persistirá en el encabezado de la pantalla del teléfono hasta que el botón esté configurado o deshabilitado correctamente.

Los números de teléfono no se pueden usar como destinos para servicios personalizados. Si configura el botón de acción como personalizado e introduce un número de teléfono como destino del servicio, aparecerá un mensaje de alerta en el teléfono indicando que el botón no está configurado. En su lugar, puede agregar un número de teléfono en este formato tel:<phone number>, por ejemplo, tel:1234.

Si no se le permite ingresar una URL que incluya ampersand (&), use %26 como reemplazo. Por ejemplo, escriba http://1.2.3.4/phone?a=1%26b=2%26c=3 en lugar de http://1.2.3.4/phone?a=1&b=2&c=3.

Campo de contenido personalizado 1~3

Predeterminado: Vacío

Esta configuración solo funciona cuando la función del botón de acción se establece en Personalizado.

Introduzca los datos HTTP, como el método, el encabezado y el contenido de la publicación, con una longitud máxima de 1024 caracteres. Cuando se configura, el teléfono envía una solicitud HTTP Post cuando se presiona la acción.

Si el servicio requiere autenticación para acceder, asegúrese de introducir el secreto de autenticación en el campo Secreto de servicio. En los datos HTTP, utilice la macro $SScomo referencia a Service Secret.

Para obtener ejemplos y la sintaxis, consulte HTTP Post request para el botón Acción.

Secreto de servicio 1~3

Predeterminado: Vacío

Un secreto de servicio puede ser un secreto de autenticación, token o contraseña. El secreto ingresado se muestra como una cadena enmascarada y se puede hacer referencia mediante la macro $SSen el campo de contenido personalizado y el destino del servicio del botón de acción.

Activador de servicio 1~3

Predeterminado: Prensa única

Opciones: Prensa única, Prensa larga, Prensa 3 veces

Elija cómo los usuarios pueden realizar una llamada de emergencia o iniciar un servicio personalizado utilizando el botón Acción del teléfono.

Una sola pulsación: presione el botón Acción para activar la llamada o servicio asociado.

Pulsación larga: Presione el botón Acción hacia abajo durante al menos 2 segundos para activar la llamada o el servicio asociado.

Presione 3 veces: Presione el botón Acción tres veces con intervalos de menos de 2 segundos entre cada pulsación para activar la llamada o servicio asociado.

No repita un disparador en varios servicios, ya que los parámetros con menor prioridad no funcionarán. El orden de prioridad, de mayor a menor, es el siguiente: Grupo 1, Grupo 2, Grupo 3.

Retraso de marcación 1~3

Predeterminado: 5

Opciones: 0 - 30

Establezca el período de tiempo de espera, en segundos, para que el teléfono inicie una llamada de emergencia o una acción personalizada después de presionar el botón Acción.

Establécelo en 0 si prefiere que el teléfono realice la llamada o inicie un evento inmediatamente después de detectar el disparador, como se especifica con una sola pulsación, una pulsación larga o una pulsación triple en el botón.

Llamada de emergencia silenciosa 1~3

Predeterminado: Desactivado

Opciones: Activado, Desactivado

La llamada de emergencia silenciosa está diseñada para una asistencia discreta en situaciones peligrosas. Permite a los usuarios buscar ayuda sin hacer ningún ruido.

  • Cuando está habilitado, los usuarios pueden realizar llamadas unidireccionales con el botón Acción.

    Una vez que se realiza la llamada de emergencia silenciosa, solo la otra parte puede terminar la llamada. Para evitar llamar la atención durante la llamada en curso, la pantalla del teléfono 9811 y 9841 se congelará, mientras que la pantalla del teléfono 9851, 9861 y 9871 se apagará. El teléfono bloquea todas las funciones durante una llamada de emergencia silenciosa, de forma predeterminada. Para permitir que los usuarios restauren el funcionamiento normal del teléfono mientras mantienen la llamada de emergencia silenciosa, active la función Permitir recuperación silenciosa de llamadas de emergencia.

  • Cuando está desactivada, la llamada de emergencia funciona como una llamada bidireccional, similar a otras llamadas salientes.

Permitir recuperación silenciosa de llamadas de emergencia

Predeterminado: No

Opciones: Sí, No

Controla si los usuarios pueden recuperar la funcionalidad del teléfono durante una llamada de emergencia silenciosa. De forma predeterminada, una vez que se inicia una llamada de emergencia silenciosa, el teléfono bloquea todas las funciones hasta que el destinatario de la llamada finaliza la llamada.

Cuando este parámetro se establece en Sí, los usuarios pueden presionar cualquier tecla para restablecer el funcionamiento normal del teléfono mientras mantienen la llamada de emergencia. El audio de la llamada permanece en silencio a menos que el usuario aumente el volumen con la tecla Volumen.

HTTP Publicar solicitud para el botón Acción

El botón Acción en Cisco Desk Phone 9800 Series se puede configurar para activar aplicaciones XML a través de solicitudes HTTP Post.

En el 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 $SSpuede agregar al 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 XML y JSON:

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer username:$SS'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 

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 Communications Manager(UCM) requiere un porcentaje de codificación para los caracteres reservados de acuerdo con RFC 3986.

Tabla 2. Porcentaje de codificación para caracteres reservados
CarácterCodificació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 3. Macros compatibles
Nombre de la macroExpansión macro
#DEVICENAME#El nombre del dispositivo que aparece en el sistema de llamadas. Por ejemplo, SEP845A3EC21288
$SSService Secret que presenta una cadena enmascarada en la página de configuración del teléfono, como secreto de autenticación, token o contraseña.
¿Ha encontrado este artículo útil?
¿Ha encontrado este artículo útil?