Configuration Parameters

All parameters are defined in the window.taubotConfig object before the widget loads.

Required

appId — string required

Your assistant's unique identifier, provided by TAU.

appId: 'mysite.com'

Button appearance

chatbotButtonBackground — string

Button background color. Accepts any valid CSS value.

chatbotButtonBackground: '#4834D4' // Default: '#009588'

chatbotButtonForeground — string

Button icon/text color.

chatbotButtonForeground: '#FFFFFF' // Default: '#FFFFFF'

chatbotButtonSize — number

Button size in pixels.

chatbotButtonSize: 60 // Default: 62

showChatbotButton — boolean

Shows or hides the chat button.

showChatbotButton: true // Default: true

chatbotButtonOpenStateSVG / chatbotButtonClosedStateSVG — string

Custom SVG code for the button icon in open and closed states.

chatbotButtonClosedStateSVG: '<svg>...</svg>'

Positioning

chatbotButtonBottom — number

Distance in pixels from the bottom edge of the screen.

chatbotButtonBottom: 20 // Default: 20

chatbotButtonRight — number

Distance in pixels from the right edge of the screen.

chatbotButtonRight: 20 // Default: 20

chatbotSpaceFromButton — number

Space in pixels between the button and the chat window.

chatbotSpaceFromButton: 72 // Default: 72

Window dimensions

chatWidth — number

Width in pixels (default mode).

chatWidth: 400 // Default: 400

chatWidthCool — number

Width in pixels (cool mode).

chatWidthCool: 700 // Default: 700

maxChatHeight — number

Maximum window height in pixels.

maxChatHeight: 700 // Default: 700

percentChatHeight — number

Percentage of screen height occupied by the chat.

percentChatHeight: 80 // Default: 80

mobileWidthThreshold — number

Width in pixels that defines when to use the mobile layout.

mobileWidthThreshold: 500 // Default: 500

Behavior

mode — string

Display mode. Options: 'default' or 'cool'.

mode: 'cool' // Default: 'default'

defaultRoute — string

Initial chat route. Options: 'home' or 'chat'.

defaultRoute: 'chat' // Default: 'home'

defaultMessage — string

Pre-filled message in the input box.

defaultMessage: 'Hi! I need help.'

autoOpen — boolean

Opens the chat automatically when the page loads.

autoOpen: true // Default: false

alwaysOpenOnMobile — boolean

Forces automatic opening on mobile devices.

alwaysOpenOnMobile: true // Default: false

closeChatOnOutsideClick — boolean

Closes the chat when clicking outside the window.

closeChatOnOutsideClick: true // Default: false

WhatsApp integration

enableWhatsApp — boolean

Enables WhatsApp mode (redirects to WhatsApp instead of opening the chat).

enableWhatsApp: true // Default: false

whatsAppNumber — string

Phone number in international format.

whatsAppNumber: '+15551234567'

whatsAppMessage — string

Pre-filled message when opening WhatsApp.

whatsAppMessage: 'Hi! I came from your website and need help.'

Advanced visual customization

calloutBorder / calloutBackgroundColor / calloutFontColor — string

Colors for the callout/bubble element near the button.

calloutBorder: '#A8A8A8',
calloutBackgroundColor: '#FFFFFF',
calloutFontColor: '#333333'

Authenticated user

See the full documentation at Authenticated Area.

user: {
  id: 'user123',
  hash: 'SERVER_GENERATED_HMAC',
  name: 'John Smith',
  email: 'john@example.com',
  phone: '+15551234567',
  profile_picture_url: 'https://...',
  created_at: 1701967378
}