Controle de resposta do bot em cartão

Um cartão pode conter informações de registro, uma imagem ou um conteúdo de vídeo do YouTube em formato compacto. O formato compacto foi projetado para facilitar a leitura na janela de bate-papo.

A resposta do bot em cartão pode mostrar os seguintes tipos de conteúdo:

Registro: exibe o conteúdo de um único registro na sua instância. Este registro pode ser referenciado a partir de variáveis no fluxo ou consultado usando um script que retorna um único registro de Glide de uma tabela selecionada. O conteúdo do registro inclui o campo de exibição da tabela na parte superior do cartão, seguido por qualquer outro campo especificado pelas propriedades da resposta do bot.
Imagem: exibe uma imagem grande ou pequena fornecida por você, junto com um título e uma descrição. A folha de propriedades fornece um modelo pré-configurado para o layout do cartão. Especifique o título, a descrição e a origem da imagem.
Vídeo do YouTube: é exibido em um player de vídeo em linha se Com suporte com o canal. A imagem é exibida junto com um título, uma descrição e hiperlink para o conteúdo relevante.
Na versão Zurich, somente vídeos do YouTube são compatíveis.

Dica:
Você também pode usar o controle de resposta do bot em vídeo para incluir vídeos do YouTube em conversas. O controle de resposta do bot em vídeo inclui um botão de navegação que pausa a conversa. Se você quiser que o usuário assista ao vídeo antes de continuar a conversa, use este botão de navegação. Quando os usuários terminarem de assistir ao vídeo, eles poderão clicar neste botão de navegação para continuar a conversa.

Nota:

Se você criou anteriormente conversas que usam o controle de resposta do bot HTML para gerar layouts do cartão, considere atualizar suas conversas para usar o controle de resposta do bot em cartão. O cartão exibe informações de um registro em sua instância e contém um link para esse registro relacionado. Ou ele pode exibir imagens e incluir conteúdo avançado, como um vídeo.

Propriedades do controle de resposta do bot em cartão


Propriedade	Descrição
Nome do nó	Nome que identifica este nó de controle de resposta do bot em cartão no fluxo do tópico.
Tipo de cartão	Tipo de cartão a ser usado. Escolha uma das opções a seguir: Registro Imagem grande contendo texto Imagem pequena contendo texto Cartão de vídeo do YouTube Nota: Na versão Zurich, somente cartões de vídeo do YouTube são compatíveis.
Tipo: registro
Registro	Referência a um registro específico. Os dados do cartão vêm de um registro referenciado em uma variável de outro nó no fluxo. Por exemplo, a referência pode ser uma lista de seleção ou uma ação de Glide. Selecione uma variável do fluxo atual que contém um objeto de registro. Use a lista de campos para determinar os campos exibidos no cartão.
Tabela	Tabela que faz referência a um único registro de Glide que contém os dados mostrados no cartão.
Filtrar esta tabela usando	Insira a condição ou o script para filtrar os dados na tabela e retornar o registro. Condição: declaração de condição que retorna o registro da tabela. Script: consulta de registro de Glide que retorna o registro de Glide.
Campos	Campos do registro ServiceNow podem ser exibidos no cartão. Especifique cada campo clicando em Adicionar campo. Nota: Se você estiver usando Workplace, no máximo quatro campos serão renderizados no cartão. Se você tiver mais de quatro campos, os campos restantes serão exibidos em um cartão subsequente, com um limite de quatro campos por cartão.
Tipo: imagem grande com texto ou imagem pequena com texto
Modelo	Uma representação visual que mostra o layout do cartão de imagem. Cada área do modelo é numerada.
Mapear dados para campos no cartão	Campos que correspondem aos números mostrados no modelo. Esses campos são os seguintes: Título: nome ou rótulo do cartão Descrição: explicação da imagem Link do URL da imagem: especifique a imagem exibida no cartão de uma das seguintes formas: Especifique o URL da imagem usando o campo de texto, a cápsula de dados ou o script. Carregue a imagem clicando em Carregar imagem. Se você carregar uma imagem, a imagem selecionada será carregada no servidor e armazenada na tabela Imagens [sys_db_image] e nos conjuntos de atualizações. Quando a imagem é armazenada na tabela Imagens e nos conjuntos de atualizações, você pode usar a imagem em uma instância de produção ou de não produção, conforme necessário. Depois que a imagem é carregada, o link do URL é incluído na folha Propriedades da resposta. Clique no link para exibir a imagem. O URL é gerado de maneira dinâmica. O nome da instância é inserido na frente do caminho do URL. Você pode mudar ou excluir o link para a imagem. Se você excluir o link nesta folha de propriedades, somente a referência ao URL será excluída. A imagem permanece no servidor para uso futuro. Texto alternativo da imagem: Texto alternativo legível na tela que descreve a imagem para programas de acessibilidade. Este texto é usado junto com a imagem. Insira o texto usando o campo de texto, a cápsula de dados ou o script.
Tipo: cartão de vídeo do YouTube
Modelo	Uma representação visual do layout do vídeo incluído no cartão.
Mapear dados para campos no cartão	Campos que correspondem aos números mostrados no modelo. Esses campos são os seguintes: Título: título do cartão. Link do título: URL para qualquer conteúdo relevante. Descrição: a descrição do cartão, como o tópico abordado pelo vídeo. ID do vídeo do YouTube: identificador único do vídeo usado no cartão. Este identificador é a cadeia de caracteres após o sinal de igual (=) no final do caminho do URL do vídeo. Por exemplo, no caminho mostrado abaixo, o identificador do vídeo é FVgtjdEOa5M.
Avançado
Ocultar este nó
Mostrar este nó condicionalmente se	Uma declaração de condição sem código ou script de baixo código que especifica uma condição para apresentar este nó na conversa. A condição deve ser avaliada como verdadeira.

Suporte ao canal

Tabela 1. Suporte ao canal para o controle de resposta do bot em cartão
Canal	Suporte	Restrições
IU da Web	Com suporte	Nenhum
IU para celular	Com suporte	Nenhum
Painel do Now Assist	Suporte parcial	Cartões de registro e cartões de registro somente com ação.
Microsoft Teams	Com suporte	O controle de vídeo exibe uma imagem em miniatura do vídeo que o usuário seleciona para abrir o vídeo no navegador da Web de preferência.
Slack	Com suporte	Integração conversacional com Slack versão 2.0.0 e posterior. O controle de vídeo exibe uma imagem em miniatura do vídeo que o usuário seleciona para abrir o vídeo no navegador da Web de preferência.
Workplace	Suporte parcial	Saída de cartão de imagem não disponível. Os aplicativos do Facebook não são mais compatíveis com os modelos de lista vertical. Desde 15 de agosto de 2019, o layout do cartão usa um modelo de carrossel horizontal rolável. Os cartões também apresentam um modelo de botão.
Facebook Messenger	Com suporte	Nenhum
SMS Twilio	Com suporte	Somente registros e cartões de imagem.
LINE	Suporte parcial	Somente registros e cartões de imagem.
WhatsApp	Suporte parcial	Somente registros e cartões de imagem.
Apple Messages for Business	Com suporte	Nenhum
Alexa (Serviços de voz)	Suporte parcial	Alguns tipos de saída só estão disponíveis em dispositivos com telas. Para dispositivos que não são de tela, o título do cartão é lido. Para detalhes, consulte Ajustar as configurações e os tópicos Virtual Agent para obter a melhor experiência de bate-papo por serviços de voz Alexa.

Exemplo de consulta de registros de Glide

(function execute(table) {
    /* Write a glide record query, and return the glide record.
       For example:
       
       var now_GR = new GlideRecord(table);
       gr.addEncodedQuery('active=true^number=INC0010099');
       gr.query();
       if(gr.next()) {
          return gr;
    }
    */
})(table)

Neste exemplo, o script cria um objeto GlideRecord, preenche esse objeto usando uma consulta que deve retornar um único resultado e o retorna. A propriedade Tabela define a tabela usada nesta consulta.

Exemplo de saída de resposta de bot em cartão para registros

Nota:

Designer do Virtual Agent os controles podem ser exibidos e funcionar de forma diferente em outros canais.


Propriedades da resposta	Saída do cartão
Figura 1. Propriedades básicas do controle de resposta do bot em cartão	Figura 2. Saída do cartão na UI da Web Figura 3. Microsoft Teams Saída do cartão

Exemplo de resposta do bot em cartão para uma imagem grande

O layout de resposta do cartão para imagens pode variar entre os canais.


Propriedades da resposta	Saída do cartão
	Figura 4. Saída do cartão de imagem na UI da Web Figura 5. Microsoft Teams Cartão de imagem de IU

Exemplo de resposta do bot em cartão para uma imagem pequena

O layout de resposta do cartão para imagens pode variar entre os canais.


Propriedades da resposta	Saída do cartão
	Figura 6. Saída do cartão de imagem na UI da Web

Exemplo de resposta do bot em cartão com conteúdo de vídeo

A forma como a resposta do bot em cartão exibe vídeos pode variar entre os canais. Por exemplo, a exibição do que você vê em Slack mensagens pode ser diferente do que você vê em Microsoft Teams ou Workplace from Facebook. Além disso, se um player integrado for Com suporte com esse canal, ele será incluído na exibição. Para mais informações sobre canais, consulte a documentação do canal que você está usando.


Propriedades da resposta	Saída do cartão
	Figura 7. Saída de resposta do bot em cartão com vídeo no widget de bate-papo Figura 8. Saída de resposta do bot do cartão com vídeo ativado Microsoft Teams