Indicate

This help page is for Desktop Studio. This information is also available for CXone 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.

Double-click the action to open a configuration wizard.

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

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

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.

Propriedade

Descrição

Target

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

TargetIDs

O ID do destino, como um ID de agente ou um ID de competência.

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.

ImageFile

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.

ActionType
  • RunExe: Runs a local executable. This option uses a Java plugin that only works with Internet Explorer, which CXone does not support: do not select this option. This requires a local executable that resides in the Windows path or with the full path entered in the ActionValue field. The file path must include double back slashes (\\) in the path. For example, C:\\Program Files\\CXone\\studio.exe. Most modern browsers do not support running executable programs. If you want to use this type, ensure that your agents use a compatible browser.
  • OpenURL: Opens a default web browser to the URL specified in the ActionValue field.
  • SpawnScript: Spawns a script specified in the ActionValue field and passes parameters.
  • SignalScript: Signals a script specified in the ActionValue field and passes parameters.
  • ShowCustomForm: Launches a custom HTML form created in Studio. The captured data from the custom form will trigger the ONDATA event in the script.
ActionValue

O valor necessário pela ActionType especificada. Há suporte para variáveis nessa propriedade, colocando-as entre colchetes ( { } ).

  • RunExe: O nome ou caminho para um arquivo executável do Windows. O caminho do arquivo deve incluir barras duplas (\\) no caminho. Por exemplo, C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}.
  • OpenURL : Deve ser 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 MAX anexando o parâmetro icAgentPanelTitle= ao URL.
  • SpawnScript : O nome do script que você deseja gerar. O nome deve ser o caminho completo para o script (no diretório atual do script em execução). O parâmetro SkillID do script gerado é obrigatório. Não é possível gerar o script sem uma ID de competência ACD.
  • SignalScript : O ID do script em execução que você deseja sinalizar. Normalmente você está gerando um script relacionado e pode usar {ContactID} para sinalizar o script atual. Use {MasterID} para sinalizar o script principal ou algo como {SpawnID} para sinalizar um script secundário.
  • ShowCustomForm : Este campo permite que você construa um formulário HTML personalizado. Você pode usar HTML e CSS compatíveis com um navegador moderno. Qualquer campo de entrada de formulário padrão pode ser usado, incluindo Entrada, Textarea, Password, Checkbox, Radio, Select, Button e Submit. Não inclua as tags <form> .
    • Todo campo de entrada deve conter um nome. Por exemplo, <input type="text" name="phone">. Campos sem nome são ignorados. 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. Campos de formulário que aceitam vários valores, por exemplo, Checkbox e Select, conterão uma matriz separada por vírgulas.
    • Vários botões de envio podem ser usados com o mesmo nome ou nomes 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 suportadas, mas estilos embutidos são. Por exemplo, <div style="position: absolute: left: 10px: top: 100px:">.
    • Javascript funcionará quando vinculado a um Javascript 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)">

    • Some characters used in HTML and CSS are interpreted as code, such as double quotes. To get around this, use the .char() function to add the character where it belongs. For example:

      //The double quotes in the HREF tag cause a problem:
      ASSIGN html = "ASSIGN html = "<a href="https://www.w3schools.com">Visit W3Schools</a>""
      //To get around that, replace those double quotes with the char equivalent:
      ASSIGN html = "ASSIGN html = "<a href={char(34)}https://www.w3schools.com{char(34)}>Visit W3Schools</a>"

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.

OnError

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.

Baixe este script.