Runapp

Esta página de ajuda é para Desktop Studio. Estas informações também estão disponíveis para Studio.

Ícone de Runapp: estrela

Inicia a funcionalidade personalizada do script, iniciando especificamente um formulário, página da Web ou aplicativo. Quaisquer URLs direcionados a um painel de contato devem ser configurados para permitir a exibição em um iframe. Os Agentes devem ter a configuração Painéis em MAX definida como Ativado. Salesforce Agent e Salesforce Agent Lightning dão suporte a essa ação.

Esta ação envia informações pela ramificação Ondata.

Um uso comum de Runapp é exibir um formulário padrão ou URL personalizada para agentes com o evento ONANSWER (gerenciado com a ação Onanswer).

Você pode usar a PAGE ação para exibir Páginas HTML simples para um agente. Page é útil para criar uma sequência de itens que seguem ramificações separadas, enquanto que, a cada vez que você enviar informações com Runapp, as informações passam pela ramificação Ondata.

Em NiCE CXone Agent Workspace (Agent), esta ação exibe somente o link da URL. Ela não exibe a página por meio de iframe. Além disso, um formulário personalizado é exibido como um link. É sugerido usar a POPURL ação em vez disso.

OpenURL é o único Tipo DE ação compatível com Salesforce Agent. Se você quiser mostrar um formulário personalizado, use a Ação Indicar.

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.

O ícone para o tipo de script Chat - um balão de chat com reticências dentro (...), em formato de diamante.

O ícone do tipo de script Telefone - um fone de telefone de estilo antigo com linhas curvas indicando som saindo dele.

O ícone do tipo de script Item de trabalho - uma folha de papel com um canto dobrado e uma lista com marcadores.

O ícone do tipo de script SMS - um smartphone com um balão de bate-papo saindo dele.

O ícone do tipo de script Digital - um monitor de computador com um smartphone ao lado.

Genérico

E-mail Chat Telefone Item de trabalho SMS Digital

Comparação de ações semelhantes

As ações a seguir têm funções semelhantes, mas com algumas diferenças chave:

  • Runapp: Inicia uma funcionalidade personalizada a partir do script, especificamente abrindo um formulário, uma página da web ou um aplicativo.
  • PopURL: abre URLs de páginas da web e fornece opções de localização e estilo do painel que exibe a página da web.
  • Indicar : Estende a interface do agente com funcionalidade personalizada, especificamente um ícone que o agente clica para iniciar a função personalizada. Isso é semelhante a Runapp, exceto que, com Indicar, 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

Legenda

Insira uma frase curta que identifique exclusivamente esta ação no script. A legenda aparece na tela do script no ícone da ação. O padrão é o nome da ação.

AgentID

O id do agente.Digite um ID ou tipo para localizar um agente específico. Você pode usar uma variável para esse campo, como {agentId}.

Competências de saída têm um script personalizado atribuído; portanto, quando Runapp é acionado no script personalizado de saída, ele usa a ação Begin, já que ele já "sabe" quem é o agente (aquele que está realizando a chamada de saída). Portanto, um screen pop somente funcionará se {__agentID} for usado como o nome da variável. Para scripts de entrada, o script não "sabe" quem é o agente até que Onanswer seja acionado, o que define a variável de id do agente como AGENTID.

Você pode usar o editor de propriedade Runapp para configurar esta propriedade clicando duas vezes na ação.

ActionType

  • RunExe: NiCE CXone não é suportado. Isso requer um executável local que reside no caminho do Windows ou com o caminho completo inserido no campo ActionValue. O caminho do arquivo deve incluir barras duplas (\\) no caminho. Por exemplo, C:\\Program Files\\NiCE CXone\\studio.exe. A maioria dos navegadores modernos não oferece suporte para a execução de programas executáveis. Se quiser usar este tipo, certifique-se de que seus agentes usem um navegador compatível.
  • OpenURL: abre um navegador da web padrão para a URL especificada no campo ActionValue.
  • ShowCustomForm: Inicia um formulário html personalizado criado em Studio. Os dados capturados do formulário personalizado acionarão o ONDATA evento no script.

Você pode usar o editor propriedade RunApp para configurar esta propriedade clicando duas vezes na ação.

ActionValue

O valor necessário pelo tipo DE ação especificado. As Variáveis são suportadas nesta propriedade ao encapsular a Variável em {braces}.

  • 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 totalmente qualificado e URL. Os parâmetros de string de consulta são compatíveis. http://www.example.com/file.asp?ANI={ANI}. Você também pode personalizar o título da guia que aparece na MAX interface anexando o parâmetro icAgentPanelTitle = à URL. Este parâmetro não é suportado em NiCE CXone Agent Workspace (Agent).
  • ShowCustomForm: This field offers the ability to build a custom HTML form. Any standard form input fields may be used, including Input, Textarea, Password, Checkbox, Radio, Select, Button, and Submit. Don't include the <form> tags.

    Todo campo de entrada deve conter um nome. Os Campos sem nome serão ignorados. Exemplo, <input type="text" name="phone">.

    O script deve conter uma destas coisas para que seu formulário personalizado funcione:

    • Ondataação: Nomes e valores são retornados ao script como variáveis usando esta ação.
    • WaitForSubmit propriedade: Quando incluída e definida como True, os nomes de campo se tornam variáveis no script. Os valores de Campo se tornam o conteúdo das variáveis.

    Os campos de formulário que oferecem suporte a valores múltiplos, por exemplo, Caixa de seleção e Select, conterão uma matriz separada por vírgula.

    Múltiplos botões de envio podem ser usados utilizando os mesmos nomes ou nomes diferentes, mas qualquer botão de envio enviará os dados e fechará a janela. Se você quiser um botão que não envie, utilize um botão em vez de um botão de envio.

    Folhas de estilo vinculadas não são suportadas, você pode usar estilos embutidos. Por exemplo, <div style="position: absolute: left: 10px: top: 100px:">.

    O 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)">

Você pode usar o editor propriedade RunApp para configurar esta propriedade clicando duas vezes na ação.

WaitForSubmit

Determina se o sistema aguardará por uma ação de envio do agente. Quando definido como True, o sistema aguarda a ação de envio do agente. Os nomes de Campo se tornam variáveis no script com o valor do campo como o valor da variável. Quando definido como False, você deve incluir a ação Ondata no script, que retorna os nomes e valores dos campos para o script como variáveis.

WaitForSubmit é aplicável apenas se o Tipo de acão é ShowCustomForm. Funciona em conjunto com WaitTimeout.

Desative essa propriedade quando usar esta ação em um script que integra um CRMClosed sistemas de Terceiros que gerenciam itens como contatos, informações de vendas, detalhes de suporte e históricos de casos. com um aplicativo NiCE CXone Agent Workspace (Agent). Quando essa propriedade está ativada, o formulário fica em branco quando enviado, caso o formulário tenha atingido o tempo limite.

WaitTimeout

O número de segundos que acionará a ramificação OnTimeout se o Tipo DE ação for ShowCustomForm.

Condições do Ramo de resultado

As condições de ramificação de resultado permitem que você crie ramificações no seu script para tratar diferentes resultados quando uma ação é executada.

Condição

Descrição

Padrão

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
Enviar Path taken if WaitForSubmit is set to True.
Limite de tempo Path taken if there is no response for the number of seconds specified.

OnError

Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.

Runapp Wizard

Você também pode configurar a ação diretamente nas propriedades da ação.

  1. Dê um clique duplo na ação Runapp para abrir o assistente RunApp Property editor.
  2. Enter o id do agente para que o agente receba a ação Runapp. Para scripts outbound, use {__agentID} como o nome da variável; para todos os outros scripts, use {AGENTID}.
  3. Select the action type.
    CampoDescrição
    Executar um programa executável

    Executa um executável local. Esta opção usa um plugin Java que só funciona com o Internet Explorer, que NiCE CXone não suporta. Isso requer um executável local que reside no caminho do Windows ou com o caminho completo inserido no campo ActionValue. O caminho do arquivo deve incluir barras duplas (\\) no caminho. Por exemplo, C:\\Program Files\\NiCE CXone\\studio.exe. A maioria dos navegadores modernos não oferece suporte para a execução de programas executáveis. Se desejar usar esse tipo, certifique-se de que os agentes utilizem um navegador compatível.

    Abrir uma página da web

    Digite a URL completa da página da web no campo Comando de Ação. A página será aberta com o navegador padrão no computador local do agente.

    Solicitar ao usuário uma página da web semelhante a um formulário
    1. Enter o código HTML para gerar um formulário no campo Comando de Ação. Não é necessário incluir as tags de abertura e fechamento <form>.
    2. Clique em Visualizar para ver o formulário.
  4. Clique em OK.