---
sourceDocument: Interfaces conversacionais do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces
Release :
- xanadu
ft:locale :
- pt-BR
ft:publication_title :
- Interfaces conversacionais do Xanadu
ft:clusterId :
- convint
bundleId :
- convint
workflow :
- Platform
---
# Controles avançados de entrada e de saída padrão para uma integração de bate-papo personalizada
# Controles avançados de entrada e de saída padrão para uma integração de bate-papo personalizada {#ariaid-title1}
* Versão de lançamento: Xanadu
*
* Atualizado 1 de ago. de 2024
*
*  3 min. de leitura
Controles avançados de entrada e de saída devem ser mapeados para a integração de bate-papo personalizada na tabela Configurações de 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á servida ao usuário final e esse usuário poderá ter 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 de saída. O parâmetro uiType se refere a um controle de tópico usado para criar conversas em 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. O ServiceNow® Virtual Agent produz os seguintes tipos de mensagens da ação por meio dessa estrutura. A interface de bate-papo personalizada só reconhece determinados tipos de mensagens da 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 quebra essas mensagens dentro do elemento actionMsg. Portanto, um único transformador de saída para ActionRichControl pode manipular todas essas mensagens. Não há necessidade de um transformador de entrada para esse componente. |
| Parâmetro agentInfo | Se o controle avançado for enviado por um atendente, o atributo agentInfo será 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. ... } |
| DefaultPicker | Mapas para [Seletor de arquivos](https://servicenow-prod.fluidtopics.net/8teUOiKtIyR5ZGeUfY~vtg "Use o controle de entrada do utilizador do seletor de arquivos em um tópico Virtual Agent 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 no cliente Virtual Agent."), Seletor de tópicos e [controles Boolianos](https://servicenow-prod.fluidtopics.net/8cStUGC_hZYzmQHKZ4RvIg "Use o controle de entrada do usuário Booliano em um tópico Virtual Agent para apresentar um aviso de Sim/Não ao usuário."). 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 parâmetro opcional order permite especificar a ordem na qual 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 } ] |
| DefaultText | Mapas para [Entrada de texto](https://servicenow-prod.fluidtopics.net/SQYWLhsKQa9RGGHsflaMdw "O controle de texto de entrada do usuário em um tópico Virtual Agent solicita ao usuário uma cadeia de caracteres de texto."), [Texto de saída](https://servicenow-prod.fluidtopics.net/AByVOsPsp644IcTrlLDSaA "Use o controle de resposta do bot em texto em um tópico Virtual Agent para exibir uma resposta do bot como texto. Você pode formatar as respostas do bot em texto usando os controles do editor de texto. Por exemplo, você pode colocar o texto em negrito ou itálico, além de 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?" } |
| DefaultDate | Mapas para controles de [data e hora](https://servicenow-prod.fluidtopics.net/eKzC2erM5pR1j7rL2S25RA "Use o controle de Data e Hora de entrada do usuário em um tópico Virtual Agent para permitir que o usuário selecione uma data do calendário, a hora (horas e minutos) ou ambos."). { uiType: "Date/DateTime/Time", group: "DefaultDate", required: true/false, nluTextEnabled: true/false, label: "The Question?" } |
| DefaultOutputLink | Mapas para controles de [resposta do link](https://servicenow-prod.fluidtopics.net/DvYxaeC4K2c1v1NyMjbUwQ "Use o controle de resposta do bot em link em um tópico Virtual Agent para apresentar uma resposta do bot. A resposta contém um aviso de cabeçalho com um único link de URL para um item ou vários links de URL para até três itens."). Exemplo: { uiType: "OutputLink", group: "DefaultOutputLink", label: "link label", header: "link header", type: "link", value: { action: "www.foo", } } } |
| DefaultOutputImage | Mapas para controles de [resposta de imagem](https://servicenow-prod.fluidtopics.net/PEW40UiUsLwunjaYuvkjnA "Use o controle de resposta do bot em imagem em um tópico Virtual Agent para carregar e exibir uma imagem a partir de um link de URL. A proporção da imagem determina como a imagem é dimensionada no bolha de bate-papo do bot."). Exemplo: { uiType: "OutputImage", group: "DefaultOutputImage", value: "www.foo" } |
| DefaultOutputCard | Mapas para controles de [resposta do cartão](https://servicenow-prod.fluidtopics.net/6cWEICQtZHIXjLU_w1qjWw "Use o controle de resposta do bot em cartão em um tópico Virtual Agent 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."). Exemplo: { uiType: "OutputCard", group: "DefaultOutputCard", templateName: "Card", data: "some json data string" } |
| DefaultOutputHtml | Mapas para controles de [resposta HTML](https://servicenow-prod.fluidtopics.net/_aXdy5YPRGASwPBWZWL8Kg "Use o controle de resposta do bot HTML para exibir texto HTML estático na resposta do bot Virtual Agent."). Exemplo: { uiType: "OutputHtml", group: "DefaultOutputHtml", style: "inline", height: 100, width: 100, value: "html
" } |
| DefaultOutputTable | Mapas para controles de [resposta da tabela](https://servicenow-prod.fluidtopics.net/r_Oy~I5pCoR~H~RVk69XEw "Use o controle de resposta do bot em tabela em um tópico Virtual Agent para exibir uma resposta do bot como tabela."). Exemplo: { uiType: "OutputTable", group: "DefaultOutputTable", label: "Table Title", headers: ["Column 1", "Column 2"], navigationBtnLabel: "See next", data: [ ["foo1", "foo2"], ["bar1", "bar2"] ] } |
| DefaultGroupedPartsOutputControl | Mapas para controles de [várias respostas](https://servicenow-prod.fluidtopics.net/1e~XPGBL__M~HQZ_bqpufA "Use o controle de resposta do bot de várias respostas em um tópico Virtual Agent para exibir sequencialmente duas ou mais saídas. As saídas podem ser texto, imagem, link ou HTML. Os usuários podem passar de uma saída para a próxima com um botão de navegação fornecido."). Exemplo: { uiType: "GroupedPartsOutputControl", group: "DefaultGroupedPartsOutputControl" groupPartType: "Link", header: "header message", values: [ { action: "www.foo", description: "description", label: "link_1 label", context: "ITSM" }, ... ] } |
| DefaultMultiPartOutput | Mapas para controles de [várias respostas](https://servicenow-prod.fluidtopics.net/1e~XPGBL__M~HQZ_bqpufA "Use o controle de resposta do bot de várias respostas em um tópico Virtual Agent para exibir sequencialmente duas ou mais saídas. As saídas podem ser texto, imagem, link ou HTML. Os usuários podem passar de uma saída para a próxima com um botão de navegação fornecido."). Exemplo: { uiType: "MultiPartOutput", group: "DefaultMultiPartOutput" navigationBtnLabel: "Go next", content: { uiType: "OutputHtml", style: "inline", type: "html", height: 100, width: 100, value: "html
" } } |
| DefaultCustomControl | Maps para [controles personalizados](https://servicenow-prod.fluidtopics.net/0CaQ5yJ2vinEBuFhR~vbSA "Use o utilitário de controle personalizado em um tópico ou bloco de tópicos do Virtual Agent para fazer referência a um controle de entrada personalizado ou um controle de resposta personalizado. 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 de saída padrão]
{#default-rich-controls-va-cccif__table_rqm_lvn_qmb}