Capture eventos do TAU Widget para integrar com analytics, automações e sistemas externos.

Eventos

O TAU Widget emite eventos via window.postMessage que podem ser capturados para integração com sistemas de analytics, automações ou outras funcionalidades.

Eventos disponíveis

Evento	Quando dispara
`Loaded app`	Widget carregou completamente
`Opened chat window`	Usuário abriu a janela do chat
`Sent message`	Usuário enviou uma mensagem
`Clicked button`	Usuário clicou em um botão dentro do chat
`conversion`	Ocorreu uma conversão ou ação importante
`toolResponse`	Uma ferramenta foi executada no chat

Capturando eventos

window.addEventListener('message', function(event) {
  // Verificar origem por segurança
  if (event.origin !== 'https://app.taubot.ai') return;

  switch (event.data.type) {
    case 'Loaded app':
      console.log('Widget carregado');
      break;

    case 'Opened chat window':
      console.log('Chat aberto');
      break;

    case 'Sent message':
      console.log('Mensagem enviada');
      break;

    case 'Clicked button':
      console.log('Botão clicado');
      break;

    case 'conversion':
      console.log('Conversão:', event.data.data);
      break;

    case 'toolResponse':
      console.log('Ferramenta executada:', event.data.data);
      break;
  }
});

Sempre verifique event.origin antes de processar o evento. Isso garante que os eventos são provenientes do widget TAU oficial.

Integrações

Google Analytics (GA4)

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',
      event_label: 'tau_widget'
    });
  }

  if (event.data.type === 'conversion') {
    gtag('event', 'conversion', {
      event_category: 'lead_generation',
      value: event.data.data?.value || 1
    });
  }
});

Meta Pixel (Facebook)

window.addEventListener('message', function(event) {
  if (event.origin !== 'https://app.taubot.ai') return;

  if (event.data.type === 'conversion') {
    fbq('track', 'Lead', {
      content_name: 'TAU Widget Conversion',
      content_category: 'customer_support'
    });
  }
});

API personalizada

window.addEventListener('message', function(event) {
  if (event.origin !== 'https://app.taubot.ai') return;

  if (event.data.type === 'Sent message') {
    fetch('/api/chat-events', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        event_type: 'message_sent',
        timestamp: new Date().toISOString(),
        page_url: window.location.href
      })
    });
  }
});

Segurança

Boas práticas:

🔐 Sempre verifique event.origin === 'https://app.taubot.ai'
✅ Valide o tipo do evento antes de processar
🛡️ Não execute código baseado apenas nos dados do evento sem validação
📝 Registre eventos suspeitos para auditoria

Eventos

On this page