Indicate

Esta página de ajuda é para CXone Studio. Esta informação também está disponível para Desktop Studio.

Estende a interface do agente com funcionalidade personalizada, especificamente um ícone no qual o agente clica para iniciar a função personalizada. Esses ícones na interface do agente podem ser usados para executar ou sinalizar um script, abrir um URL ou criar formulários básicos baseados na Web e processar seus dados.

Dependências

  • Um indicador também deve ser desativado no script ou continuará a aparecer na interface do agente após o término do contato. Normalmente, duas ações Indicate são usadas, uma para ativar o botão e outra para desativar o botão.
  • Como a ação Indicate é muito flexível, tenha muito cuidado com a programação e teste o script minuciosamente.
  • Certifique-se de que o link usado com a propriedade ImageFile é válido. Um link quebrado pode causar problemas graves de desempenho para os seus servidores CXone.
  • MAX utiliza um conjunto predefinido de imagens para todos os indicadores, com base no ActionType. Especificar uma imagem com a propriedade ImageFile com MAX não mudará as imagens que os agentes veem.

Tipos de script suportados

Um quadrado com uma linha saindo dele e indo em direção a três outros quadrados.

Genérico

E-mail Chat Telefone Correio de Voz Item de Trabalho SMS Digital

Comparação de ações similares

As ações a seguir têm funções semelhantes, mas com algumas diferença importantes.

  • Runapp: Inicia a funcionalidade personalizada do script, lançando especificamente um formulário, página da web ou aplicativo.
  • PopURL: Abre os URLs da página da web e fornece opções para a localização e o estilo do painel que exibe a página.
  • Indicate: Estende a interface do agente com funcionalidade personalizada, especificamente um ícone no qual o agente clica para iniciar a função personalizada. Isso é similar ao Runapp, mas com o Indicate o ActionType é iniciado pelo script e não pelo agente.

Propriedades de entrada

Estas propriedades definem dados que a ação usa durante a execução.

As propriedades dessa ação mudam dinamicamente conforme você as configura. Por exemplo, se você selecionar Agent como Target, o próximo campo mudará de Contact ID para Agent ID.

Propriedade

Descrição

Add Caption

Insira uma frase curta que identifica exclusivamente esta ação no script. A legenda aparece na tela do script no ícone da ação.

Target Selecione o tipo de destinatário a partir da lista suspensa:Agents, Team, Skill, Everyone ou Contact. A opção Everyone foi descontinuada. Não a selecione.
Target Id

ID de contato, ID do agente, Equipe

O ID do destino, como um ID de agente. O nome dessa propriedade varia de acordo com o Target que você escolhe.

Substituição variável é comumente usada para esta propriedade.

Name Esta propriedade é o nome ou a chave usada para identificar o valor. Pode ser qualquer nome ou número. Os nomes não diferenciam maiúsculas de minúsculas. Se tiver várias ações Indicate em uso, o nome é usado para monitorar qual ação Indicate está ativada ou desativada.
Image File

O URL de um arquivo de imagem no tenantFechado Alto nível de agrupamento organizacional usado para gerenciar o suporte técnico, cobrança e configurações globais para o seu ambiente CXone diretório no CXone servidor de arquivos. Esta é a imagem em que os agentes clicarão. O arquivo deve ser GIF, JPG ou PNG e ter 16x16 pixels de tamanho.Esta propriedade é necessária ao usar a ação Indicate no Salesforce Agent ou Salesforce Agent Lightning.

Aviso Um link quebrado para ImageFile pode causar problemas graves de desempenho para o locatário da associada. Ao usar ícones personalizados, é importante verificar se o link está correto.

Tooltip O texto que aparece quando o cursor do mouse passa o mouse sobre o ícone ou texto do indicador.
State Uma lista suspensa de On ou Off para determinar se o indicador será ou não exibido. Normalmente, você precisa de duas ações indicate com o mesmo nome: uma para ativar o botão e outra para desativar o botão.
Action Type
  • Run Exe: Executa um executável local. Essa opção usa um plug-in Java que só funciona com o Internet Explorer, ao qual o CXone não oferece suporte: não selecione essa opção.
  • Open URL: abre o navegador da Web padrão para o URL especificado no campo URL.
  • Spawn script: gera um script especificado no campo Script Name e passa parâmetros.
  • Signal script: sinaliza um script especificado no campo ActionValue e passa parâmetros.
  • Show Custom Form: inicia um formulário HTML personalizado. Cole o código HTML do formulário na propriedade Html. Os dados capturados do formulário personalizado acionam a ação do evento ONDATA no script.
URL

Especifique o URL a ser aberto. Essa propriedade somente aparecerá se você selecionar Open URL ou Run Exe como Action Type.

Para Abrir URL, você deve usar um nome de domínio e URL totalmente qualificados. Os parâmetros da string de consulta são suportados. Por exemplo, http://www.example.com/file.asp? ANI={ANI}. Você também pode personalizar o título da guia que aparece na interface do MAX anexando o parâmetro icAgentPanelTitle= ao URL.

Para Executar Exe, você deve usar um executável local que resida no caminho do Windows ou com o caminho completo inserido no campo URL. O caminho do arquivo deve incluir barras duplas (\\) no caminho. Por exemplo, C:\\Program Files\\CXone\\studio.exe. A maioria dos navegadores modernos não oferece suporte para a execução de programas executáveis. Se quiser usar esse tipo, certifique-se de que seus agentes usam um navegador compatível.

Script Name

Digite o caminho completo e o nome do script que você deseja gerar. O caminho deve ser um caminho relativo que começa na pasta em que o script atual está localizado.

Você também deve especificar o Skill#. Isso será passado para o script gerado. Você pode especificar qualquer Parameters adicional que queira passar para o script.

Essa propriedade somente aparecerá se você selecionar Spawn script como Action Type.

Skill#

Insira o número da competência ACD para passar para o script gerado.

Você também deve especificar o Script Name que deseja gerar. Você pode especificar qualquer Parameters adicional que queira passar para o script.

Essa propriedade somente aparecerá se você selecionar Spawn script como Action Type.

Contact ID

Insira a ID do script que você deseja sinalizar. Normalmente, essa é a ID do contato. Por padrão, essa propriedade usa a variável {contactId}. Você também pode usar {masterID} para sinalizar o script pai, ou algo como {spawnID} para sinalizar um script filho.

Essa propriedade somente aparecerá se você selecionar Signal script como Action Type.

Parameters

Especifique quaisquer parâmetros adicionais a serem passados para o script gerado ou para o script que está sendo sinalizado. A adição de parâmetros é opcional.

Essa propriedade somente aparecerá se você selecionar Spawn script ou Signal script como Action Type.

Html

Digite o HTML do formulário personalizado que você deseja iniciar. Você pode usar qualquer campo de entrada de formulário padrão, incluindo Input, Textarea, Password, Checkbox, Radio, Select, Button e Submit. No entanto, não inclua as tags <form>. Quando você adiciona campos:

  • Todo campo de entrada deve conter um nome. Os campos sem nome serão ignorados. Por exemplo, <input type="text" name="phone">. Nomes e valores são retornados ao script como variáveis usando a ação Ondata. Se o script não tiver a ação Ondata, o formulário será inútil. Os campos de formulário que aceitam vários valores, como Checkbox e Select, conterão uma matriz separada por vírgulas.
  • Vários botões de envio podem ser usados com nomes iguais ou diferentes, mas todo botão de envio enviará os dados e fechará a janela. Se você quiser um botão que não envie, use um botão em vez de um envio.
  • Folhas de estilo vinculadas não são aceitas, mas estilos embutidos são. Por exemplo, <div style="position: absolute; left: 10px; top: 100px;">.
  • O JavaScript funcionará quando vinculado a um script externo, mas o conteúdo deve ser HTTPS para evitar erros. Por exemplo:

    <script type="text/javascript" src="https://www.example.com/test.js"></script> <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)">

Essa propriedade somente aparecerá se você selecionar Signal script como Action Type.

Condições de ramal resultante

Condições de ramal resultante permitem que você crie ramais no seu script para atender diferentes resultados quando uma ação é executada.

Condição

Descrição

Default

Caminho percorrido, a menos que o script atenda a uma condição que exige que ele percorra um dos outros ramais. Também é percorrido se os outros ramais da ação não estiverem definidos.

Erro

Caminho tomado quando a ação não é executada corretamente. Por exemplo, quando há um problema inesperado como conectividade ruim, erros de sintaxe e assim por diante. A variável _ERR, com o caractere sublinhado, deve ser preenchida com uma explicação condensada do problema.

Dicas e truques

Fieldset e Legend são suportados para organizar os formulários de maneira mais legível. Os estilos embutidos podem ser aplicados às entidades HTML. Por exemplo:

<fieldset>
	<legend>Gender:</legend>
	<input type="radio" name="gender" value="male"/>Male
	<input type="radio" name="gender" value="female"/>Female<br/>
</fieldset>

Exemplo de script

Este é um exemplo para mostrar como esta ação pode ser usada em scripts. Ele não é voltado para um script inteiro. Criação de script adicional pode ser necessária.

Este exemplo demonstra como incorporar a ação Indicate a um script. Ele inclui exemplos de como passar diferentes tipos de dados ao script gerado. Um exemplo de um script gerado está incluído no arquivo ZIP baixável. Este é um exemplo para mostrar como esta ação pode ser usada em scripts. Ele não é voltado para um script inteiro. Criação de script adicional pode ser necessária.

Baixe este script.