Adaptive Cards

NiCE CXone Bot Builder oferece suporte ao uso de Adaptive Cards em respostas de bot. Você pode usá-los em históriasClosed Usado para treinar um bot para o tratamento de interações com base na intenção e no contexto., regrasClosed Usadas para definir uma resposta de bot a mensagens que não mudam com o contexto. e fallbackClosed Uma alternativa em texto simples enviada quando o destino não oferece suporte a mídia avançada..

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

Como padrão, o Bot Builder não tem Adaptive Cards disponíveis.Você deve criar o seu próprio usando o Microsoft Adaptive Card designer, que está incorporado em Bot Builder.

Usando o designer Adaptive Card, você pode criar modelos de Adaptive Card para usar com Bot Builder. Quando um bot executa uma resposta que inclui um modelo de Adaptive Card, o modelo é concluído dinamicamente com as informações apropriadas para essa interação e enviado ao contatoClosed A pessoa que interage com um agente, Rvi ou bot em seu contact center..

Adaptive Card Compatibilidade por Canal

Adaptive Cards Somente pode ser usado em canais que oferecem suporte a eles. Atualmente, há suporte somente para o canal Digital chat.

Se o seu bot enviar mensagens em canais que oferecem suporte a Adaptive Cards, bem como em canais que não oferecem, você deve configurar o fallbackClosed Uma alternativa em texto simples enviada quando o destino não oferece suporte a mídia avançada. de mensagens interativas. O fallback é enviado no lugar de Adaptive Card nos canais que não oferecem suporte a eles. Você pode configurar o fallback de mensagens interativas para cada resposta de bot que utiliza Adaptive Cards.

Criador de Adaptive Card

O criador de Adaptive Card permite criar Adaptive Card modelos para uso com o Bot Builder. Ao criar uma história, regra ou fallback, você pode adicionar a Adaptive Card ação de bot e, depois, escolher uma das Adaptive Cards que você criou.

O criador Adaptive Card é um Microsoft produto que está incorporado no Bot Builder. Documentação detalhada sobre o uso do designer está disponível no Microsoft Adaptive Card websiteAn icon of a square with an arrow  pointing from the center out to the upper right corner..

É possível utilizar qualquer Adaptive Card elemento disponível nos cartões que você criar. Para personalizar dinamicamente um Adaptive Card, você pode usar variáveis de slotClosed Entidade extraída da mensagem do contato e salva para uso nas respostas do bot. Semelhante a uma variável. . Se você quiser retornar dados para o seu bot, você pode incluir dados de postback nas configurações de um elemento, como um botão. Por exemplo, isso permite que você retorne a intenção associada à escolha do contato de volta ao bot.

Personalizar Adaptive Cards com Variáveis de Slots

Você pode incluir variáveis de slot no seu Adaptive Cards. Isso permite exibir a entidadeClosed Uma informação coletada das mensagens do contato durante conversas com um bot. associada ao slotClosed Entidade extraída da mensagem do contato e salva para uso nas respostas do bot. Semelhante a uma variável. no cartão quando o cartão é enviado a um contato.

Uma variável de slot é construída usando o nome da entidade associada ao slot, delimitado por chaves. Por exemplo: {phone_number}. Você pode usar variáveis de slot nas propriedades de um elemento no designer de Adaptive Card. Você também pode localizar o elemento na seção Card Payload editor do designer Adaptive Card e adicionar a variável de slot ao elemento. Por exemplo, "text": "Phone Number: {phone_number}".

Botões interativos

É possível incluir botões interativos no Adaptive Card. Você pode adicioná-los a qualquer elemento que tenha uma seção de Actions em suas propriedades. Há vários tipos de botões no designer do Adaptive Card que você pode usar. Os seguintes tipos de botão são particularmente úteis com Bot Builder:

  • Botão de URL: o botão abre um URL. O JSON para esse tipo de botão tem a seguinte aparência no exemplo:

    {
      "type": "Action.OpenUrl",
      "title": "View",
      "url": "http://www.nice.com"
    }
  • Botão de postback: O botão envia dados de postback para o bot quando o cliente clica ou toca no botão. Você pode usar isso para enviar uma intençãoClosed O significado ou a finalidade por trás do que um contato diz/digita; o que o contato deseja comunicar ou realizar. de volta ao bot. O JSON para esse tipo de botão é semelhante ao exemplo a seguir:

    {
     "type": "Action.Submit",
     "title": "Connect with agent",
     "data": {
    	"text": "/[intentName]"
     }

Criar um Adaptive Card

Novo Adaptive Cards comece com um conjunto de exemplos de elementos como padrão. É possível modificar os exemplos de elementos ou excluir todos eles, para começar a criar um cartão do zero.

Depois de criar um Adaptive Card, você pode usá-lo em uma resposta do bot.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecione Outras > Bot Builder.
  2. Clique no bot com o qual você deseja trabalhar.
  3. Clique em Preferências > Adaptive Cards.
  4. Para criar uma pasta, clique no sinal de mais Icon of a plus sign inside a circle. e digite um nome, depois pressione Enter.
  5. Na pasta à qual você deseja adicionar um Adaptive Card, clique no sinal de adição Ícone de um sinal de adição dentro de um círculo..
  6. Digite o nome do cartão e pressione Enter.
  7. Add elements to your card: 
    • Duplo clique em uma opção abaixo de Card Elements para adicioná-la.
    • Arraste e solte um elemento da seção Card Elements na visualização de cartões.
    • Clique na bússola de um elemento Icon of four arrows in a circle. na visualização do cartão e arraste o elemento para uma nova localização.
  8. Configure your element's properties:
    • Selecione um elemento na visualização ou na seção Estrutura do cartão. A seção Propriedades do elemento exibe as propriedades do elemento selecionado. Modifique-as conforme a necessidade. Cada elemento possui um conjunto único de propriedades.
    • Utilize o Card Payload editor para exibir, configurar ou modificar as propriedades de um elemento.
    • Clique em X no canto superior direito da visualização para excluir um elemento.
  9. Use um slot em um elemento inserindo o nome da entidade em um campo de propriedade do elemento. Delimite o nome por chaves.Por exemplo: {phone_number}.
  10. To add an interactive button to the card, configure an action in your card as follows: 
    • Abrir uma URL: Selecione Action.OpenURL como o Tipo DE ação e insira a URL.
    • Enviar dados postback: Selecione Action.Submit como o Tipo DE ação e insira o nome da intenção no campo Dados usando o formato {"text":"/[intentName]"}.
  11. Para testar a aparência do cartão na seção de visualização, substitua os dados padrão na seção editor de amostras de dados pelos dados do exemplo correspondentes ao cartão.
  12. As alterações são salvas automaticamente.