widgets_update
ActiveTool of io.github.saloprj/dialogbrain
declared in 1.17.0
Update an existing livechat widget configuration. You can change name, theme, auto-reply mode, and other settings. Only provided fields will be updated. Use this when user wants to modify their chat widget settings.
Parameters schema
{
"type": "object",
"required": [
"widget_id"
],
"properties": {
"name": {
"type": "string",
"description": "New name for the widget"
},
"position": {
"enum": [
"bottom-right",
"bottom-left"
],
"type": "string",
"description": "Widget position on screen. OMIT to leave the position unchanged."
},
"is_active": {
"type": "boolean",
"description": "Enable or disable the widget. OMIT to leave the active flag unchanged."
},
"widget_id": {
"type": "integer",
"description": "ID of the widget to update"
},
"website_url": {
"type": "string",
"description": "Website URL for product/site search integration"
},
"calendly_url": {
"type": "string",
"description": "Booking URL for calendar action (e.g., 'https://calendly.com/yourname')"
},
"color_scheme": {
"enum": [
"light",
"dark",
"auto"
],
"type": "string",
"description": "Widget color scheme. 'auto' follows the visitor's OS dark/light mode preference. OMIT to leave the color scheme unchanged."
},
"display_mode": {
"enum": [
"chat",
"voice_only",
"headless"
],
"type": "string",
"description": "Visual mode of the widget. Pick exactly one:\n- 'chat': full chat panel + voice mic — default for support / sales / general.\n- 'voice_only': mic-only bubble that launches a voice call directly — pick only when the user explicitly asks for a voice-only widget.\n- 'headless': no UI; customer drives via window.DialogBrain JS API — pick only when the user explicitly says 'embed in our own design'.\nOMIT to leave the display mode unchanged."
},
"header_title": {
"type": "string",
"description": "Title shown in chat header"
},
"greeting_text": {
"type": "string",
"description": "Custom greeting message shown when visitor opens the chat (e.g., 'Hello! How can I help you today?')"
},
"primary_color": {
"type": "string",
"description": "Primary color for widget theme (hex, e.g., '#2563eb')"
},
"voice_greeting": {
"type": "string",
"description": "Spoken opening line when a visitor starts a voice call through this widget. Played via TTS before the AI model runs. Empty string disables the greeting."
},
"allowed_domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of allowed domains for the widget"
},
"auto_reply_mode": {
"enum": [
"draft",
"auto"
],
"type": "string",
"description": "Auto-reply mode: 'draft' or 'auto'. OMIT to leave the auto-reply mode unchanged."
},
"header_subtitle": {
"type": "string",
"description": "Subtitle shown in chat header"
},
"greeting_enabled": {
"type": "boolean",
"description": "Enable or disable the proactive greeting. OMIT to leave this flag unchanged."
},
"greeting_behavior": {
"enum": [
"notification",
"auto_open",
"on_open"
],
"type": "string",
"description": "notification = show badge after delay; auto_open = open widget automatically after delay; on_open = greet only when visitor manually opens. OMIT to leave the greeting behavior unchanged."
},
"enable_form_action": {
"type": "boolean",
"description": "Enable or disable the contact form action button. OMIT to leave this flag unchanged."
},
"voice_button_label": {
"type": "string",
"description": "Localized aria-label and hover tooltip for the voice-only mic bubble (only used when display_mode='voice_only'). ≤ 100 chars. Defaults to 'Talk to agent' if not set."
},
"contact_form_fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fields to collect in contact form (e.g., ['name', 'email', 'phone'])"
},
"enable_search_action": {
"type": "boolean",
"description": "Enable or disable the search action button. OMIT to leave this flag unchanged."
},
"show_visitor_history": {
"type": "boolean",
"description": "Show full chat history to returning visitors. OMIT to leave this flag unchanged."
},
"identification_fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fields to require for visitor identification (e.g., ['name', 'email'])"
},
"enable_calendar_action": {
"type": "boolean",
"description": "Enable or disable the calendar booking action button. OMIT to leave this flag unchanged."
},
"greeting_delay_seconds": {
"type": "integer",
"description": "Delay in seconds before the proactive greeting appears (0–300). 0 = send immediately on page load. Default: 30."
},
"require_identification": {
"type": "boolean",
"description": "Require visitor to identify before chatting. OMIT to leave the identification policy unchanged."
},
"returning_greeting_text": {
"type": "string",
"description": "Greeting for returning visitors who already have chat history (e.g., 'Welcome back! How can I help you today?'). Falls back to greeting_text if not set."
}
}
}Parent server
io.github.saloprj/dialogbrain
https://github.com/saloprj/dialogbrain-mcp
1/7 registries