GETRICHMESSAGE

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

Three shapes containing iconograhic representations of lists, imgs, and music files.

Passa o JSON de mensagem avançada para a AskCaller ação digital ou TExtMsg ação digital. Isso permite que você use modelos de mensagem avançada criados na página Digital do ponto de contato em ACD em seus scripts, em vez de criar o JSON no script.

Dependências

  • This action requires Digital Experience (DX).
  • Antes de trabalhar com scripts digitais, saiba mais sobre as diferenças entre os Scripts tradicionais ACD e os scripts digitais.
  • Deve ser usado com uma das seguintes ações: AskCaller ou TExtMsg.
  • Coloque GETRICHMESSAGE antes de AskCaller ou TExtMsg no seu script.
  • Suporte ao tipo de conteúdo de mensagens avançadas varia de acordo com o canal.

  • Crie modelos de mensagem avançada para usar com esta ação na página ponto de contato Digital em NiCE CXone. Você pode criar modelos para selecionadores de lista, de hora, links com mídia e respostas rápidas. Se você precisar usar outra mídia avançada, não poderá usar GETRICHMESSAGE. Em vez disso, você deve criar o JSON em uma ação Snippet e passá-lo diretamente para AskCaller ou TExtMsg. Consulte a seção Dependências na ajuda online para essas ações para obter mais informações.

Tipos de script suportados

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

Digital

Comparação de Ações similares

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

Propriedades de entrada

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

Propriedade

Descrição

Other

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.

channelID

Selecione o canal digital que este script usa para enviar mensagens.

Propriedades de saída

As propriedades contêm variáveis que armazenam dados retornados pela execução da ação. Elas estão disponíveis para referência e uso quando a ação é concluída.

Propriedade

Descrição

resultSet Contém o JSON retornado do NiCE CXone. Passe o conteúdo dessa variável para Askcaller ou TExtmsg como uma string JSON.

Condições de Ramificação 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.

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.

OnSucess

```

Caminho seguido se a ação for concluída sem erros e quaisquer Chamadas de API ou retornos de dados foram bem-sucedidos (códigos de resposta 2xx).

```

Código de Ação de SNIPPET obrigatório

Esta ação pode exigir uma ação Snippet com código que trata os modelos de mídia enriquecida que a ação GETRICHMESSAGE retorna do ponto de contato digital. Se o ponto de contato tiver somente um modelo, você não precisará de código de snippet. Você pode usar a variável especificada na propriedade resultId. Para pontos de contato que têm mais de um modelo, você precisa de código de snippet.

  1. Crie um modelo na página Digital de pontos de contato no aplicativo ACD e atribua-o ao ponto de contatoClosed O ponto de entrada que um contato de entrada usa para iniciar uma interação, como um número de telefone ou endereço de e-mail. com o qual deseja usá-lo. Pode ser que você precise de assistência de um administrador NiCE CXone para completar esta etapa.

  2. Crie um script com o tipo DE mídia digital.

  3. Adicione uma ação GETRICHMESSAGE action e uma ação ASKCALLER action ou uma ação TeXTMSG action. Se o ponto de contato tiver mais de um modelo, você também precisará de uma ação SNIPPET action.
  4. Configure a propriedade ChannelId em GETRICHMESSAGE com o ponto de contato ao qual você atribuiu o modelo.
  5. Add the appropriate code to the SNIPPET action:
    • Se você tiver somente um modelo ou se quiser enviar somente um modelo com este script, use código como:

      DYNAMIC json1 
      ASSIGN json1.data[1] = resultset.data[1]
    • Se você tiver múltiplos modelos e quiser poder enviar mais de um com este script, use um código como:

      DYNAMIC json1
      DYNAMIC json2
      DYNAMIC json3
      				 
      ASSIGN json1.data[1] = resultset.data[1]
      ASSIGN json2.data[1] = resultset.data[2]
      ASSIGN json3.data[1] = resultset.data[3]
  6. Altere o número índice que identifica o modelo que quer enviar. No código de exemplo da etapa anterior, você mudaria os números índice na variável resultset.data[x]. Não mude o índice na variável à qual está atribuindo o modelo. No código de exemplo, a variável é jsonY.data[Z] e você poderia mudar Y, mas não Z. Cada variável jsonY armazena um modelo.
  7. Altere os nomes de variáveis se quiser. Se fizer isto, mude os nomes das variáveis conforme necessário nas outras ações do script. Por exemplo, resultSet é o nome da variável padrão na propriedade resultSet de GETRICHMESSAGe. As variáveis jsonY são usadas na propriedade Mensagem de AskCaller e Textmsg.
  8. Configure AskCaller or Textmsg: 
    1. Defina a propriedade MessageFormat como JSON.
    2. Configure Mensagem com o nome da variável que contém o JSON do modelo que você está enviando. Ele deve ser enviado como uma string JSON. Você pode usar substituição de variável neste campo. Se fizer isso, adicione código a um Snippet para escolher o modelo a ser enviado e passar a variável correta.
    3. Configure outras propriedades das ações conforme necessário, incluindo a conexão das ramificações. Consulte a ajuda online para a ASKCALLER ação ou TeXTMSG ação.

Exemplo de script

Este é um exemplo para mostrar como essa ação pode ser usada em Scripts. Ele não é voltado para um script inteiro. Pode ser necessário um script adicional.

Este exemplo mostra a ação GETRICHMESSAGE conectada a uma ação SNIPPET, que está conectada a TeXTMSG. Também pode estar conectado a ASKCALLER. Quando o script é executado, GETRICHMESSAGE recupera os modelos de mensagem avançada disponíveis para o canal digital especificado em channelId. Eles são armazenados na variável especificada na propriedade resultId. Neste exemplo, a variável é resultId. O código do snippet contém um objeto de dados dinâmicos que armazenará um JSON específico de modelo de mensagem avançada e o passará para TeXTMSG.

Uma amostra de script contendo as ações BEGIN, GETRICHMESSAGE, SNIPPET e TEXTMSG.

Baixar este script.