Mensagens Avançadas (Rich Messaging) em Digital Scripts

DigitalClosed Qualquer canal, contato ou competência associado a Digital Experience (DX). scripts oferecem suporte a mensagens enriquecidas. mensagens enriquecidas são mensagens baseadas em texto que incluem conteúdo de mídia, como imagens, botões, seletores de lista, respostas rápidas e links avançados. Muitos canais digitais permitem o uso de mensagens enriquecidas, mas as opções de conteúdo avançado com suporte variam de acordo com o canal.

​conteúdo rico pode ser enviado diretamente ao contato ou pode ser exibido no aplicativo do agente para que os agentes interajam com ele. Por exemplo, você pode criar mensagens de resposta rápida que o agente pode optar por enviar ao contato. Ele pode ser usado em scripts que lidam com interações roteadas para agentes humanos em tempo real ou para agentes virtuais e bots.

Opções de conteúdo Rico

O conteúdo rico é enviado como JSON. O JSON deve ser estruturado de forma que o aplicativo ou sistema receptor possa interpretá-lo e exibir o conteúdo corretamente. A estrutura apropriada varia de acordo com o aplicativo e o sistema. Há vários conjuntos diferentes de esquemas usados no NiCE CXone, conforme mostrado na tabela a seguir.

Esquema Detalhes
TORM (Truly Omnichannel Rich Messaging)

TORM cria elementos de conteúdo rico que funcionam em múltiplos canaisClosed Diversos meios de comunicação por voz e digitais que facilitam as interações com o cliente em uma central de contato.. Ele oferece suporte aos seguintes elementos:

  • Cartões adaptáveis
  • Formulários
  • Seletores de lista
  • Respostas rápidas
  • Links avançados
  • Texto/HTML
  • Selecionadores de hora

A maioria dos elementos de conteúdo rico do TORM pode ser usada como esquemas JSON ou para criar modelos de mensagem. Os modelos do TORM podem ser enviados para o aplicativo do agente ou para o contato. esquemas TORM também podem ser enviados diretamente como JSON usando a API de saída digital.

Para saber mais:

Modelos não TORM

Alguns canais digitaisClosed Qualquer canal, contato ou competência associado a Digital Experience (DX). oferecem suporte a opções de conteúdo rico que usam uma estrutura JSON legada em vez de TORM. Essas opções devem ser criadas como modelos no NiCE CXone e estão disponíveis apenas para interações com agentes humanos nos seguintes canais:

Esses modelos e seus esquemas não estão disponíveis para uso em Scripts.

Adaptive Cards

Desenvolvidos pela Microsoft, Adaptive Cards An icon of a square with an arrow  pointing from the center out to the upper right corner. são um método de criação de conteúdo de mensagens avançadas (rich messaging)Closed Elementos em mensagens digitais, como botões, imagens, menus e seletores de opção.. Eles são um formato aberto de troca de cartões que permite enviar conteúdo de UI de maneira comum e consistente. Com Adaptive Cards, você pode enviar mensagens interativas que são mais complexas e úteis do que aquelas que contêm apenas elementos padrão de mídia avançada.

Atualmente, somente os canais de chat digital e Microsoft Teams oferecem suporte a Adaptive Cards. Se mensagens com Adaptive Cards forem enviadas em outros canais, o texto de fallbackClosed Uma alternativa em texto simples enviada quando o destino não oferece suporte a mídia avançada. designado será usado em seu lugar.

No momento, cartões adaptáveis podem ser usados:

  • Em mensagens enviadas a contatos em canais de chat digitais.
  • Em Bot Builder mensagens de resposta de bot.
  • Em Autopilot (Amelia) mensagens de resposta do agente virtual.
  • Para personalizar janelas de chat digital.

Para saber mais:

TORM

As mensagens avançadas apresentam um desafio em um ambiente omnichannel em que os canais se conectam a plataformas de terceiros. A maioria das plataformas tem seus próprios esquemas para conteúdo avançado. Isso significa que, para configurar um elemento de conteúdo avançado que funcione em vários canais, você deve pesquisar e codificar o JSON desse elemento para cada canal. Se uma plataforma alterar posteriormente seu esquema, isso quebra seu código.

A TORM (Truly Omnichannel Rich Media) tenta aliviar essa carga de trabalho. Ela é uma abordagem interna desenvolvida pela NiCE para simplificar o trabalho com mensagens avançadas. O TORM fornece um único conjunto de esquemas JSON para vários elementos de conteúdo rico comuns. Quando o NiCE CXone processa a mensagem, os esquemas TORM são mapeados pelos esquemas usados pela plataforma adequada. Isso elimina a necessidade de você manter múltiplos esquemas diferentes.

A tabela a seguir mostra os elementos de conteúdo avançado compatíveis com o TORM. Ela também mostra se tal elemento está disponível para uso como um modelo de mensagem, esquema JSON ou ambos.

Elemento Modelo Esquema JSON
Cartões adaptáveis Não Sim
Cartões de Contato Não Sim
Formulários Sim Não
Seletores de lista Sim Sim

Respostas rápidas

Sim

Sim
Links avançados Sim Sim
Texto/HTML Não Sim
Selecionadores de hora Sim Sim

Modelos TORM

Modelos de mensagem podem ser criados no aplicativo ACD para os seguintes elementos de conteúdo rico:

  • Formulários
  • Seletores de lista
  • Respostas rápidas
  • Links avançados

Esses modelos podem ser atribuídos aos seguintes digital channels:

  • Apple Messages for Business

  • Facebook Messenger

  • WhatsApp

  • Digital Chat

Depois de serem atribuídos a um canal, os modelos podem ser usados de duas formas:

Adaptive Cards

Desenvolvidos pela Microsoft, Adaptive Cards An icon of a square with an arrow  pointing from the center out to the upper right corner. são um método de criação de conteúdo de mensagens avançadas (rich messaging)Closed Elementos em mensagens digitais, como botões, imagens, menus e seletores de opção.. Eles são um formato aberto de troca de cartões que permite enviar conteúdo de UI de maneira comum e consistente. Com Adaptive Cards, você pode enviar mensagens interativas que são mais complexas e úteis do que aquelas que contêm apenas elementos padrão de mídia avançada.

A vantagem de Adaptive Cards é que você pode criar seu próprio conteúdo, portanto, não fica limitado às opções básicas de mídia avançada. Adaptive Cards são criados usando blocos de construção de grade com muitas opções para elementos interativos e multimídia.

Atualmente, somente o chat digital é compatível com Adaptive Cards. Os canais de chat em tempo real atualmente são compatíveis com cartões adaptáveis em MAX, mas não no Agente. Se mensagens com Adaptive Cards forem enviadas em outros canais, o texto de fallbackClosed Uma alternativa em texto simples enviada quando o destino não oferece suporte a mídia avançada. designado será usado em seu lugar.

Para trabalhar com Adaptive Cards em NiCE CXone, você pode:

Os cartões adaptáveis podem ser criados usando o Microsoft designer de cartão adaptável An icon of a square with an arrow  pointing from the center out to the upper right corner.. Essa ferramenta está disponível para qualquer pessoa usar.

Texto alternativo

O texto alternativo permite que você especifique um texto alternativo para enviar aos contatos em canaisClosed Diversos meios de comunicação por voz e digitais que facilitam as interações com o cliente em uma central de contato. que não oferecem suporte a um determinado tipo de conteúdo rico. Isso é útil se a sua organização usar mais de um canal digitalClosed Qualquer canal, contato ou competência associado a Digital Experience (DX).. Também fornece um backup no caso de ocorrerem problemas na renderização do conteúdo rico.

Você deve incluir texto alternativo para todo o conteúdo interativo que enviar:

  • Para o conteúdo rico do TORM criado em JSON, você pode incluir o elemento fallbackText no JSON.
  • Para modelos de mensagens avançadas, você deve garantir que cada modelo tenha texto especificado no campo Texto alternativo.
  • Para mensagens enviadas por meio de Bot Builder, use as opções de fallback de mensagens avançadas no aplicativo Bot Builder.
  • Para mensagens enviadas via Virtual Agent Hub, consulte a documentação do seu fornecedor terceirizado de agente virtual para mais informações sobre como ele lida com contingências.

Ao criar o texto alternativo, o conteúdo deve transmitir uma mensagem semelhante à do conteúdo rico. Por exemplo, se o conteúdo rico tiver dois botões que o contato pode clicar para escolher entre chocolate e baunilha, o texto alternativo poderia perguntar ao contato: "Você quer chocolate ou baunilha?"

Conteúdo Rico com Agentes virtuais e Bots

Você pode fazer com que agentes virtuais e bots enviem conteúdo rico em mensagens baseadas em chat para contatos. Um agente virtual ou bot envia respostas a contatos por meio de um canal digital. Você está limitado a usar elementos de conteúdo rico que o canal suporta. Se o seu agente virtual enviar mensagens em múltiplos canais, certifique-se de ter o texto alternativo definido para cada elemento de conteúdo rico.

Cada mensagem de resposta enviada por um agente virtual ou bot deve ser configurada individualmente nas configurações do agente virtual ou bot. Se você desejar que uma resposta inclua conteúdo avançado, deverá incluir isso na configuração de resposta na plataforma do agente virtual ou do provedor de bot.

Bot Builder

Para bots criados usando Bot Builder, você pode usar conteúdo interativo nas respostas que o bot envia aos contatos. Bot Builder possui várias opções de conteúdo interativo integrado. Essas opções não exigem a criação de JSON. Elas estão disponíveis como opções na IU do desenvolvedor do bot para uso quando você criar uma mensagem de resposta de bot

O Bot Builder tem opções para botões, selecionadores de lista e links avançados. Além disso, você pode desenvolver e enviar cartões adaptáveis nas suas respostas de bot. Se desejar usar elementos de conteúdo enriquecido que não são oferecidos nativamente como uma opção em Bot Builder, mas que são suportados pelo canal que você utiliza, você pode:

  • Configure uma integração entre seu bot e um script Studio. Configure o script com o conteúdo avançado que você deseja usar em Bot Builder.
  • Crie uma ação personalizada de resposta de bot no Bot Builder. Esta opção usa JavaScript. Você pode codificar a ação para enviar um objeto JSON em formato de string para o contato.

Virtual Agent Hub

Para agentes virtuais configurados em Virtual Agent Hub, as mensagens de resposta normalmente são configuradas na console de gestão do provedor do agente virtual. Por exemplo, se você estiver trabalhando com um agente virtual Google Dialogflow CX, você configura as mensagens de resposta na console Dialogflow no Projeto Google Cloud da sua organização. Quando o administrador do Dialogflow configura uma resposta na console de gestão, o JSON para o elemento de conteúdo rico deve ser incluído.

An alternativa é criar um modelo em um snippet no seu script Studio. Use variáveis para os valores que devem vir do agente virtual. Configure as mensagens de resposta do agente virtual para enviar apenas as variáveis com os valores apropriados para o script. No script, o JSON para o elemento de conteúdo enriquecido é construído no snippet a partir dos valores enviados pelo agente virtual.

Enviar Modelos TORM com um script

A ação GETRICHMESSAGE usada neste script recupera uma matriz dinâmica contendo o JSON de todos os modelos de rich messaging disponíveis para o 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. especificado. O número de índice em resultSet.data[x] identifica o elemento da matriz que você deseja armazenar na variável jsonY.data[x]. Para descobrir a lista de modelos, você pode executar um rastreamento no seu script e verificar o conteúdo da variável resultSet na saída do rastreamento.

Você pode baixar um script de exemplo para usar ao enviar modelos TORM via script.

  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.

Criar JSON em uma Ação SNIPPET

Você pode criar o JSON para conteúdo interativo em seu script usando uma ação Snippet e enviá-lo diretamente aos contatos. Para usar esta opção:

  • O canal digital deve dar suporte ao tipo de conteúdo avançado, se você estiver enviando o conteúdo para o contato.
  • Você deve usar o esquema esperado pelo canal. Isso permite que o canal exiba o conteúdo de maneira adequada. Estas informações podem estar disponíveis na documentação do desenvolvedor do canal com o qual está trabalhando. Uma exceção a essa regra é se você estiver usando esquemas TORM com canais que os suportam. Os canais não reconhecem esquemas TORM, mas o NiCE CXone converte os esquemas para aqueles esperados pelo canal antes de enviá-los.
  • O aplicativo do agente deve oferecer suporte ao tipo de conteúdo avançado, se você estiver exibindo o conteúdo para o agente.

Se você estiver enviando mensagens avançadas por meio de um agente virtual, talvez seja necessário criar o JSON para mensagens avançadas na console de gestão do provedor de agente virtual, em vez de no seu script Studio.

  1. Usando a ferramenta que preferir, crie a sua estrutura JSON seguindo o esquema adequado.
  2. Testar o JSON. Isso ajuda a garantir que a estrutura JSON está correta. Pode eliminar ou reduzir a quantidade de solução de problemas necessária posteriormente devido a JSON inválido. Você pode, por exemplo, usar a ferramenta de espelhamento JSON.
  3. Quando tiver uma estrutura que funciona, converta-a em uma string em uma única linha.
  4. Em Studio, adicione uma Snippet ação ao seu script.
  5. No Snippet, atribua a cadeia JSON a um objeto dinâmico.
  6. Adicione uma ação Askcaller ou Textmsg ao script e configure a propriedade Mensagem com o nome do objeto que contém a string JSON.
  7. Configure o script para enviar o objeto que contém o JSON para o contato.

Enviar conteúdo interativo diretamente a um contato

  1. Verifique se o canal que você está usando suporta o conteúdo rico que você deseja usar.
  2. Configure seu script com o conteúdo multimídia que você deseja enviar. Por exemplo, um modelo do TORM ou JSON criado em uma ação de SNIPPET.
  3. Adicione uma ação Askcaller ou Textmsg e configure-as adequadamente.
  4. Conclua o seu script.

Enviar Esquemas JSON via API

O exemplo a seguir mostra como enviar uma mensagem avançada por meio da Outbound API digital. Você pode enviar mensagens para o aplicativo do agente ou para contatos. No entanto, mensagens avançadas enviadas dessa forma atualmente não são exibidas no aplicativo do agente. O valor de fallbackText é usado em vez disso.

curl --location --request POST 'https://api-de-na1.dev.niceincontact.com/dfo/3.0/channels/chat_2360f828-e7dd-4e18-925e-48fba98e8349/outbound' \
--header 'Authorization: Bearer <accessToken>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "thread": {
  "idOnExternalPlatform": "4455006164606838"
},
"messageContent": {
    "type": "TIME_PICKER",
    "fallbackText": "Text sent if rich message is not available on external platform",
    "payload": {
   	   "title": {
	       "content": "Check our new gadget!"
        },
        "timeSlots": [
	       {
            "id": "unique-id-1",
	        "duration": 3600,
	        "startTime": "2017-05-26T08:27:55+00:00"
	        }
	     ],
		"location": {
			"title": {
			    "content": "Check our new gadget!"
			},
			"latitude": 44.44,
			"longitude": 55.55,
			"radius": 33.3
		  }
		}
 },
"recipients": [
    {
	  "idOnExternalPlatform": "57a58d5d-6423-4bd1-9282-533b8b095598",
	  "name": "Frankenstein Monster"
	}
  ]
}'

Limitações de mensagens avançadas

Mensagens avançadas no NiCE CXone têm suas limitações. Nem todos os canais digitaisClosed Qualquer canal, contato ou competência associado a Digital Experience (DX). suportam todos os elementos de conteúdo rico. Os aplicativos de agente compatíveis com NiCE CXone também não oferecem suporte a todos os elementos de conteúdo enriquecido.

Para mensagens enviadas aos contatos, você pode usar qualquer elemento de conteúdo rico compatível com o canal digital usado para enviar a mensagem. Se o canalClosed Diversos meios de comunicação por voz e digitais que facilitam as interações com o cliente em uma central de contato. que você usa for compatível com uma opção de conteúdo rico que não esteja documentada no Help Center do NiCE CXone, você pode usá-la. Use a documentação do esquema do provedor do canal e crie-a em uma ação SNIPPET em seu script. Por exemplo, se sua organização usa Bring Your Own Channel (BYOC), o canal que você usa pode ser compatível com opções de conteúdo rico que não estão documentadas nesta página.

Para conteúdo rico exibido ao agente no aplicativo do agente, o conteúdo deve ser compatível com o aplicativo. Se o conteúdo não for compatível com o aplicativo do agente, o texto de fallback é exibido para o agente. No entanto, o agente ainda pode enviar esse conteúdo ao contato. Desde que o canal seja compatível com o elemento de conteúdo rico, o contato vê o conteúdo rico conforme pretendido.

Suporte a conteúdo avançado

Cada canal digitalClosed Qualquer canal, contato ou competência associado a Digital Experience (DX). oferece suporte a um conjunto específico de conteúdo rico. Ao trabalhar com scripts digitais que enviam conteúdo rico ao contactClosed A pessoa que interage com um agente, Rvi ou bot em seu contact center., verifique se o canal com o qual o script trabalha oferece suporte ao conteúdo rico que você deseja usar.

Suporte a conteúdo Avançado em Aplicativos do Agente

Atualmente, o conteúdo avançado é suportado em MAX e Agent Workspace (Agent). Os Agentes podem acessar modelos de mensagem que podem conter conteúdo avançado nas seguintes localizações em MAX:

  • Modelos não TORM: Em Modelos de mensagem > Escolher Modelo.
  • Modelos TORM: Em Mensagens avançadas > Mensagem avançada.