Personalizar o botão Ação

As opções personalizadas do botão Ação do Telefone de mesa Cisco série 9800 exigem suporte de firmware phoneOS específico. Consulte a seguinte tabela para obter detalhes:

RecursoVersão de firmware obrigatória
Chamada de emergênciaPhoneOS 3.0.1 e posterior
Serviço personalizadoPhoneOS 3.2.1 e posterior
Vários acionadoresPhoneOS 3.3.1 e posterior
Postagem HTTPPhoneOS 3.3.1 e posterior
Múltiplos eventos em um único gatilhoPhoneOS 3.4.1 e posterior
1

Faça logon no Cisco Unified Communications Manager Administration.

2

Execute uma das seguintes ações conforme a necessidade:

  • Para configurar todos os telefones implantados, vá para Configuração do telefone > Enterprise do sistema.
  • Para configurar os telefones que compartilham o mesmo perfil de telefone, vá para Configurações > Configurações do dispositivo> Perfil de telefone daCommon.
  • Para configurar um telefone individual, vá para Dispositivo > Phone. Em seguida, encontre o telefone e abra a página Configuração do telefone.

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

  • As configurações individuais do dispositivo têm precedência sobre as configurações no perfil de telefone 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 do Grupo 1 terão prioridade em relação às 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 Ação: selecione Chamada de emergência.

    • Destino de serviço da tecla de ação: digite o número de telefone ou o URI do serviço de emergência.

    • Nome do serviço da tecla 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 de discagem para saída: defina o período de tempo limite (em segundos) para o telefone iniciar uma chamada de emergência após o gatilho ter sido detectado. O valor predefinido é 5 segundos. Se configurada para 0, a chamada é feita imediatamente ao detectar o gatilho.

    • Disparador de serviço Selecione um gatilho na lista: Imprensa única, Pressione longa 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 efetuadas. Quando a chamada de emergência silenciosa está ativada, o áudio é silencioso no lado do chamador para evitar chamar a atenção durante a chamada onging. Apenas o destinatário da chamada pode terminar a chamada de emergência silenciosa.

      Durante uma chamada de emergência silenciosa, a tela do telefone 9841 será congelada, enquanto a tela do telefone 9851, 9861 e 9871 será desligada. Todas as outras funções são inacessível. O telefone restaura a operação normal após o destinatário encerrar a chamada.

    • Permitir recuperação silenciosa de chamadas de emergência (opcional): ative este recurso se 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 em silêncio, 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 Ação: selecione Personalizar.

    • Destino de serviço da tecla ação: digite a URL do serviço personalizado. O URL deve começar com http:// or https://, por exemplo, https://10.11.20.159/path/service.xml.

    • Nome do serviço da tecla 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 desejar permitir que o telefone envie uma solicitação de postagem HTTP quando o botão Ação for pressionado, insira os dados HTTP, como método, cabeçalho e conteúdo da postagem, com um comprimento máximo de 1024 caracteres.

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

    • Atraso de discagem para saída: defina o período de tempo limite, em segundos, para que o telefone inicie um evento após detectar o gatilho. O valor predefinido é 5 segundos. Quando definido como 0, o evento é iniciado imediatamente após a detecção do gatilho.

    • Disparador de serviço Selecione um gatilho na lista: Imprensa única, Pressione longa ou pressione 3 vezes.

    • Segredo de serviço(opcional): digite o segredo da autenticação, token ou 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 $SS no Campo de conteúdo personalizado e no Destino de serviço do botão de ação.

  • Vários acionadores

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

  • Um único disparador para vários eventos

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

    • Função do botão Ação: selecione Personalizar.

    • Destino de serviço da tecla ação: digite o número de telefone a ser chamado e a URL de serviço da XML nesse formato:

      tel:< número do telefone ou URI> SIP + <serviceURL>

      O URL deve começar com http:// or https://.

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

    • Nome do serviço da tecla 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 desejar permitir que o telefone envie uma solicitação de postagem HTTP quando o botão Ação for pressionado, insira os dados HTTP, como método, cabeçalho e conteúdo da postagem, com um comprimento máximo de 1024 caracteres.

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

    • Atraso de discagem para saída: defina o período de tempo limite, em segundos, para que o telefone inicie um evento após detectar o gatilho. O valor predefinido é 5 segundos. Quando definido como 0, o evento é iniciado imediatamente após a detecção do gatilho.

    • Disparador de serviço Selecione um gatilho na lista: Imprensa única, Pressione longa ou pressione 3 vezes.

    • Segredo de serviço(opcional): digite o segredo da autenticação, token ou 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 $SS no Campo de conteúdo personalizado e no Destino de serviço do botão de ação.

    • Chamada de emergência silenciosa (opcional): se você tiver incluído um número de telefone ou discando URI no destino do serviço, a ativação deste recurso silenciará as chamadas de emergência.

      Por padrão, a chamada de emergência funciona como uma chamada bidirecional, semelhante a outras chamadas efetuadas. Quando configurado para ativação, o áudio é silencioso no lado do chamador para evitar chamar a atenção durante a chamada onging. Apenas o destinatário da chamada pode encerrar a chamada.

      Durante uma chamada de emergência silenciosa, a tela do telefone 9841 será congelada, enquanto a tela do telefone 9851, 9861 e 9871 será desligada. Todas as outras funções são inacessível. O telefone restaura a operação normal após o destinatário encerrar a chamada.

    • Permitir recuperação silenciosa de chamadas de emergência (opcional): ative este recurso se 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 em silêncio, 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 da ação.

4

Selecione Salvar.

5

Selecione Aplicar config.

Referências

Parâmetros do botão Ação

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

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

Padrão: desativada.

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

Você pode configurar a tecla com um serviço específico.

  • Desligado: quando configurado para Desligar, o botão Ação para serviço único 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.

Quando você definir o campo como Chamada de emergência ou Personalizado, assegure-se de digitar o destino do serviço no campo Destino do serviço da tecla ação . Ou o telefone exibirá um erro de configuração.

Nome do serviço da tecla ação 1~3

Padrão: vazio

Se desejar, 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 de acordo com sua seleção no campo Função do botão de ação .

Destino de serviço da tecla 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 à tecla Ação:

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

  • Quando configurar a tecla para um serviço personalizado, digite a URL de serviço. O URL deve começar com http:// or https://. Por exemplo, https://10.11.20.159/path/service.xml.

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

    Também é suportado chamar URIs SIP. 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. Após o usuário fechar essa notificação, o ícone de aviso permanecerá no cabeçalho da tela do telefone até que o botão esteja devidamente configurado ou desativado.

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 de serviço, uma mensagem de alerta será exibida no telefone indicando que o botão não está configurado. Em vez disso, é possível adicionar um número de telefone neste formato : tel:<phone number>, por exemplo, tel:1234.

Se não tiver permissão para inserir uma URL incluindo ampersand (&),use %26 como substituição. Por exemplo, insira 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 de postagem com um comprimento máximo de 1024 caracteres. Quando configurada, o telefone envia uma solicitação de postagem HTTP quando a ação é pressionada.

Se o serviço requer autenticação para acessar, assegure-se de inserir o segredo da autenticação no campo Segredo do Serviço. Nos dados HTTP, use a macro $SS como referência ao Segredo do Serviço.

Por exemplos e a sintaxe, consulte a solicitação de postagem de HTTP para o botão Ação.

Serviço Secreto 1~3

Padrão: vazio

Um serviço secreto 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 $SS no Campo de conteúdo personalizado e no Destino de serviço do botão de ação.

Disparador de serviço 1~3

Padrão: Imprensa única

Opções: Pressione uma única vez, Pressione longa, pressione 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 simples: pressione a tecla Ação para acionar a chamada ou o serviço associados.

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

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

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

Atraso de Discagem de Saída 1~3

Padrão: 5

Opções: 0 a 30

Defina o período de tempo limite, em segundos, para que o telefone inicie uma chamada de emergência ou uma ação personalizada após o botão Ação ter sido pressionado.

Defina-o como 0 se preferir que o telefone faça a chamada ou inicie um evento imediatamente ao detectar o gatilho, conforme especificado por uma única prensa, pressione longa ou triplamente a tecla.

Chamada de emergência silenciosa 1~3

Padrão: Desabilitado

Opções: Habilitado, Desabilitado

A chamada de emergência silenciosa é desenvolvida para assistência discreta em situações perigosas. Permite aos usuários procurar ajuda sem fazer nenhum ruído.

  • Quando ativada, os usuários conseguem efetuar chamadas unidirecionalmente com a tecla Ação.

    Depois que a chamada de emergência silenciosa for efetuada, somente a outra parte poderá encerrá-la. Para evitar chamar a atenção durante a chamada em andamento, a tela do telefone 9841 será congelada, enquanto a tela no telefone 9851, 9861 e 9871 será desativada. O telefone bloqueou 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 de chamada de emergência silenciosa.

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

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

Padrão: No

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 em silêncio, a menos que o usuário aumente o volume usando a tecla Volume.

Solicitação de postagem de HTTP para o botão Ação

O botão Ação no Telefone de mesa cisco 9800 Series pode ser configurado para acionar aplicativos XML por meio de solicitações de POST HTTP.

No campo 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 adicionada ao script para recuperar o segredo da autenticação, token ou senha fornecido no campo Segredo do serviço.

Os seguintes exemplos estão no XML e no JSON:

Exemplo #1: XML --método POST -- cabeçalho 'Tipo de conteúdo: aplicativo/xml' -- cabeçalho 'Autorização: Nome de usuário do portador:$SS' --corpo '<MetaData><Trigger>True</Trigger><Description>Isso é para HTTP POST XML</Description></MetaData>' Exemplo #2: JSON --método POST --cabeçalho 'Tipo de conteúdo: aplicativo/json' --cabeçalho 'Autorização: $SS' --corpo '{"eventos":[{"evtid":"12345",  "parâmetros": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]} '

O Cisco Unified Communications Manager (UCM) exige codificação percentual para os caracteres reservados de acordo com o RFC 3986.

Tabela 2. Percentual da codificação para caracteres reservados
PersonagemPercentual, codificação
&%26
'%27
"%22
< %3c
> %3e

O script a seguir é um exemplo que usa cadeias de caracteres codificadas por percentual.

--método POST --cabeçalho %27Content-Type: aplicativo/xml%27 --corpo %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eThis é para HTTP POST XML%3c/Descrição%3e%3c/MetaData%3e%27e%27
Tabela 3. Macros compatíveis
Nome da macroExpansão de macros
#DEVICENAME#O nome do dispositivo exibido no sistema de chamada. Por exemplo, SEP845A3EC21288
$SSService Secret que apresenta uma cadeia de caracteres mascarada na página de configuração do telefone, como autenticação secreta, token ou senha.