Neste artigo
dropdown icon
Personalize o botão de ação
    Configurações de parâmetros para chamadas de emergência
    Configurações de parâmetros de serviços personalizados
    Configurações de parâmetros de gatilhos múltiplos
    Um único gatilho para configurações de parâmetros de múltiplos eventos
Solicitação HTTP POST para o botão de ação
Configure o botão Ação (CM Unificado)
list-menuNeste artigo
list-menuComentários?

Este artigo de ajuda destina-se ao telefone sem fio Cisco 9821 registrado no Cisco Unified Communications Manager (Unified CM).

O botão Ação é o botão vermelho localizado no lado direito do telefone sem fio Cisco 9821. Permite aos usuários acessar rapidamente serviços específicos, como serviços de emergência ou personalizados. Você pode personalizar o botão para iniciar eventos que se adequem aos seus casos de uso específicos.

Personalize o botão de ação

1

Na Administração do Cisco Unified Communications Manager, execute uma das seguintes ações, conforme necessário:

  • Para configurar todos os telefones implantados, acesse Sistema > Configuração de telefone corporativo.
  • Para configurar telefones que compartilham o mesmo perfil de telefone, acesse Dispositivo > Configurações do dispositivo > Perfil telefônico comum.
  • Para configurar um telefone individual, acesse Dispositivo > Telefone. Em seguida, encontre seu telefone e abra a página de Configuração do Telefone.

A configuração segue uma estrutura hierárquica:

  • As configurações individuais do dispositivo têm prioridade sobre as configurações do perfil comum do telefone e do nível empresarial.
  • As configurações comuns do perfil do telefone substituem as configurações de nível empresarial.

2

Personalize os parâmetros do botão Ação de acordo com seus casos de uso.

Existem três grupos de parâmetros para o botão Ação, cada um correspondendo a um serviço com um gatilho único. Se um gatilho de serviço for especificado em vários grupos, as configurações do Grupo 1 terão prioridade sobre as do Grupo 2 e 3, enquanto o Grupo 2 terá prioridade sobre o Grupo 3.

Para obter mais informações sobre esses parâmetros, consulte Parâmetros de configuração específicos do produto.

3

Selecione Salvar.

4

Selecione Aplicar Configuração.

Configurações de parâmetros para chamadas de emergência

Configure os seguintes parâmetros para chamadas de emergência.

Tabela 1. Configurações de parâmetros para chamadas de emergência

Parâmetro

Configurações

Função do botão de ação

Selecione Chamada de emergência.

Destino do serviço do botão de ação

Digite o número de telefone ou o URI do serviço de emergência.

Nome do serviço do botão de ação

(Opcional) Especifique um nome para o serviço associado ao gatilho. Esse nome será exibido na mensagem na tela quando o usuário pressionar o botão, indicando qual serviço será acionado. Quando nenhum nome for especificado, Emergency call ou Silent emergency call serão usados como nome de exibição.

Atraso na chamada

Defina o período de tempo limite, em segundos, para que o telefone inicie um evento após detectar o gatilho. O valor padrão é de 5 segundos. Quando definido como 0, o evento é iniciado imediatamente após a detecção do gatilho.

A tela de atraso exibe um cronômetro de contagem regressiva, permitindo que o usuário cancele a ação acionada pelo botão Ação. Em situações de chamadas de emergência, o telefone sem fio Cisco 9821 vibra continuamente enquanto a tela de atraso é exibida. No entanto, para chamadas ou sinais de emergência silenciosos, o telefone sem fio Cisco 9821 não vibra.

Gatilho de serviço

Selecione um gatilho da lista: Pressionar uma vez, Pressionar e segurarou Pressionar 3 vezes.

Chamada de emergência silenciosa

(Opcional) Por padrão, a chamada de emergência funciona como uma chamada bidirecional, semelhante a outras chamadas efetuadas. Quando a chamada de emergência silenciosa está ativada, o áudio fica mudo para quem está ligando, evitando chamar a atenção durante a chamada em andamento. Somente o destinatário da chamada pode encerrar a chamada de emergência silenciosa.

Durante uma chamada de emergência silenciosa, a tela do telefone sem fio Cisco 9821 será desligada. Todas as outras funções estão inacessíveis. O telefone volta a funcionar normalmente depois que o destinatário encerra a chamada.

Permitir recuperação silenciosa de chamadas de emergência

(Opcional) Habilite este recurso se você permitir que os usuários pressionem qualquer tecla para restaurar o funcionamento normal do telefone enquanto mantêm a chamada de emergência. O áudio da chamada permanece silencioso, a menos que o usuário aumente o volume do alto-falante usando a tecla de volume.

Configurações de parâmetros de serviços personalizados

Configure os seguintes parâmetros para serviços personalizados.

Tabela 2. Configurações de parâmetros de serviços personalizados

Parâmetro

Configurações

Função do botão de ação

Selecione Personalizado.

Destino do serviço do botão de ação

Insira o URL do serviço personalizado. A URL deve começar com http:// ou https://, por exemplo, https://10.11.20.159/path/service.xml.

Nome do serviço do botão de ação

(Opcional) Especifique um nome para o serviço associado ao gatilho. Esse nome será exibido na mensagem na tela quando o usuário pressionar o botão, indicando qual serviço será acionado. Quando nenhum nome for especificado, Serviço personalizado será usado como nome de exibição.

Campo de conteúdo personalizado

(Opcional) Se desejar que o telefone envie uma solicitação HTTP POST quando o botão Ação for pressionado, insira os dados HTTP, como método, cabeçalho e conteúdo da solicitação POST, com um comprimento máximo de 1024 caracteres.

Para exemplos de script POST e a sintaxe, consulte Solicitação HTTP Post para o botão Ação.

Atraso na chamada

Defina o período de tempo limite, em segundos, para que o telefone inicie um evento após detectar o gatilho. O valor padrão é de 5 segundos. Quando definido como 0, o evento é iniciado imediatamente após a detecção do gatilho.

A tela de atraso exibe um cronômetro de contagem regressiva, permitindo que o usuário cancele a ação acionada pelo botão Ação. Em cenários de serviços personalizados, o telefone sem fio Cisco 9821 vibra continuamente enquanto a tela de atraso é exibida.

Gatilho de serviço

Selecione um gatilho da lista: Pressionar uma vez, Pressionar e segurarou Pressionar 3 vezes.

Segredo de serviço

Defina uma sequência secreta que pode ser um segredo de autenticação, um token ou uma senha. O segredo inserido é exibido como uma string mascarada e pode ser referenciado usando a macro $SS em Campo de Conteúdo Personalizado e Destino do Serviço do Botão de Ação.

Configurações de parâmetros de gatilhos múltiplos

Defina os parâmetros em cada grupo respectivamente. Consulte as seções Chamadas de emergência e Serviços personalizados acima.

Um único gatilho para configurações de parâmetros de múltiplos eventos

Configure os seguintes parâmetros para atribuir vários eventos a um gatilho.

Tabela 3. Um único gatilho para configurações de parâmetros de múltiplos eventos

Parâmetro

Configurações

Função do botão de ação

Selecione Personalizado.

Destino do serviço do botão de ação

Insira o número de telefone para ligar e o URL do serviço XML neste formato:

tel: +

A URL deve começar com http:// ou https://.

Exemplo: tel:1234 + https://10.11.20.159/path/service.xml

Nome do serviço do botão de ação

(Opcional) Especifique um nome para o serviço associado ao gatilho. Esse nome será exibido na mensagem na tela quando o usuário pressionar o botão, indicando qual serviço será acionado. Quando nenhum nome for especificado, Serviço personalizado será usado como nome de exibição.

Campo de conteúdo personalizado

(Opcional) Se desejar que o telefone envie uma solicitação HTTP POST quando o botão Ação for pressionado, insira os dados HTTP, como método, cabeçalho e conteúdo da solicitação POST, com um comprimento máximo de 1024 caracteres.

Para exemplos de script POST e a sintaxe, consulte Solicitação HTTP Post para o botão Ação.

Atraso na chamada

Defina o período de tempo limite, em segundos, para que o telefone inicie um evento após detectar o gatilho. O valor padrão é de 5 segundos. Quando definido como 0, o evento é iniciado imediatamente após a detecção do gatilho.

A tela de atraso exibe um cronômetro de contagem regressiva, permitindo que o usuário cancele a ação acionada pelo botão Ação. Durante chamadas de emergência e cenários de serviços personalizados, o telefone sem fio Cisco 9821 vibra continuamente enquanto a tela de atraso é exibida. No entanto, para chamadas ou sinais de emergência silenciosos, o telefone sem fio Cisco 9821 não vibra.

Gatilho de serviço

Selecione um gatilho da lista: Pressionar uma vez, Pressionar e segurarou Pressionar 3 vezes.

Segredo de serviço

Defina uma sequência secreta que pode ser um segredo de autenticação, um token ou uma senha. O segredo inserido é exibido como uma string mascarada e pode ser referenciado usando a macro $SS em Campo de Conteúdo Personalizado e Destino do Serviço do Botão de Ação.

Chamada de emergência silenciosa

(Opcional) Por padrão, a chamada de emergência funciona como uma chamada bidirecional, semelhante a outras chamadas de saída. Quando a chamada de emergência silenciosa está ativada, o áudio fica mudo para quem está ligando, evitando chamar a atenção durante a chamada em andamento. Somente o destinatário da chamada pode encerrar a chamada de emergência silenciosa.

Durante uma chamada de emergência silenciosa, a tela do telefone sem fio Cisco 9821 será desligada. Todas as outras funções estão inacessíveis. O telefone volta a funcionar normalmente depois que o destinatário encerra a chamada.

Permitir recuperação silenciosa de chamadas de emergência

(Opcional) Habilite este recurso se você permitir que os usuários pressionem qualquer tecla para restaurar o funcionamento normal do telefone enquanto mantêm a chamada de emergência. O áudio da chamada permanece silencioso, a menos que o usuário aumente o volume do alto-falante usando a tecla de volume.

Solicitação HTTP POST para o botão de ação

O botão Ação do telefone sem fio Cisco 9821 pode ser configurado para acionar aplicativos XML por meio de solicitações HTTP Post.

No campo de conteúdo personalizado, insira seu script de solicitação personalizado. Você pode especificar o tipo de conteúdo XML ou JSON e incluir macros na solicitação. Por exemplo, $SSpode ser adicionado ao script para recuperar o segredo de autenticação, token ou senha fornecidos no campo Segredo do Serviço.

Os exemplos a seguir estão em XML e 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"}]}' 

O Cisco Unified CM exige codificação percentual para os caracteres reservados, em conformidade com a RFC 3986.

Tabela 4. Codificação percentual para caracteres reservados
PersonagemCodificação percentual
&%26
'%27
"%22
< %3c
> %3e

O script a seguir é um exemplo de uso de strings codificadas em porcentagem.

--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
Tabela 5. Macros suportadas
Nome da macroExpansão macro
#DEVICENAME#O nome do dispositivo exibido no sistema de chamada. Por exemplo, SEP845A3EC21288
$SSO Segredo do Serviço é uma sequência de caracteres mascarada exibida na página de configuração do telefone, como um segredo de autenticação, token ou senha.
Este artigo foi útil?
Este artigo foi útil?