Parâmetros de Configuração

Todos os parâmetros são definidos no objeto window.taubotConfig antes do carregamento do widget.

Obrigatórios

appId — string obrigatório

Identificador único do seu assistente, fornecido pelo TAU.

appId: 'meusite.com.br'

Aparência do botão

chatbotButtonBackground — string

Cor de fundo do botão. Aceita qualquer valor CSS válido.

chatbotButtonBackground: '#4834D4' // Padrão: '#009588'

chatbotButtonForeground — string

Cor do ícone/texto do botão.

chatbotButtonForeground: '#FFFFFF' // Padrão: '#FFFFFF'

chatbotButtonSize — number

Tamanho do botão em pixels.

chatbotButtonSize: 60 // Padrão: 62

showChatbotButton — boolean

Exibe ou oculta o botão do chat.

showChatbotButton: true // Padrão: true

chatbotButtonOpenStateSVG / chatbotButtonClosedStateSVG — string

Código SVG customizado para o ícone do botão nos estados aberto e fechado.

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

Posicionamento

chatbotButtonBottom — number

Distância em pixels da borda inferior da tela.

chatbotButtonBottom: 20 // Padrão: 20

chatbotButtonRight — number

Distância em pixels da borda direita da tela.

chatbotButtonRight: 20 // Padrão: 20

chatbotSpaceFromButton — number

Espaço em pixels entre o botão e a janela do chat.

chatbotSpaceFromButton: 72 // Padrão: 72

Dimensões da janela

chatWidth — number

Largura em pixels (modo default).

chatWidth: 400 // Padrão: 400

chatWidthCool — number

Largura em pixels (modo cool).

chatWidthCool: 700 // Padrão: 700

maxChatHeight — number

Altura máxima da janela em pixels.

maxChatHeight: 700 // Padrão: 700

percentChatHeight — number

Porcentagem da altura da tela que o chat ocupa.

percentChatHeight: 80 // Padrão: 80

mobileWidthThreshold — number

Largura em pixels que define quando usar layout mobile.

mobileWidthThreshold: 500 // Padrão: 500

Comportamento

mode — string

Modo de exibição. Opções: 'default' ou 'cool'.

mode: 'cool' // Padrão: 'default'

defaultRoute — string

Rota inicial do chat. Opções: 'home' ou 'chat'.

defaultRoute: 'chat' // Padrão: 'home'

defaultMessage — string

Mensagem pré-preenchida na caixa de entrada.

defaultMessage: 'Olá! Preciso de ajuda.'

autoOpen — boolean

Abre o chat automaticamente ao carregar a página.

autoOpen: true // Padrão: false

alwaysOpenOnMobile — boolean

Força abertura automática em dispositivos móveis.

alwaysOpenOnMobile: true // Padrão: false

closeChatOnOutsideClick — boolean

Fecha o chat ao clicar fora da janela.

closeChatOnOutsideClick: true // Padrão: false

Integração WhatsApp

enableWhatsApp — boolean

Ativa o modo WhatsApp (redireciona para o WhatsApp ao invés de abrir o chat).

enableWhatsApp: true // Padrão: false

whatsAppNumber — string

Número no formato internacional.

whatsAppNumber: '+5511999999999'

whatsAppMessage — string

Mensagem pré-preenchida ao abrir o WhatsApp.

whatsAppMessage: 'Olá! Vim do site e preciso de ajuda.'

Personalização visual avançada

calloutBorder / calloutBackgroundColor / calloutFontColor — string

Cores dos elementos callout/balão próximo ao botão.

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

Usuário logado

Veja a documentação completa em Área Logada.

user: {
  id: 'user123',
  hash: 'HMAC_GERADO_NO_SERVIDOR',
  name: 'João Silva',
  email: 'joao@example.com',
  phone: '+5511999999999',
  profile_picture_url: 'https://...',
  created_at: 1701967378
}