FAQ — Perguntas Frequentes

Instalação e configuração

Como instalar o widget TAU no meu site?

Adicione este código antes do </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.

Onde encontro meu App ID?

No dashboard TAU, em Configurações do Widget. Geralmente é o domínio do seu site (ex: meusite.com.br).

O widget funciona em dispositivos móveis?

Sim. É totalmente responsivo e se adapta automaticamente ao tamanho da tela.

Personalização

Como personalizar as cores do widget?

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

Qual a diferença entre modo default e cool?

• default: chat próximo ao botão, design discreto, ideal para sites corporativos
• cool: chat centralizado com overlay escuro, mais chamativo, ideal para sites modernos

Como fazer o chat abrir automaticamente?

window.taubotConfig = {
  appId: 'seu-app-id',
  autoOpen: true           // abre em todos os dispositivos
  // alwaysOpenOnMobile: true  // apenas mobile
};

WhatsApp

Como ativar o modo WhatsApp?

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

Posso usar WhatsApp e chat ao mesmo tempo?

Não diretamente — o widget opera em um modo por vez. Mas você pode alternar programaticamente com window.myChatbot.updateConfig() baseado em condições (horário, página, etc.).

Problemas técnicos

O widget não aparece no meu site. O que fazer?

Verifique:

• ✅ appId 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

Como debugar problemas no widget?

Abra o console (F12) e verifique:

console.log(window.myChatbot);    // widget carregado?
console.log(window.taubotConfig); // configuração correta?

O widget está lento para carregar. Como otimizar?

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 padrão
• ✅ Configure autoOpen: false se não precisar

Segurança e privacidade

O widget é seguro para usar no meu site?

Sim:

• ✅ Conexão HTTPS segura
• ✅ Compatível com CSP (Content Security Policy)
• ✅ Carrega em iframe isolado
• ✅ Conformidade com LGPD

Como configurar usuários logados com segurança?

Use HMAC gerado no servidor — veja o guia completo em Área Logada.

Analytics

Como integrar com Google Analytics?

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' });
  }
  if (event.data.type === 'conversion') {
    gtag('event', 'conversion', { event_category: 'lead_generation' });
  }
});

Veja mais integrações em Eventos.