Configurar o botão Ação (Unified CM)

O botão Ação é o botão vermelho localizado no lado direito do Cisco Wireless Phone 9821. Ele permite que os usuários acessem rapidamente os serviços designados, como serviços de emergência ou personalizados. Você pode personalizar o botão para iniciar eventos adequados aos seus casos de uso específicos.

Personalize o botão Ação

1	EmCisco Unified Communications Manager Administration, execute uma das seguintes ações conforme necessário: Para configurar todos os telefones implantados, vá para Sistema > Configuração do telefone corporativo. Para configurar telefones que compartilham o mesmo perfil de telefone, acesse Dispositivo > Configurações do dispositivo > Perfil de telefone comum. Para configurar um telefone individual, vá para Dispositivo > Telefone. Em seguida, localize seu telefone e abra a página de configuração do telefone. A configuração segue uma estrutura hierárquica: As configurações de dispositivos individuais têm precedência sobre as configurações no perfil telefônico comum e no nível corporativo. As configurações comuns do perfil do telefone substituem as configurações de nível corporativo
2	Personalize os parâmetros do botão Ação com base em seus casos de uso. Há três grupos de parâmetros para o botão Ação, cada um correspondendo a um serviço com um gatilho exclusivo. Se um acionador de serviço for especificado em vários grupos, as configurações no Grupo 1 terão prioridade sobre as do Grupo 2 e 3, enquanto o Grupo 2 terá prioridade sobre o Grupo 3. Chamadas de emergência Serviços personalizados Vários gatilhos Um único gatilho para vários eventos 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 de chamadas de emergência

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

Tabela 1. Configurações de parâmetros de 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 acionador. 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 é especificado `Emergency call`ou `Silent emergency call`será usado como nome de exibição.
Atraso na discagem	Defina o período de tempo limite, em segundos, para o telefone iniciar um evento após detectar o gatilho. O valor padrão é 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 cenários de chamadas de emergência, o Cisco Wireless Phone 9821 vibra continuamente enquanto a tela de atraso é exibida. No entanto, para chamadas ou sinais silenciosos de emergência, o Cisco Wireless Phone 9821 não vibra.
Acionador de serviço	Selecione um gatilho na lista: Pressione uma vez, pressione longamente ou pressione 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 de saída. Quando a chamada de emergência silenciosa está ativada, o áudio fica silencioso no lado do chamador para evitar 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 Cisco Wireless Phone 9821 será desligada. Todas as outras funções estão inacessíveis. O telefone restaura a operação normal depois que o destinatário encerra a chamada.
Permitir recuperação silenciosa de chamadas de emergência	(Opcional) Ative esse recurso se você permitir que os usuários pressionem qualquer tecla para restaurar a operação 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 Volume.

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

Configure os parâmetros a seguir 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. O 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 acionador. 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, o serviço personalizado será usado como nome de exibição.
Campo de conteúdo personalizado	(Opcional) Se você quiser permitir 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 postagem, com um tamanho máximo de 1024 caracteres. Para exemplos de scripts POST e a sintaxe, consulte Solicitação HTTP Post para o botão Ação.
Atraso na discagem	Defina o período de tempo limite, em segundos, para o telefone iniciar um evento após detectar o gatilho. O valor padrão é 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 cenários de serviços personalizados, o Cisco Wireless Phone 9821 vibra continuamente enquanto a tela de atraso é exibida.
Acionador de serviço	Selecione um gatilho na lista: Pressione uma vez, pressione longamente ou pressione 3 vezes.
Segredo de serviço	Defina uma string secreta que pode ser um segredo de autenticação, token ou senha. O segredo inserido é exibido como uma string mascarada e pode ser referenciado usando a macro no campo de conteúdo personalizado e `$SS`no destino do serviço do botão de ação.

Configurações de parâmetros de vários gatilhos

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

Um único acionador para configurações de parâmetros de vários eventos

Configure os parâmetros a seguir para atribuir vários eventos a um acionador.

Tabela 3. Um único acionador para configurações de parâmetros de vários 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	Digite o número de telefone para ligar e a URL do serviço XML neste formato: `tel:<phonenumber or SIP URI> + <serviceURL>` O 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 acionador. 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, o serviço personalizado será usado como nome de exibição.
Campo de conteúdo personalizado	(Opcional) Se você quiser permitir 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 postagem, com um tamanho máximo de 1024 caracteres. Para exemplos de scripts POST e a sintaxe, consulte Solicitação HTTP Post para o botão Ação.
Atraso na discagem	Defina o período de tempo limite, em segundos, para o telefone iniciar um evento após detectar o gatilho. O valor padrão é 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 Cisco Wireless Phone 9821 vibra continuamente enquanto a tela de atraso é exibida. No entanto, para chamadas ou sinais silenciosos de emergência, o Cisco Wireless Phone 9821 não vibra.
Acionador de serviço	Selecione um gatilho na lista: Pressione uma vez, pressione longamente ou pressione 3 vezes.
Segredo de serviço	Defina uma string secreta que pode ser um segredo de autenticação, token ou senha. O segredo inserido é exibido como uma string mascarada e pode ser referenciado usando a macro no campo de conteúdo personalizado e `$SS`no 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 silencioso no lado do chamador para evitar 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 Cisco Wireless Phone 9821 será desligada. Todas as outras funções estão inacessíveis. O telefone restaura a operação normal depois que o destinatário encerra a chamada.
Permitir recuperação silenciosa de chamadas de emergência	(Opcional) Ative esse recurso se você permitir que os usuários pressionem qualquer tecla para restaurar a operação 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 Volume.

Solicitação HTTP Post para o botão Ação

O botão Ação no Cisco Wireless Phone 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, o token ou a 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 '<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 CMexige codificação percentual para os caracteres reservados de acordo com a RFC 3986.

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

O script a seguir é um exemplo de uso de cadeias de caracteres codificadas por 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 compatíveis
Nome da macro	Expansão macro
#DEVICENAME#	O nome do dispositivo exibido no sistema de chamadas. Por exemplo, SEP845A3EC21288
$SS	Segredo de serviço que apresenta uma string mascarada na página de configuração do telefone, como segredo de autenticação, token ou senha.

Cisco AI Assistant

Obrigado pelos seus comentários.

Personalize o botão Ação

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

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

Configurações de parâmetros de vários gatilhos

Um único acionador para configurações de parâmetros de vários eventos

Solicitação HTTP Post para o botão Ação

Pequena empresa

Empresa

Dispositivos

Soluções para

Recursos

Empresa