⚙️ Referência Completa de Parâmetros

Identificador único do seu bot fornecido pelo TAU.

appId: 'meusite.com.br'

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

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

Cor do ícone/texto do botão do chat.

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

Tamanho do botão em pixels.

chatbotButtonSize: 60 // Padrão: 62

Define se o botão do chat deve ser exibido.

showChatbotButton: true // Padrão: true

Distância em pixels da borda inferior da tela.

chatbotButtonBottom: 20 // Padrão: 20

Distância em pixels da borda direita da tela.

chatbotButtonRight: 20 // Padrão: 20

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

chatbotSpaceFromButton: 72 // Padrão: 72

Largura da janela de chat em pixels (modo padrão).

chatWidth: 400 // Padrão: 400

Largura da janela de chat em pixels (modo cool).

chatWidthCool: 700 // Padrão: 700

Altura máxima da janela de chat em pixels.

maxChatHeight: 700 // Padrão: 700

Porcentagem da altura da tela que o chat deve ocupar.

percentChatHeight: 80 // Padrão: 80

Largura em pixels que define quando usar layout mobile.

mobileWidthThreshold: 500 // Padrão: 500

Define se o chat deve abrir automaticamente ao carregar a página.

autoOpen: true // Padrão: false

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

alwaysOpenOnMobile: true // Padrão: false

Fecha o chat ao clicar fora da janela.

closeChatOnOutsideClick: true // Padrão: false

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

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

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

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

Mensagem pré-preenchida na caixa de entrada do chat.

defaultMessage: 'Olá! Preciso de ajuda.' // Padrão: null

Ativa o modo WhatsApp, redirecionando para o WhatsApp.

enableWhatsApp: true // Padrão: false

Número do WhatsApp para redirecionamento (formato internacional).

whatsAppNumber: '+5511999999999' // Padrão: '+5511999392256'

Mensagem pré-preenchida ao abrir o WhatsApp.

whatsAppMessage: 'Olá! Vim do site e preciso de ajuda.' // Padrão: null

Cor da borda dos elementos callout.

calloutBorder: '#A8A8A8' // Padrão: '#A8A8A8'

Cor de fundo dos elementos callout.

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

Cor do texto dos elementos callout.

calloutFontColor: '#333333' // Padrão: '#333333'

Código SVG customizado para o ícone do botão quando o chat está aberto.

chatbotButtonOpenStateSVG: '<svg>...</svg>'

Código SVG customizado para o ícone do botão quando o chat está fechado.

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

chatbotButtonBackground: '#00E676',
chatbotButtonOpenStateSVG: '<svg viewBox="0 0 260 260" fill="none" xmlns="http://www.w3.org/2000/svg"><g><path d="M67.6631045,221.823373 L71.8484512,223.916047..."></path></g></svg>'

URL base da aplicação TAU (normalmente não deve ser alterada).

baseAppUrl: 'https://app.taubot.ai' // Padrão: ambiente local

URL base da API TAU (normalmente não deve ser alterada).

baseAPIUrl: 'https://api.taubot.ai' // Padrão: ambiente local

ID HTML do elemento botão (uso interno).

buttonId: 'chatbot-button' // Padrão: 'chatbot-button'

ID HTML do elemento iframe (uso interno).

iframeId: 'chatbot-iframe' // Padrão: 'chatbot-iframe'

Identificador único do dispositivo (gerado automaticamente).

deviceId: null // Padrão: null (auto-gerado)

Controla se o widget deve ser carregado ou não. Útil para desabilitar o widget temporariamente.

// Controlado pela API TAU automaticamente

Texto exibido no balão de chamada próximo ao botão do chat.

// Exemplo: "Olá! Como posso ajudar?"

Define se o balão de chamada deve ser exibido.

// Controlado pela configuração do bot no dashboard

SVG customizado para o ícone do botão quando o chat está aberto (configurado remotamente).

// Sobrepõe chatbotButtonOpenStateSVG local

SVG customizado para o ícone do botão quando o chat está fechado (configurado remotamente).

// Sobrepõe chatbotButtonClosedStateSVG local

Cor de fundo do botão definida remotamente via dashboard.

// Sobrepõe chatbotButtonBackground local

Cor do ícone do botão definida remotamente via dashboard.

// Sobrepõe chatbotButtonForeground local

Quando ativado no dashboard premium, permite que parâmetros da URL tenham prioridade sobre configurações remotas para elementos visuais.

// Configurado no dashboard TAU (não via código)
// Permite URLs como: 
// site.com?chatbotButtonBackground=#FF0000&chatbotButtonOpenStateSVG=...