🧪 Teste de Parâmetros da URL

lightbulb Como Funciona a Captura Automática

O widget TAU captura automaticamente parâmetros da URL da página onde está embedado, permitindo personalização dinâmica sem modificar o código. Esta funcionalidade é perfeita para campanhas de marketing, landing pages específicas e personalização de experiência do usuário.

science Ambiente de Teste

Esta página permite testar a funcionalidade em tempo real. Experimente os diferentes cenários abaixo e veja como os parâmetros da URL são automaticamente aplicados ao widget.

📊 Parâmetros Atuais da URL

Carregando...

🎯 Testes Rápidos

Clique nos links abaixo para testar diferentes cenários de parâmetros da URL:

chat Teste WhatsApp Message launch Teste Auto Open chat Teste WhatsApp Completo (com ícone) refresh Reset (sem parâmetros)
terminal

📋 Logs do Widget

Acompanhe em tempo real a captura de parâmetros da URL:

Os logs aparecerão aqui quando o widget carregar...

star

💎 Teste Premium - Override de Configuração Remota

info Funcionalidade Exclusiva Premium

Usuários premium podem ativar um modo especial onde parâmetros da URL sobrescrevem configurações remotas para elementos visuais.

🔧 Como Ativar (Apenas Premium)

  1. Tenha uma assinatura premium ativa
  2. Acesse o dashboard do TAU
  3. Vá em "Integração do Site" → "Configuração Avançada de URL"
  4. Ative "Permitir personalização via parâmetros da URL"
  5. Agora URLs podem sobrescrever configurações remotas!

🎨 Exemplo de Teste Premium

Com o override ativado, esta URL funcionaria mesmo com configuração remota:

star Teste Premium - Laranja + Grande
security Verificação de Status

Se você é um usuário premium e ativou o override no dashboard, o botão acima aplicará a personalização visual. Caso contrário, a configuração remota terá prioridade.

📱 Casos de Uso Premium

🎪 Campanhas Sazonais

Mude cores e ícones para datas especiais

?chatbotButtonBackground=#C41E3A
🛍️ Landing Pages

Personalize por produto ou categoria

?chatbotButtonSize=80
🎨 A/B Testing

Teste diferentes designs sem reconfigurar

?chatbotButtonOpenStateSVG=...

⚙️ Como Funciona

Este widget está configurado para capturar automaticamente parâmetros da URL de duas formas:

📋 Formatos de URL Suportados

link Múltiplos Formatos

O widget suporta tanto parâmetros de query (?param=valor) quanto hash (#param=valor):

🔒 Segurança Integrada

security Proteção XSS

Todos os parâmetros são automaticamente sanitizados, removendo caracteres perigosos como <, >, " e ' para prevenir ataques XSS.

priority_high Prioridade de Configuração

Usuários Padrão: Config padrão → Config local → Parâmetros da URL → Config remota (sempre prioridade)

Usuários Premium (com override ativado): Config padrão → Config local → Parâmetros da URL → Config remota → Parâmetros da URL (novamente)

💎 Para elementos visuais, usuários premium podem fazer parâmetros da URL sobrescreverem configuração remota.

🔄 Conversão Automática de Tipos

Parâmetros boolean são automaticamente convertidos:

Parâmetros suportados para captura automática:

whatsAppMessage string

Mensagem pré-preenchida para WhatsApp

defaultMessage string

Mensagem pré-preenchida para o chat

defaultRoute string

Rota inicial ('home' ou 'chat')

autoOpen boolean

Abrir automaticamente ('true' ou '1')

enableWhatsApp boolean

Ativar modo WhatsApp ('true' ou '1')

whatsAppNumber string

Número do WhatsApp para redirecionamento

appId string

Sobrescrever o appId

chatbotButtonBackground string

Cor de fundo do botão (ex: #00E676)

chatbotButtonForeground string

Cor do ícone do botão (ex: #FFFFFF)

chatbotButtonOpenStateSVG string

SVG personalizado para botão aberto (precisa ser codificado)

chatbotButtonSize number

Tamanho do botão em pixels

mode string

Modo de exibição ('default' ou 'cool')

🚀 Casos de Uso Práticos

Veja como usar a captura automática de parâmetros da URL em diferentes cenários:

📢 Campanhas de Marketing

Personalize mensagens baseadas na origem do tráfego:

https://meusite.com/black-friday?enableWhatsApp=true&whatsAppMessage=Vi%20a%20promoção%20Black%20Friday!

🆘 Páginas de Suporte

Abra o chat automaticamente com contexto pré-definido:

https://meusite.com/suporte?autoOpen=true&defaultMessage=Preciso%20de%20ajuda&defaultRoute=chat

🛍️ Produtos Específicos

Direcione para WhatsApp com informações do produto:

https://meusite.com/produto/123?enableWhatsApp=true&whatsAppMessage=Interesse%20no%20produto%20XYZ

📱 Personalização do Ícone WhatsApp

Use um ícone personalizado do WhatsApp com cor verde característica:

https://meusite.com/contato?enableWhatsApp=true&chatbotButtonBackground=%2300E676&chatbotButtonOpenStateSVG=[SVG_WHATSAPP_CODIFICADO]
info Dica: Codificação de URL

Para usar SVG personalizado na URL, o código deve ser codificado. Use encodeURIComponent() no JavaScript ou ferramentas online para codificar o SVG antes de usar na URL.

🎨 Personalização Visual

Combine vários parâmetros para personalizar completamente:

https://meusite.com/contato?mode=cool&chatbotButtonBackground=%234834D4&autoOpen=true
info Implementação no Seu Site

Para usar essa funcionalidade, apenas certifique-se de que seu widget esteja usando a versão mais recente. Os parâmetros serão automaticamente capturados da URL onde o widget está embedado - não é necessária nenhuma configuração adicional!