RUNAPP

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

Ícone de Runapp: janela de navegador azul com um ponteiro

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

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

Icon of gray-green envelope

Ícone de balão de fala verde escuro

Icon of purple telephone handset

Icon of pink document with lines of text

Ícone de um telefone celular verde com um balão de fala na tela

Icon of purple computer monitor with a mobile device overlapping its lower right corner

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 Tipo DE ação é 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

Adicionar 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.

Id do agente

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.

Tipo DE ação

  • 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.

Valor da ação

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.

Esperar pelo envio

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.

No Modo Valor: Clique em Ativado para ativar. Deixe definido como Desativado para retornar os valores de campo ao script com a ação OnData.

No modo Expressão: Insira true para ativar. Deixe definido como false para retornar os valores de campo ao script com a ação OnData.

Tempo limite de espera

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.

Erro

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.