Neste artigo
dropdown icon
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
    Um único acionador para configurações de parâmetros de vários eventos
    Configurar vários gatilhos
Solicitação HTTP Post para o botão Ação
Variáveis de macro suportadas em URLs XML
Configurar o botão Ação (Control Hub)
list-menuNeste artigo
list-menuComentários?

Este artigo de ajuda é para o Cisco Wireless Phone 9821 registrado em Webex Calling.

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

Na visualização do cliente no Control Hub, acesse Dispositivos e selecione seu telefone.

2

Selecione Todas as configurações.

3

Navegue até a seção Telefone e selecione Botão de ação.

4

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

5

Selecione Avançar.

6

Revise suas alterações e selecione Aplicar.

7

Selecione Fechar para fechar a página.

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

O botão Ação para chamadas de emergência garante acesso rápido e fácil à assistência crítica nos espaços de trabalho. 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 for especificado, Chamada de emergência ou Chamada de emergência silenciosa será usada 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

Quando você associa o botão Ação a um serviço personalizado, os usuários do telefone podem acessar o serviço pelo gatilho designado, como pressionar uma única vez, pressionar longamente ou pressionar três vezes o botão.

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.

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

Um único acionador para vários eventos permite que uma ação no botão de ação inicie vários processos relacionados simultaneamente. Esse recurso melhora a capacidade de resposta, reduz a complexidade e garante a execução perfeita do fluxo de trabalho em todos os aplicativos.

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:

telefone: + <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.

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.

Configurar vários gatilhos

Você pode configurar o botão Ação para se conectar a vários serviços e atribuir a cada serviço seu próprio acionador. Por exemplo, um toque longo no botão Ação faz uma chamada para o agente de emergência designado; um único toque curto no botão publica uma notificação nos telefones da empresa.

1

Defina Service Trigger como MultiTrigger.

  • Quando a opção MultiTrigger é selecionada, somente as configurações na seção Service Trigger MultiTrigger serão aplicadas, enquanto as configurações relacionadas ao botão Ação fora dessa seção serão ignoradas.

  • Certifique-se de configurar pelo menos um acionador quando a opção MultiTrigger for selecionada.

2

Vá para Service Trigger MultiTrigger e selecione o gatilho desejado entre as opções disponíveis - Pressão única, Pressão longa e Pressão 3 vezes.

3

Configure os seguintes parâmetros para o gatilho selecionado:

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

Parâmetro

Configurações

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

Selecione o serviço que os usuários do telefone podem acessar por meio do gatilho.

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

Insira o número de telefone ou o URI do serviço.

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.

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.

4

Continue seguindo as etapas 2 e 3 para configurar mais gatilhos.

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.

Em Campo de conteúdo personalizado, insira o script de solicitação. Você pode especificar o tipo de conteúdo XML ou JSON e incluir macros na solicitação.

Os exemplos a seguir estão em XML e JSON:

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 

Sample #2: JSON
--method POST
--header 'Content-Type: application/json'
--body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}' 

O exemplo a seguir é para uma solicitação HTTP Post.

--method POST
--header 'Content-Type: application/xml'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>'
Tabela 5. Macros compatíveis
Nome da macroExpansão macro
#DEVICENAME#O nome do dispositivo exibido no sistema de chamada; por exemplo, SEPE8BCE4956A29.
$MAEndereço MAC usando dígitos hexadecimais minúsculos (000e08aabbcc).
$MCASTADDREndereço do aplicativo de paginação multicast.

$PN

$PSN

Nome do produto; por exemplo, WP-9821.
$SNCadeia de caracteres do número de série; por exemplo, FVH29513116.

Variáveis de macro suportadas em URLs XML

Você pode usar variáveis de macro em URLs XML. As seguintes variáveis macro são suportadas:

  • ID de usuário — UID1, UID2 a UIDn

  • Nome de exibição — DisplayName1, DISPLAYNAME2 para DisplayNameN

  • ID de autenticação — AUTHID1, AUTHID2 a AuthIDN

  • Proxy — PROXY1, PROXY2 a ProxyN

  • Endereço MAC usando dígitos hexadecimais minúsculos — MA

  • Nome do produto — PN

  • Número de série do produto — PSN

  • Número de série — SERIAL_NUMBER

Tabela 6. Macros compatíveis
Nome da macroExpansão macro
$O formulário $$ se expande para um único caractere $.
De A a PSubstituídos pelos parâmetros de uso geral GPP_A a GPP_P.
SA a SDSubstituídos por parâmetros de propósito especial GPP_SA a GPP_SD. Esses parâmetros contêm chaves ou senhas usadas no provisionamento.

$SA a $SD são reconhecidos como argumentos para o qualificador opcional de URL de ressincronização, --key.

MAEndereço MAC usando dígitos hexadecimais minúsculos (000e08aabbcc).
MAUEndereço MAC usando dígitos hexadecimais maiúsculos (000E08AABBCC).
MACEndereço MAC usando dígitos hexadecimais minúsculos com dois pontos para separar pares de dígitos hexadecimais (00:0 e:08:aa:bb:cc).
PNNome do produto; por exemplo, Cisco Wireless Phone 9821.
PSNNúmero de série do produto; por exemplo, 9821.
SNCadeia de caracteres do número de série; por exemplo, FVH29513116.
CCERTStatus do certificado de cliente SSL, instalado ou não instalado.
IPEndereço IP do telefone em sua sub-rede local; por exemplo, 192.168.1.100.
EXTIPIP externo do telefone, conforme visto na internet; por exemplo, 66.43.16.52.

SWVER

Cadeia de caracteres da versão do software Por exemplo, PHONEOS-9821.5-0-1-0004-19.

HWVER

Sequência de caracteres da versão de hardware Por exemplo, 2.0.1

PRVST

Estado de provisionamento (uma sequência numérica):

-1 = solicitação explícita de ressincronização

0 = ressincronização de inicialização

1 = ressincronização periódica

2 = falha na ressincronização, tente novamente

UPGST

Estado da atualização (uma sequência numérica):

1 = primeira tentativa de atualização

2 = falha na atualização, tente novamente

UPGERR

Mensagem de resultado (ERR) da tentativa anterior de atualização; por exemplo, http_get falhou.

PRVTMR

Segundos desde a última tentativa de ressincronização.

UPGTMR

Segundos desde a última tentativa de atualização.

REGTMR1

Segundos desde que a Linha 1 perdeu o registro no servidor SIP.

REGTMR2

Segundos desde que a Linha 2 perdeu o registro no servidor SIP.

UPGCOND

Nome da macro legada.

SCHEME

Esquema de acesso a arquivos, TFTP, HTTP ou HTTPS, conforme obtido após a análise do URL de ressincronização ou atualização.

SERV

Solicite o nome do host do servidor de destino, conforme obtido após a análise do URL de ressincronização ou atualização.

SERVIP

Solicite o endereço IP do servidor de destino, conforme obtido após a análise do URL de ressincronização ou atualização, possivelmente após a pesquisa de DNS.

PORT

Solicite a porta UDP/TCP de destino, conforme obtida após a análise do URL de ressincronização ou atualização.

PATH

Solicite o caminho do arquivo de destino, conforme obtido após a análise do URL de ressincronização ou atualização.

ERR

Mensagem de resultado da tentativa de ressincronização ou atualização. Útil apenas na geração de mensagens de syslog de resultados. O valor é preservado na variável UPGERR no caso de tentativas de atualização.

UIDN

O conteúdo do parâmetro de configuração Line n UserID.

ISCUST

Se a unidade for personalizada, valor=1, caso contrário, 0.

O status da personalização pode ser visualizado na página de informações da interface do usuário da Web.

INCOMINGNAMENome associado à primeira chamada conectada, tocando ou recebida.
REMOTENUMBER

Número de telefone da primeira chamada conectada, tocando ou recebida. Se houver várias chamadas, os dados associados à primeira chamada encontrada serão fornecidos.

Exibir nomesO conteúdo do parâmetro de configuração Line N Display Name.
ID de autenticaçãoO conteúdo do parâmetro de configuração do ID de autenticação da Linha N.
Este artigo foi útil?
Este artigo foi útil?