❓ Perguntas Frequentes

A instalação é simples! Adicione este código antes do fechamento da tag </body>:

<script>
window.taubotConfig = {
    appId: 'SEU_APP_ID'
};
(function() {
    var script = document.createElement('script');
    script.src = 'https://app.taubot.ai/widget/widget.js';
    script.async = true;
    document.head.appendChild(script);
})();
</script>

Substitua SEU_APP_ID pelo ID fornecido no dashboard TAU.

Seu App ID está disponível no dashboard TAU, na seção "Configurações do Widget". Geralmente é baseado no domínio do seu site (ex: meusite.com.br).

Sim! O widget é totalmente responsivo e funciona perfeitamente em smartphones e tablets. Ele se adapta automaticamente ao tamanho da tela.

Use os parâmetros de configuração:

window.taubotConfig = {
    appId: 'seu-app-id',
    chatbotButtonBackground: '#FF5722',
    chatbotButtonForeground: '#FFFFFF'
};

Veja a Configuração Interativa para testar cores em tempo real.

Modo Default: Chat posicionado próximo ao botão, design mais discreto.
Modo Cool: Chat centralizado na tela com overlay escuro, mais chamativo e moderno.

mode: 'cool' // ou 'default'

Use o parâmetro autoOpen:

window.taubotConfig = {
    appId: 'seu-app-id',
    autoOpen: true
};

Para abrir apenas em mobile: alwaysOpenOnMobile: true

Configure o widget para redirecionar para o WhatsApp:

window.taubotConfig = {
    appId: 'seu-app-id',
    enableWhatsApp: true,
    whatsAppNumber: '+5511999999999',
    whatsAppMessage: 'Olá! Vim do site e preciso de ajuda.'
};

Não diretamente. O widget funciona em um modo por vez. Mas você pode alternar programaticamente baseado em condições (horário, página, etc.) usando JavaScript.

Verifique:

• ✅ App ID está correto
• ✅ Script está antes do </body>
• ✅ Não há erros no console (F12)
• ✅ showChatbotButton: true está configurado
• ✅ Domínio está autorizado no dashboard TAU

Abra o console do navegador (F12) e verifique:

// Verificar se widget carregou
console.log(window.myChatbot);

// Verificar configuração
console.log(window.taubotConfig);

Use nossa ferramenta de teste para debugar em tempo real.

O widget já carrega de forma assíncrona. Para otimizar:

• ✅ Use o CDN oficial (app.taubot.ai)
• ✅ Não modifique o código de carregamento
• ✅ Evite muitas configurações desnecessárias
• ✅ Configure autoOpen: false se não precisar

Sim! O widget TAU:

• ✅ Usa conexão HTTPS segura
• ✅ Não coleta dados pessoais sem consentimento
• ✅ É compatível com CSP (Content Security Policy)
• ✅ Segue as diretrizes da LGPD
• ✅ Carrega de forma isolada (iframe)

Use HMAC para autenticação segura:

// No servidor (nunca no frontend!)
const hash = crypto.createHmac('sha256', SECRET_KEY)
    .update(userId)
    .digest('hex');

// No frontend
window.taubotConfig = {
    user: {
        id: 'user123',
        hash: hash, // Gerado no servidor
        name: 'João Silva'
    }
};

Veja o guia completo em Área Logada.

Capture os eventos do widget:

window.addEventListener('message', function(event) {
    if (event.origin !== 'https://app.taubot.ai') return;
    
    if (event.data.type === 'Opened chat window') {
        gtag('event', 'chat_opened', {
            event_category: 'engagement'
        });
    }
});

Veja mais exemplos em Eventos.

Sim! O widget oferece uma API completa:

// Abrir chat
window.myChatbot.openChat();

// Fechar chat
window.myChatbot.closeChat();

// Atualizar configuração
window.myChatbot.updateConfig({
    chatbotButtonBackground: '#FF5722'
});

Veja todos os métodos em Manipulação JS.

Os limites dependem do seu plano TAU. Consulte o dashboard para ver seu uso atual e limites específicos.

Sim, mas cada site precisa de um App ID específico. Você pode gerenciar múltiplos sites no dashboard TAU.