--- sourceDocument: Interfaces conversacionais de Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Interfaces conversacionais de Yokohama ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Controle de resposta do bot do cartão # Controle de resposta do bot do cartão {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 min. de leitura Use o controle de resposta do bot de cartão em A. Virtual Agenttópico para carregar e exibir informações selecionadas de um registro em sua instância, junto com conteúdo avançado, como um vídeo ou imagem. Um cartão pode conter informações de registro, uma imagem ou um conteúdo de vídeo do YouTube em um formato compacto. O formato compacto foi projetado para facilitar a leitura na janela de bate-papo. A resposta do bot do cartão pode mostrar os seguintes tipos de conteúdo: * Registro: Exibe o conteúdo de um único registro em 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 Glide de 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 todos os outros campos especificados pelas propriedades da resposta do bot. * Imagem: Exibe uma imagem grande ou pequena que você fornece, 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 compatível com o canal. A imagem é exibida junto com um título, uma descrição e um hiperlink para o conteúdo relevante.Em YokohamaVersão, somente vídeos do YouTube são compatíveis. Dica: Você também pode usar o. [Controle de resposta do bot de vídeo](https://servicenow-prod.fluidtopics.net/xHM4JYc_6xW96fQGIroauA "Use o controle de resposta do bot de vídeo em um Virtual Agenttópico para incluir um vídeo na conversa.")Para incluir vídeos do YouTube em conversas. O controle de resposta do bot de 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 com 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 com a conversa. {#va-card-output__ul_wcc_p2b_g4b} Nota: Se você criou conversas anteriormente que usam [Controle de resposta de bot HTML](https://servicenow-prod.fluidtopics.net/lAehc_l~ofDLmNT23nH1ew "Use o controle de resposta de bot HTML para exibir texto HTML estático no Virtual Agentresposta do bot.")Para gerar layouts de cartão, considere atualizar suas conversas para usar o controle de resposta do bot de 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 pode exibir imagens e incluir conteúdo avançado, como um vídeo. ## Propriedades de controle de resposta do bot do cartão {#va-card-output__section_xwb_mgn_pdb} {#va-card-output__table_nff_y1b_3db__entry__2} | Propriedade | Descrição | |-|-| | Nome do nó | Nome que identifica este nó de controle de resposta do bot de cartão no fluxo de tópicos. | | 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: Em YokohamaVersão, somente placas de vídeo do YouTube são compatíveis. {#va-card-output__ul_vhw_smt_f4b} | | 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 Ação Glide. 1. Selecione uma variável no fluxo atual que contenha um objeto de registro. 2. Use o. campos lista para determinar os campos exibidos no cartão. {#va-card-output__ul_ab3_1mv_g4b} | | Tabela | Tabela que faz referência a um único registro Glide que contém os dados mostrados no cartão. | | Filtre 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 Glide que retorna o registro Glide. {#va-card-output__ul_tzn_2zt_f4b} | | campos | Campos do ServiceNowregistro a ser exibido no cartão. Clique em para especificar cada campo Campo Adicionar . Nota: Se você estiver usando Workplace, no máximo quatro campos são renderizados no cartão. Se você tiver mais de quatro campos, os campos restantes serão exibidos em um cartão subsequente, com até 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. Estes campos são os seguintes: 1. Título : Nome ou rótulo do cartão 2. Descrição : Explicação da imagem 3. Link do URL da imagem : Especifique a imagem exibida no cartão de uma das seguintes maneiras: * Especifique o URL da imagem, usando o campo de texto, a cápsula de dados ou o script. * Clique em para carregar a imagem Carregar imagem . {#va-card-output__ul_eyy_v44_tsb} Se você carregar uma imagem, a imagem selecionada será carregada no servidor e armazenada na tabela de imagens \[sys_db_image\] e nos conjuntos de atualizações. Quando a imagem é armazenada na tabela de imagens e nos conjuntos de atualizações, você pode usar a imagem em uma instância de produção ou não produção, conforme necessário. Depois que a imagem é carregada, o link do URL é incluído no Propriedades da resposta folha. Clique no link para exibir a imagem. O URL é gerado dinamicamente. 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. 4. 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. {#va-card-output__ul_n55_4q5_f4b} | | 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. Estes campos são os seguintes: * Título : Título do cartão. * Link do título URL para qualquer conteúdo relevante. * Descrição : Descrição O cartão, como o tópico que o vídeo aborda. * ID do vídeo do YouTube Identificador exclusivo 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 de vídeo é FVgtjdEOa5M . ![No URL www.youtube.com/watch?v=FVgtjdEOa5M, o identificador de vídeo é FVgtjdEoa5M.]() ![Neste URL, o identificador de vídeo é o ID do vídeo entre colchetes.]() {#va-card-output__ul_ydr_qx5_v4b} | | Avançado || | Ocultar este nó || | Mostrar condicionalmente este nó 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. | [ ] {#va-card-output__table_nff_y1b_3db} ## Suporte de canal {#va-card-output__section_yjd_3fp_tsb} {#va-card-output__table_yqr_3fp_tsb__entry__3} | Canal | Suporte | Restrições | |-|-|-| | IU da web | Compatível | Nenhum(a) | | IU para celular | Compatível | Nenhum(a) | | Painel do Now Assist | Suporte parcial | Cartões de registro e cartões de registro somente com ação. | | Microsoft Teams | Compatível | O controle de vídeo exibe uma imagem em miniatura do vídeo que os usuários selecionam para abrir o vídeo em seu navegador da web preferencial. | | Slack | Compatível | 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 os usuários selecionam para abrir o vídeo em seu navegador da web preferencial. | | Workplace | Suporte parcial | Saída do cartão de imagem não disponível. As aplicações do Facebook não são mais compatíveis com modelos de lista vertical. O layout do cartão usa um modelo de carrossel horizontal e rolável a partir de 15 de agosto de 2019. Os cartões também apresentam um modelo de botão. | | Facebook Messenger | Compatível | Nenhum(a) | | SMS Twilio | Compatível | 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 | Compatível | Nenhum(a) | | Alexa (Voz) | Suporte parcial | Alguns tipos de saída só estão disponíveis em dispositivos com telas. Para dispositivos fora da tela, o título do cartão é lido. Para obter detalhes, consulte [Ajuste fino Virtual Agentconfigurações e tópicos para o melhor Alexaexperiência de bate-papo por voz](https://servicenow-prod.fluidtopics.net/fRTg66TGwYPrK02OBcgu6Q "Ajuste seu Virtual Agentconfigurações e tópicos fornecidos pelo Designer do Virtual Agentpara a melhor experiência de bate-papo por voz com Alexa."). | [Tabela 1. Suporte de canal para o controle de resposta do bot de cartão] {#va-card-output__table_yqr_3fp_tsb} ## Consulta de registro Glide de de exemplo {#va-card-output__section_xtf_3hb_5db} (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 retorna o objeto. . Tabela a propriedade define a tabela usada nesta consulta. ## Saída de resposta do bot do cartão de exemplo para registros {#va-card-output__section_jxd_nh5_tdb} Nota: Designer do Virtual Agent os controles podem ser exibidos e funcionar de forma diferente em outros canais. {#va-card-output__table_f1f_v2p_xdb__entry__2} | Propriedades da resposta | Saída do cartão | |-|-| | Figura 1. Propriedades básicas do controle de resposta do bot do cartão | Figura 2. Saída do cartão de IU da web Figura 3. Microsoft Teams Saída do cartão | [ ] {#va-card-output__table_f1f_v2p_xdb} ## Resposta do bot de cartão de exemplo para uma imagem grande {#va-card-output__section_hpx_m4v_g4b} O layout de resposta do cartão para imagens pode variar entre os canais. {#va-card-output__table_f5b_s4v_g4b__entry__2} | Propriedades da resposta | Saída do cartão | |-|-| | | Figura 4. Saída do cartão de imagem da IU da web Figura 5. Microsoft Teams Cartão de imagem de IU | [ ] {#va-card-output__table_f5b_s4v_g4b} ## Resposta do bot de cartão de exemplo para uma imagem pequena {#va-card-output__section_tmd_dnm_h4b} O layout de resposta do cartão para imagens pode variar entre os canais. {#va-card-output__table_tjb_mrr_gpb__entry__2} | Propriedades da resposta | Saída do cartão | |-|-| | | Figura 6. Saída do cartão de imagem da IU da web | [ ] {#va-card-output__table_tjb_mrr_gpb} ## Resposta do bot de cartão de exemplo com conteúdo de vídeo {#va-card-output__section_l5h_sxn_v4b} A forma como a resposta do bot do cartão exibe vídeos pode variar entre os canais. Por exemplo, a exibição que você vê em Slackas mensagens podem ser diferentes do que você vê em Microsoft Teamsou Workplace from Facebook. Além disso, se um player integrado for compatível nesse canal, o player será incluído na tela. Para obter mais informações sobre canais, consulte a documentação do canal que você está usando. {#va-card-output__id_irz_szc_54b__entry__2} | Propriedades da resposta | Saída do cartão | |-|-| | | Figura 7. Saída de resposta do bot do 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 | [ ] {#va-card-output__id_irz_szc_54b}