Neste artigo
Personalize o botão Ação
dropdown icon
Referências
    Parâmetros para o botão Ação
    Solicitação HTTP Post para o botão Ação
Configure o botão Ação para 9800 (Unified CM)
list-menuNeste artigo
list-menuComentários?

O botão Ação é o botão vermelho localizado no canto superior direito do telefone. 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. As informações nesta página se aplicam ao Cisco Desk Phone 9800 Series registrado em Cisco Unified Communications Manager (Unified CM).

Personalize o botão Ação

As opções personalizadas para o botão Ação no Cisco Desk Phone 9800 Series exigem suporte específico ao firmware do PhoneOS. Consulte a tabela a seguir para obter detalhes:

CaracterísticaVersão de firmware necessária
Chamada de emergênciaPhoneOS 3.0.1 e versões posteriores
Serviço personalizadoPhoneOS 3.2.1 e versões posteriores
Vários gatilhosPhoneOS 3.3.1 e versões posteriores
Postagem HTTPPhoneOS 3.3.1 e versões posteriores
Vários eventos em um único gatilhoPhoneOS 3.4.1 e versões posteriores
1

Faça login emCisco Unified Communications Manager Administration.

2

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

3

Personalize as configurações do botão Ação com os seguintes parâmetros 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

    Configure os seguintes parâmetros:

    • Função do botão de ação: selecione Chamada de emergência.

    • Destino do serviço do botão de ação: insira 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 da ação. Esse nome será exibido na mensagem na tela quando o usuário pressionar o botão, indicando qual evento será iniciado. Se nenhum nome for especificado, a chamada de emergência será usada como nome de exibição.

    • Atraso na discagem: defina o período de tempo limite (em segundos) para o telefone iniciar uma chamada de emergência após a detecção do gatilho. O valor padrão é 5 segundos. Se definido como 0, a chamada é feita imediatamente após a detecção do gatilho.

    • Acionador de serviço Selecione um gatilho na lista: Pressione uma vez, pressione e segure 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 dos telefones 9811 e 9841 congelará, enquanto a tela dos telefones 9851, 9861 e 9871 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.

  • Serviços personalizados

    Configure os seguintes parâmetros:

    • Função do botão de ação: selecione Personalizado.

    • Destino do serviço do botão de ação: insira a 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 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, 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 de 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.

    • Acionador de serviço Selecione um gatilho na lista: Pressione uma vez, pressione e segure ou pressione 3 vezes.

    • Segredo do serviço (opcional): insira o segredo de autenticação, o token ou a senha se o serviço personalizado exigir autenticação para acessá-lo. O segredo inserido é exibido como uma string mascarada e pode ser referenciado usando a macro no campo de conteúdo personalizado e $SSno destino do serviço do botão de ação.

  • 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 gatilho para vários eventos

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

    • 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 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 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, 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 de 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.

    • Acionador de serviço Selecione um gatilho na lista: Pressione uma vez, pressione e segure ou pressione 3 vezes.

    • Segredo do serviço (opcional): insira o segredo de autenticação, o token ou a senha se o serviço personalizado exigir autenticação para acessá-lo. O segredo inserido é exibido como uma string mascarada e pode ser referenciado usando a macro no campo de conteúdo personalizado e $SSno destino do serviço do botão de ação.

    • Chamada de emergência silenciosa (opcional): se você incluiu um número de telefone ou URI de discagem no destino do serviço, ativar esse recurso silenciará as chamadas de emergência.

      Por padrão, a chamada de emergência funciona como uma chamada bidirecional, semelhante a outras chamadas de saída. Quando definido como ativado, 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.

      Durante uma chamada de emergência silenciosa, a tela dos telefones 9811 e 9841 congelará, enquanto a tela dos telefones 9851, 9861 e 9871 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.

Para obter mais informações sobre esses parâmetros, consulte Parâmetros para o botão Ação.

4

Selecione Salvar.

5

Selecione Aplicar configuração.

Referências

Parâmetros para o botão Ação

Os parâmetros estão disponíveis em Configuração de telefone corporativo, perfil de telefone comum e configuração de telefone individual.

Tabela 1. Parâmetros para o botão Ação
ParâmetroPadrão e opçõesDescrição
Função do botão de ação 1 ~ 3

Padrão: Desativado

Opções: Desligado, Chamada de emergência, Personalizada

Você pode configurar o botão com um serviço específico.

  • Desligado: Quando definido como Desativado, o botão Ação para um único serviço no telefone não funcionará.
  • Chamada de emergência: os usuários podem usar o botão Ação para fazer uma chamada de emergência, se configurado.
  • Personalizado: os usuários podem usar o botão Ação para acessar o serviço personalizado, se configurado.

Ao definir o campo como Chamada de emergência ou Personalizada, certifique-se de inserir o destino do serviço no campo Destino do serviço do botão Ação. Ou o telefone exibirá um erro de configuração.

Nome do serviço do botão de ação 1~3

Padrão: Vazio

Opcionalmente, especifique um nome para o serviço associado ao botão Ação. Esse nome será exibido na mensagem na tela quando o usuário pressionar o botão, indicando qual serviço será acionado.

Se você não especificar um nome, o nome padrão será Chamada de emergência, Chamada de emergência silenciosa ou Ação personalizada com base na sua seleção no campo Função do botão de ação.

Destino do serviço do botão de ação 1 ~ 3

Padrão: Vazio

Forneça o destino do serviço em um dos seguintes formatos com base no serviço atribuído ao botão Ação:

  • Para serviços de chamadas de emergência, insira um número de telefone ou o URI do serviço de emergência.

  • Ao configurar o botão para um serviço personalizado, insira o URL do serviço. O URL deve começar com http://ou https://. Por exemplo, https://10.11.20.159/path/service.xml.

  • Para configurar o botão para iniciar vários eventos com um único acionador, insira tel:<phonenumber or SIP URL> + <Service RUL>. Exemplo: tel:1234 + https://10.11.20.159/path/service.xml.

    A chamada de URIs SIP também é suportada. Insira o URI no formato de tel: sip 4567@co.webex.com

Se você ativar o botão Ação sem definir um destino de serviço válido, o usuário no telefone verá uma mensagem solicitando a configuração. Depois que o usuário fechar essa notificação, o ícone de aviso persistirá no cabeçalho da tela do telefone até que o botão seja configurado ou desativado corretamente.

Os números de telefone não podem ser usados como destinos para serviços personalizados. Se você configurar o Botão de Ação como Personalizado e inserir um número de telefone como destino do serviço, uma mensagem de alerta será exibida no telefone indicando que o botão não está configurado. Em vez disso, você pode adicionar um número de telefone nesse formato tel:<phone number>, por exemplo, tel:1234.

Se você não tiver permissão para inserir um URL incluindo e comercial (&), use %26 como substituto. Por exemplo, digite http://1.2.3.4/phone?a=1%26b=2%26c=3 em vez de http://1.2.3.4/phone?a=1&b=2&c=3.

Campo de conteúdo personalizado 1~3

Padrão: Vazio

Essa configuração funciona somente quando a Função do Botão de Ação está definida como Personalizada.

Insira os dados HTTP, como método, cabeçalho e conteúdo da postagem, com um tamanho máximo de 1024 caracteres. Quando configurado, o telefone envia uma solicitação HTTP Post quando a Ação é pressionada.

Se o serviço exigir autenticação para ser acessado, certifique-se de inserir o segredo de autenticação no campo Segredo do serviço. Nos dados HTTP, use a macro $SScomo referência ao Service Secret.

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

Segredo de serviço 1 ~ 3

Padrão: Vazio

Um segredo de serviço 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 $SSno destino do serviço do botão de ação.

Acionador de serviço 1~3

Padrão: Pressão única

Opções: Pressão única, Pressão longa, Pressão 3 vezes

Escolha como os usuários podem fazer uma chamada de emergência ou iniciar um serviço personalizado usando o botão Ação do telefone.

Pressione uma vez: pressione o botão Ação para acionar a chamada ou o serviço associado.

Pressão longa: pressione o botão Ação por pelo menos 2 segundos para acionar a chamada ou o serviço associado.

Pressione 3 vezes: pressione o botão Ação três vezes com intervalos de menos de 2 segundos entre cada pressionamento para acionar a chamada ou o serviço associado.

Não repita um gatilho em vários serviços, pois os parâmetros com prioridade mais baixa não funcionarão. A ordem de prioridade, da maior para a menor, é a seguinte: Grupo 1, Grupo 2, Grupo 3.

Atraso de saída de discagem 1 ~ 3

Padrão: 5

Opções: 0 - 30

Defina o tempo limite, em segundos, para o telefone iniciar uma chamada de emergência ou uma ação personalizada depois que o botão Ação for pressionado.

Defina-o como 0 se preferir que o telefone faça a chamada ou inicie um evento imediatamente após detectar o gatilho, conforme especificado por um único toque, pressão longa ou tripla pressão no botão.

Chamada de emergência silenciosa 1 ~ 3

Padrão: Desativado

Opções: Ativado, Desativado

A chamada de emergência silenciosa foi projetada para assistência discreta em situações perigosas. Ele permite que os usuários busquem ajuda sem fazer barulho.

  • Quando ativado, os usuários podem fazer chamadas unidirecionais com o botão Ação.

    Depois que a chamada de emergência silenciosa for feita, somente a outra parte poderá encerrar a chamada. Para evitar chamar a atenção durante a chamada em andamento, a tela dos telefones 9811 e 9841 congelará, enquanto a tela dos telefones 9851, 9861 e 9871 será desligada. O telefone bloqueia todas as funções durante uma chamada de emergência silenciosa, por padrão. Para permitir que os usuários restaurem a operação normal do telefone enquanto mantêm a chamada de emergência silenciosa, ative o recurso Permitir recuperação silenciosa de chamadas de emergência.

  • Quando desativada, a chamada de emergência funciona como uma chamada bidirecional, semelhante a outras chamadas de saída.

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

Padrão: Não

Opções: Sim, Não

Controla se os usuários podem recuperar a funcionalidade do telefone durante uma chamada de emergência silenciosa. Por padrão, quando uma chamada de emergência silenciosa é iniciada, o telefone bloqueia todas as funções até que o destinatário da chamada termine a chamada.

Quando esse parâmetro é definido como Sim, os usuários podem pressionar 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 usando a tecla Volume.

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

O botão Ação no Cisco Desk Phone 9800 Series 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 Communications Manager(UCM) exige codificação percentual para os caracteres reservados de acordo com a RFC 3986.

Tabela 2. Codificação percentual para caracteres reservados
PersonagemCodificaçã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 3. Macros compatíveis
Nome da macroExpansão macro
#DEVICENAME#O nome do dispositivo exibido no sistema de chamadas. Por exemplo, SEP845A3EC21288
$SSSegredo de serviço que apresenta uma string mascarada na página de configuração do telefone, como segredo de autenticação, token ou senha.
Este artigo foi útil?
Este artigo foi útil?