--- sourceDocument: Australia Conversational Interfaces sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/conversational-interfaces Release : - australia ft:locale : - pt-BR ft:publication_title : - Australia Conversational Interfaces ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Default input and output rich controls # Default input and output rich controls for a custom chat integration {#ariaid-title1} * Versão de lançamento: Australia * * Atualizado 12 de mar. de 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura Input and output rich controls must be mapped to your custom chat integration in the Custom Adapter Configurations \[sys_cs_custom_adapter_config\] table. If a rich control is missing an outbound transformer implementation, a response is not served to the end user and that user may get an unsatisfactory chat experience. The following default rich controls map to input and output rich controls. The uiType parameter refers to a topic control used to build conversations in Virtual Agent Designer. {#default-rich-controls-va-cccif__table_rqm_lvn_qmb__entry__2} | Rich control | Description | |-|-| | ActionRichControl | This component handles the different events and actions that occur in a conversation. Some actions may not apply to all channels. For example, StartSpinnerActionMsg is ignored in SMS. ServiceNow® Virtual Agent produces the following types of action messages through this framework. The custom chat interface only recognizes certain action message types. * 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 wraps these messages inside the actionMsg element. So, a single outbound transformer for ActionRichControl can handle all of these messages. There is no need for an inbound transformer for this component. | | agentInfo parameter | If the rich control is sent from a live agent, then the agentInfo attribute is added to the rich control. Example: { uiType: "someType", group: "someGroup" agentInfo: { sentFromAgent: true } // please note that this object may contain more info in subsequent releases. ... } | | DefaultPicker | Maps to [File Picker](https://servicenow-prod.fluidtopics.net/vG4uymw5yRTCJgHFJS9eXg "Use the File Picker user input control in a Virtual Agent topic to prompt a user to upload an image or any file type. After the user uploads an image file, the image appears immediately in the Virtual Agent client."), Topic Picker, and [Boolean](https://servicenow-prod.fluidtopics.net/w6kNcCT0fjDF6jsX4AxyvA "Use the Boolean user input control in a Virtual Agent topic to present a Yes/No prompt to the user.") controls. Example: { 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 }, ... ] } The optional order parameter lets you specify the order in which promoted topics should display. For example: "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 | Maps to [Input Text](https://servicenow-prod.fluidtopics.net/lH1SmsgS5gwk0mrsapiiLQ "The Text user input control in a Virtual Agent topic prompts the user for a text string."), [Output Text](https://servicenow-prod.fluidtopics.net/2Xm~kRm5VeV9vWQgjD1Umw "Use the Text bot response control in a Virtual Agent topic to display a bot response as text. You can format the Text bot responses using the text editor controls. For example, you can bold or italicize the text, as well as include links, bulleted lists, and emojis."), and File Upload controls. Example: { 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 | Maps to [Date and Time](https://servicenow-prod.fluidtopics.net/INLgB409WdPzUnZdf9Glfg "Use the Date Time user input control in a Virtual Agent topic to enable the user to select a calendar date, time (hours and minutes), or both.") controls. { uiType: "Date/DateTime/Time", group: "DefaultDate", required: true/false, nluTextEnabled: true/false, label: "The Question?" } | | DefaultOutputLink | Maps to [link response](https://servicenow-prod.fluidtopics.net/1RP7EViOZuUnA_IPzTjRsw "Use the Link bot response control in a Virtual Agent topic to present a bot response. The response contains a header prompt with either a single URL link to an item or multiple URL links for up to three items.") controls. Example: { uiType: "OutputLink", group: "DefaultOutputLink", label: "link label", header: "link header", type: "link", value: { action: "www.foo", } } } | | DefaultOutputImage | Maps to [image response](https://servicenow-prod.fluidtopics.net/TU6AAk4bjJRyQa3UoRzd7w "Use the Image bot response control in a Virtual Agent topic to upload and display an image from a URL link. The image aspect ratio determines how the image is sized in the bot chat bubble.") controls. Example: { uiType: "OutputImage", group: "DefaultOutputImage", value: "www.foo" } | | DefaultOutputCard | Maps to [card response](https://servicenow-prod.fluidtopics.net/rHOv2TknjmgMJqz0fVmQEg "Use the Card bot response control in a Virtual Agent topic to upload and display selected information from a record on your instance, along with rich content, such as a video or image.") controls. Example: { uiType: "OutputCard", group: "DefaultOutputCard", templateName: "Card", data: "some json data string" } | | DefaultOutputHtml | Maps to [HTML response](https://servicenow-prod.fluidtopics.net/E_rbJhJwVFI23TfRdJH3JA "Use the HTML bot response control to display static HTML text in the Virtual Agent bot response.") controls. Example: { uiType: "OutputHtml", group: "DefaultOutputHtml", style: "inline", height: 100, width: 100, value: "
html
" } | | DefaultOutputTable | Maps to [table response](https://servicenow-prod.fluidtopics.net/VPln44KiUSXUD4Gh~gR4aQ "Use the Table bot response control in a Virtual Agent topic to display a bot response as a table.") controls. Example: { uiType: "OutputTable", group: "DefaultOutputTable", label: "Table Title", headers: ["Column 1", "Column 2"], navigationBtnLabel: "See next", data: [ ["foo1", "foo2"], ["bar1", "bar2"] ] } | | DefaultGroupedPartsOutputControl | Maps to [multi-response](https://servicenow-prod.fluidtopics.net/dhUUasphZ4sztM6Kstk4Rg "Use the Multi-response bot response control in a Virtual Agent topic to sequentially display two or more outputs. Outputs can be text, image, link, or HTML. Users can move from one output to the next through a provided navigation button.") controls. Example: { uiType: "GroupedPartsOutputControl", group: "DefaultGroupedPartsOutputControl" groupPartType: "Link", header: "header message", values: [ { action: "www.foo", description: "description", label: "link_1 label", context: "ITSM" }, ... ] } | | DefaultMultiPartOutput | Maps to [multi-response](https://servicenow-prod.fluidtopics.net/dhUUasphZ4sztM6Kstk4Rg "Use the Multi-response bot response control in a Virtual Agent topic to sequentially display two or more outputs. Outputs can be text, image, link, or HTML. Users can move from one output to the next through a provided navigation button.") controls. Example: { uiType: "MultiPartOutput", group: "DefaultMultiPartOutput" navigationBtnLabel: "Go next", content: { uiType: "OutputHtml", style: "inline", type: "html", height: 100, width: 100, value: "
html
" } } | | DefaultCustomControl | Maps to [custom controls](https://servicenow-prod.fluidtopics.net/1pSupzT_QdOakOsA1T6gzA "Use the Custom Control utility in a Virtual Agent topic or topic block to reference a custom input control or a custom response control. Custom controls complement the controls provided in Assistant Designer."). Example: { 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. Default input and output rich controls] {#default-rich-controls-va-cccif__table_rqm_lvn_qmb}