---
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
---
# Controles avançados de entrada e saída padrão para uma integração de bate-papo personalizada
# Controles avançados de entrada e saída padrão para uma integração de bate-papo personalizada {#ariaid-title1}
* Versão de lançamento: Yokohama
*
* Atualizado 30 de jan. de 2025
*
*  3 min. de leitura
Os controles avançados de entrada e saída devem ser mapeados para sua integração de bate-papo personalizada na tabela Configurações do adaptador personalizado \[sys_cs_custom_adapter_config\]. Se um controle avançado não tiver uma implementação de transformador de saída, uma resposta não será fornecida ao usuário final e esse usuário poderá obter uma experiência de bate-papo insatisfatória.
Os controles avançados padrão a seguir são mapeados para controles avançados de entrada e saída. . uiTypeo parâmetro se refere a um controle de tópico usado para criar conversas no Designer do Virtual Agent.
{#default-rich-controls-va-cccif__table_rqm_lvn_qmb__entry__2}
| Controle avançado | Descrição |
|-|-|
| ActionRichControl | Este componente lida com os diferentes eventos e ações que ocorrem em uma conversa. Algumas ações podem não se aplicar a todos os canais. Por exemplo, StartSpinnerActionMsg é ignorado no SMS. ServiceNow® Virtual Agent produz os seguintes tipos de mensagens de ação por meio desta estrutura. A interface de bate-papo personalizada reconhece apenas determinados tipos de mensagem de ação. * SeparatorActionMsg \|\|actionMsg instanceof * SystemActionMsg \|\|actionMsg instanceof * TopicFinishedActionMsg \|\|actionMsg instanceof * SwitchToVirtualAgentActionMsg \|\|actionMsg instanceof * SwitchConversationActionMsg \|\|actionMsg instanceof * ChatSubHeaderActionMsg \|\|actionMsg instanceof * StartSpinnerActionMsg \|\|actionMsg instanceof EndSpinnerActionMsg * SubscribetoSupportQueue \|\|actionMsg instanceof * SubscribeToChatPresence \|\|actionMsg instanceof * SwitchToLiveAgentActionMsg \|\|actionMsg instanceof {#default-rich-controls-va-cccif__ul_odf_ykm_hmb} ActionRichControl envolve essas mensagens dentro de actionMsgelemento. Assim, um único transformador de saída para ActionRichControl pode lidar com todas essas mensagens. Não há necessidade de um transformador de entrada para este componente. |
| agentInfo parâmetro | Se o controle avançado for enviado de um atendente, então agentInfoo atributo é adicionado ao controle avançado. Exemplo: { uiType: "someType", group: "someGroup" agentInfo: { sentFromAgent: true } // please note that this object may contain more info in subsequent releases. ... } |
| Selecionador padrão | Mapeia para [Seletor de arquivos](https://servicenow-prod.fluidtopics.net/QlhMVVRzeUWcPUmXFJIZow "Use o controle de entrada do usuário do Seletor de arquivos em um Virtual Agenttópico para solicitar que um usuário carregue uma imagem ou qualquer tipo de arquivo. Depois que o usuário carrega um arquivo de imagem, a imagem aparece imediatamente em Virtual Agentcliente."), Seletor de tópicos, e. [Booliano](https://servicenow-prod.fluidtopics.net/JlqgAKvfGGkksjR6SySgKA "Use o controle booliano de entrada do usuário em um Virtual AgentTópico para apresentar um prompt Sim/Não ao usuário.")controles. Exemplo: { uiType: "Picker/TopicPicker/Boolean", group: "DefaultPicker", nluTextEnabled: true/false, promptMsg: "", // optional (needed for TopicPicker) label: "The question for the list", // always filled itemType: "Picture/List" // needed to user key to expect picture attached options: [ { label: "display label prompt", value: "the value required to satisfy the question", description: "a description of value_1 item" attachment: "www.foo", enabled: true/false }, ... ] } O opcional ordero parâmetro permite especificar a ordem em que os tópicos promovidos devem ser exibidos. Por exemplo: "options": [ { label: "Check IT Ticket Status", value: "55720b465bf0201024f11fc40a81c72d", order: 100, enabled: true }, { label: "Live Agent Support", value: "ce2ee85053130010cf8cddeeff7b12bf", order: 200, enabled: true }, { label: "Open IT Ticket 2", value: "2a46cffbc7602010v088bbf603c260a7", order: 300, enabled: true } ] |
| Texto padrão | Mapeia para [Texto de entrada](https://servicenow-prod.fluidtopics.net/jz2ygZoGrQrKuCkUhBV4QA "O controle de entrada do usuário de texto em um Virtual Agento tópico solicita ao usuário uma cadeia de caracteres de texto."), [Texto de saída](https://servicenow-prod.fluidtopics.net/CWYHqsYl265cBgEMK8s7JA "Use o controle Resposta de bot de texto em um Virtual Agenttópico para exibir uma resposta de bot como texto. Você pode formatar as respostas do bot de texto usando os controles do editor de texto. Por exemplo, você pode colocar o texto em negrito ou itálico, bem como incluir links, listas com marcadores e emojis.")E Controles de carregamento de arquivo. Exemplo: { uiType: "InputText/OutputText/FileUpload/Picture", group: "DefaultText", required: true/false, nluTextEnabled: true/false, itemType: "file/image/inputtext/outputtext", maskType: "SECURE/SENSITIVE/NONE" // null except for InputText/OutputText label: "The Question?" } |
| Data padrão | Mapeia para [Data e hora](https://servicenow-prod.fluidtopics.net/ecJd~0MFD~h97mjK7TvR_A "Use o controle de entrada do usuário de data e hora em um Virtual Agenttópico para permitir que o usuário selecione uma data, hora (horas e minutos) do calendário ou ambos.")controles. { uiType: "Date/DateTime/Time", group: "DefaultDate", required: true/false, nluTextEnabled: true/false, label: "The Question?" } |
| DefaultOutputLink | Mapeia para [resposta do link](https://servicenow-prod.fluidtopics.net/Bw3unIq9yDsiXcaT7TfV0Q "Use o controle de resposta do bot Vincular em um Virtual Agenttópico para apresentar uma resposta de bot. A resposta contém um prompt de cabeçalho com um único link de URL para um item ou vários links de URL para até três itens.")controles. Exemplo: { uiType: "OutputLink", group: "DefaultOutputLink", label: "link label", header: "link header", type: "link", value: { action: "www.foo", } } } |
| DefaultOutputImage | Mapeia para [resposta da imagem](https://servicenow-prod.fluidtopics.net/OohKitGUNJspVhreCASr1w "Use o controle de resposta do bot de imagem em um Virtual AgentTópico para carregar e exibir uma imagem de um link de URL. A proporção da imagem determina como a imagem é dimensionada no balão de bate-papo do bot.")controles. Exemplo: { uiType: "OutputImage", group: "DefaultOutputImage", value: "www.foo" } |
| DefaultOutputCard | Mapeia para [resposta do cartão](https://servicenow-prod.fluidtopics.net/WvYFOxpqzwBikj1a2f~t7Q "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.")controles. Exemplo: { uiType: "OutputCard", group: "DefaultOutputCard", templateName: "Card", data: "some json data string" } |
| DefaultOutputHtml | Mapeia para [Resposta 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.")controles. Exemplo: { uiType: "OutputHtml", group: "DefaultOutputHtml", style: "inline", height: 100, width: 100, value: "html
" } |
| DefaultOutputTable | Mapeia para [resposta da tabela](https://servicenow-prod.fluidtopics.net/Ugex3cthOH3oL3yfnuIuPQ "Use o controle de resposta do bot de tabela em A. Virtual Agenttópico para exibir uma resposta de bot como uma tabela.")controles. Exemplo: { uiType: "OutputTable", group: "DefaultOutputTable", label: "Table Title", headers: ["Column 1", "Column 2"], navigationBtnLabel: "See next", data: [ ["foo1", "foo2"], ["bar1", "bar2"] ] } |
| DefaultGroupedPartsOutputControl | Mapeia para [resposta múltipla](https://servicenow-prod.fluidtopics.net/o99scruGXAYTi52Lv5QCeQ "Use o controle de resposta de bot de resposta múltipla em um Virtual Agenttópico para exibir sequencialmente duas ou mais saídas. As saídas podem ser texto, imagem, link ou HTML. Os usuários podem mover de uma saída para a próxima por meio de um botão de navegação fornecido.")controles. Exemplo: { uiType: "GroupedPartsOutputControl", group: "DefaultGroupedPartsOutputControl" groupPartType: "Link", header: "header message", values: [ { action: "www.foo", description: "description", label: "link_1 label", context: "ITSM" }, ... ] } |
| Output multipartpadrão | Mapeia para [resposta múltipla](https://servicenow-prod.fluidtopics.net/o99scruGXAYTi52Lv5QCeQ "Use o controle de resposta de bot de resposta múltipla em um Virtual Agenttópico para exibir sequencialmente duas ou mais saídas. As saídas podem ser texto, imagem, link ou HTML. Os usuários podem mover de uma saída para a próxima por meio de um botão de navegação fornecido.")controles. Exemplo: { uiType: "MultiPartOutput", group: "DefaultMultiPartOutput" navigationBtnLabel: "Go next", content: { uiType: "OutputHtml", style: "inline", type: "html", height: 100, width: 100, value: "html
" } } |
| DefaultCustomControl | Mapeia para [controles personalizados](https://servicenow-prod.fluidtopics.net/XpF8CApCCr9p_ej85crjkg "Use o utilitário Controle personalizado em um Virtual Agentbloco de tópico ou tópico para fazer referência a um controle de entrada personalizado ou a um controle de resposta personalizado. Os controles personalizados complementam os controles fornecidos em Designer do Virtual Agent."). Exemplo: { uiType: "CustomControl", group: "DefaultCustomControl", name: "The name of the Custom Control (sys_cs_custom_control.name)", required: true/false, uxComponentDefinitionSysId: "seismicComponentId" // or null if not isInput: true/false, // whether to wait for a response value or if just output serializedControlData: "User defined JSON from generateControlData function"; } |
[Tabela 1. Controles avançados de entrada e saída padrão]
{#default-rich-controls-va-cccif__table_rqm_lvn_qmb}