Skip to main content

Send Widget

Send a dynamic UI widget component to the chat. Takes widget data as input.

Properties

PropertyValue
Typesend-widget
FamilyActions
GroupUtilities

Parameters

NameLabelTypeDescriptionRequired
componentIdWidget ComponentSelectSelect the widget component to renderYes
widgetDataWidget DataJSONJSON data to populate the widget template. The schema depends on the selected component.Yes
additionalInstructionsAdditional InstructionsStringOptional text to display alongside the widget. This can be used to provide additional context, instructions, or prompts to the user viewing the widget.No

Outputs

NameLabelTypeDescription
successsuccessbooleanWhether the widget was sent successfully
componentIdcomponentIdstringID of the rendered component
componentNamecomponentNamestringName of the rendered component
widgetwidgetobjectThe compiled widget data
userResponseuserResponseobjectUser response data (if widget is interactive)
statusstatusstringStatus: widget_sent, user_responded, timeout, or cancelled