Personalizar el botón Acción

Las opciones personalizadas para el botón Acción en Cisco Desk Phone 9800 Series requieren compatibilidad específica con firmware de PhoneOS. Consulte la siguiente tabla para obtener más información:

FunciónVersión de firmware requerida
Llamada de emergenciaPhoneOS 3.0.1 y versiones posteriores
Servicio personalizadoPhoneOS 3.2.1 y versiones posteriores
Múltiples disparadoresPhoneOS 3.3.1 y versiones posteriores
Publicación HTTPPhoneOS 3.3.1 y versiones posteriores
Varios eventos en un solo desencadenadorPhoneOS 3.4.1 y versiones posteriores
1

Inicie sesión en la administración de Cisco Unified Communications Manager.

2

Realice una de las siguientes acciones según sea necesario:

  • Para configurar todos los teléfonos implementados, vaya a Configuración de teléfono > sistema-empresa.
  • Para configurar teléfonos que compartan el mismo perfil de teléfono, vaya a Configuración > 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 de cada dispositivo tiene prioridad sobre la configuración del perfil de teléfono común y del nivel de empresa
  • La configuración común del perfil de teléfono anula la configuración de nivel empresarial

3

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

Hay tres grupos de parámetros para el botón Acción, cada uno correspondiente a un servicio con un desencadenador único. Si se especifica un desencadenador de servicio en varios grupos, la configuración del Grupo 1 tiene prioridad sobre la 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 la 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 de botón de acción (opcional): especifique un nombre para el servicio asociado al desencadenador de acción. Este nombre se mostrará 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á Llamada de emergencia como nombre para mostrar.

    • Retraso de marcación: 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 de 5 segundos. Si se establece en 0, la llamada se realiza inmediatamente después de detectar el desencadenante.

    • Disparador de servicio Seleccione un disparador de la lista: Pulsación simple, Pulsación larga o Pulsación 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á habilitada, el audio es silencioso en el lado de la persona que llama para evitar llamar la atención durante la llamada. Solo el destinatario de la llamada puede finalizar la llamada de emergencia silenciosa.

      Durante una llamada de emergencia silenciosa, la pantalla del teléfono 9841 se congelará, mientras que la pantalla de los teléfonos 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 finaliza 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: escriba la URL del servicio personalizado. La URL debe empezar por 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 al desencadenador. Este nombre se mostrará en el mensaje en pantalla cuando el usuario presione el botón, indicando qué servicio se activará. Si no se especifica ningún nombre, se utilizará el servicio personalizado como nombre para mostrar.

    • Campo de contenido personalizado (opcional): si desea permitir que el teléfono envíe una solicitud HTTP Post cuando se presiona el botón Acción, ingrese los datos HTTP, como el método, el encabezado y el contenido de la publicación, con una longitud máxima de 1024 caracteres.

      Para ver ejemplos del script POST y la sintaxis, vea Solicitud HTTP Post para el botón Acción.

    • Retraso de marcación: 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 de 5 segundos. Cuando se establece en 0, el evento se inicia inmediatamente después de la detección del desencadenador.

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

    • Secreto de servicio (opcional): introduzca el secreto de autenticación, el token o la contraseña si el servicio personalizado requiere autenticación para acceder a él. 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.

  • Múltiples disparadores

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

  • Un único desencadenador para varios 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: escriba el número de teléfono al que desea llamar y la dirección URL del servicio XML en este formato:

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

      La URL debe empezar por 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 al desencadenador. Este nombre se mostrará en el mensaje en pantalla cuando el usuario presione el botón, indicando qué servicio se activará. Si no se especifica ningún nombre, se utilizará el servicio personalizado como nombre para mostrar.

    • Campo de contenido personalizado (opcional): si desea permitir que el teléfono envíe una solicitud HTTP Post cuando se presiona el botón Acción, ingrese los datos HTTP, como el método, el encabezado y el contenido de la publicación, con una longitud máxima de 1024 caracteres.

      Para ver ejemplos del script POST y la sintaxis, vea Solicitud HTTP Post para el botón Acción.

    • Retraso de marcación: 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 de 5 segundos. Cuando se establece en 0, el evento se inicia inmediatamente después de la detección del desencadenador.

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

    • Secreto de servicio (opcional): introduzca el secreto de autenticación, el token o la contraseña si el servicio personalizado requiere autenticación para acceder a él. 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): si ha incluido un número de teléfono o un URI de marcación en el destino del servicio, al activar esta función se silenciarán las llamadas de emergencia.

      De forma predeterminada, la llamada de emergencia funciona como una llamada bidireccional, similar a otras llamadas salientes. Cuando se establece en habilitado, el audio es silencioso en el lado de la persona que llama para evitar llamar la atención durante la llamada. Sólo el destinatario de la llamada puede finalizar la llamada.

      Durante una llamada de emergencia silenciosa, la pantalla del teléfono 9841 se congelará, mientras que la pantalla de los teléfonos 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 finaliza 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 acerca de estos parámetros, consulte Parámetros del botón Acción.

4

Seleccione Guardar.

5

Seleccione Aplicar configuración.

Referencias

Parámetros del 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 del botón Acción
ParámetroValores predeterminados y opcionesDescripción
Función del botón de acción 1 ~ 3

Valor predeterminado: desactivado

Opciones: Desactivado, Llamada de emergencia, Personalizado

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

  • Desactivado: Cuando está configurado 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 Personalizada, asegúrese de ingresar el destino del servicio en el campo Destino de servicio del botón de acción. O bien, el teléfono mostrará un error de configuración.

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

Valor predeterminado: Empty (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.

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

Valor predeterminado: Empty (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, escriba la URL del servicio. La URL debe empezar por 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, introduzca tel:<phonenumber o URL SIP> + <Service RUL>. Ejemplo: tel:1234 + https://10.11.20.159/path/service.xml.

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

Si activa el botón Acción sin establecer un destino de servicio válido, el usuario verá en el teléfono un mensaje solicitando 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 que indica que el botón no está configurado. En su lugar, puede agregar un número de teléfono en este formato tel:<número de teléfono>, por ejemplo, tel:1234.

Si no tiene permitido introducir una URL que incluya la y comercial (&), utilice %26 como sustituto. 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

Valor predeterminado: Empty (Vacío)

Esta configuración sólo funciona cuando la función del botón de acción está establecida en Personalizada.

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 está configurado, 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 $SS como referencia al secreto de servicio.

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

Secreto de servicio 1~3

Valor predeterminado: Empty (Vacío)

Un secreto de servicio 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.

Desencadenante de servicio 1 ~ 3

Valor predeterminado: Pulsación única

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

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

Pulsación única: Pulse el botón Acción para activar la llamada o servicio asociado.

Pulsación prolongada: pulse el botón Acción durante al menos 2 segundos para activar la llamada o el servicio asociado.

Pulsar 3 veces: Pulse 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 desencadenador 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 marcado 1 ~ 3

Valor 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.

Configúrelo 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, pulsación larga o triple pulsación del botón.

Llamada de emergencia silenciosa 1 ~ 3

Valor predeterminado: Disabled (Deshabilitado)

Opciones: Habilitado, Deshabilitado

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á habilitada, los usuarios pueden realizar llamadas unidireccionales con el botón Acción.

    Después de realizar la llamada de emergencia silenciosa, solo la otra parte puede finalizar la llamada. Para evitar llamar la atención durante la llamada en curso, la pantalla del teléfono 9841 se congelará, mientras que la pantalla de los teléfonos 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 restablezcan 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

Valor predeterminado: no

Opciones: Sí y 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.

Solicitud HTTP Post para el botón Acción

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

En Campo de contenido personalizado, introduzca el script de solicitud personalizado. Puede especificar el tipo de contenido XML o JSON e incluir macros en la solicitud. Por ejemplo, se pueden 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 se encuentran en XML y JSON:

Ejemplo #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":"Esto es para HTTP POST JSON"}]}'

Cisco Unified Communications Manager (UCM) requiere codificación porcentual para los caracteres reservados de acuerdo con RFC 3986.

Tabla 2. Porcentaje de codificación para caracteres reservados
CarácterCodificación porcentual
&%26
'%27
” (Activar saludo <nombre del saludo> hasta el <fecha> a las <hora>)%22
< %3c
> %3e

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

--method POST --header %27Content-Type: application/xml%27 --body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eEsto es para HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27
Tabla 3. Macros soportadas
Nombre de macroExpansión de macros
#DEVICENAME#El nombre del dispositivo que se muestra en el sistema que llama. Por ejemplo, SEP845A3EC21288
$SSSecreto de servicio que presenta una cadena enmascarada en la página de configuración del teléfono, como secreto de autenticación, token o contraseña.