Documentação da Noxtica
Bem-vindo à documentação da Noxtica. A Noxtica é uma plataforma de detecção de bots que ajuda você a distinguir visitantes reais de tráfego automatizado e fraudulento — para que você possa proteger cadastros, logins, checkout e o restante do seu produto.
O que é a Noxtica?
A Noxtica analisa os muitos pequenos sinais que o navegador e o dispositivo de cada visitante produzem naturalmente, depois os verifica cruzadamente para identificar bots, ferramentas de automação e comportamentos suspeitos. Usuários reais deixam uma imagem coerente; falsificadores deixam contradições.
Principais recursos
- Reconhecimento de dispositivo: construa uma imagem estável e respeitosa da privacidade de cada visitante a partir de uma ampla variedade de sinais de navegador e dispositivo
- Detecção de bots: identifique automação, configurações headless e visitantes se passando por algo que não são, detectando as contradições que deixam para trás
- Pontuação de risco calibrada: obtenha um score de risco de 0 a 100, um nível de confiança e um nível de risco em linguagem clara no qual você pode agir
- API em tempo real: consulte o risco de um visitante a partir do seu backend em bem menos de um décimo de segundo
- Multi-tenant: gerencie vários sites e domínios a partir de uma única conta
Componentes da plataforma
| Componente | Descrição |
|---|---|
| Collector SDK | Um pequeno snippet JavaScript que você adiciona ao seu site |
| Collector API | Um serviço globalmente distribuído que pontua visitantes instantaneamente |
| Backoffice | Painel administrativo para analytics, API Keys e configuração |
| Server API | Uma API simples para consultar o risco de visitantes no backend |
Início rápido
1. Obtenha sua Site Key
Após se cadastrar, faça login no Backoffice e adicione seu domínio. Você receberá uma Site Key (pk_prod_...).
2. Adicione o Collector
Incorpore o collector ao seu site:
<script
src="https://collect.noxtica.com/collector/noxtica.js"
data-site-key="pk_prod_your_site_key_here"
data-auto-init
data-auto-check-once
async
></script>
Content Security Policy
Se o seu site usa uma content-security-policy, você precisará permitir que a Noxtica carregue e execute. O snippet abaixo cobre tudo que o collector precisa — incluindo seu runtime resistente a adulteração, a KHAN VM.
Content-Security-Policy:
default-src 'self';
script-src 'self' 'wasm-unsafe-eval' https://collect.noxtica.com;
connect-src 'self' https://collect.noxtica.com;
Se a política estiver faltando um desses itens, o collector continua funcionando, mas com proteção contra adulteração mais fraca. Consulte a seção Primeiros Passos → Content Security Policy para a referência completa e solução de problemas.
3. Receba scores de risco
O collector entrega uma avaliação de risco em tempo real:
document.addEventListener('noxtica:collected', function (e) {
console.log('Risk Score:', e.detail.score);
console.log('Risk Level:', e.detail.risk_level);
console.log('Flags:', e.detail.flags);
});
4. Consultas no servidor (opcional)
Para decisões no lado do servidor, crie uma API Key e consulte dispositivos:
curl -H "Authorization: Bearer sk_prod_your_api_key" \
"https://collect.noxtica.com/v1/device/DEVICE_ID"
Guias
- Primeiros Passos: guia completo de configuração, incluindo opções e configuração do SDK
- Browser Runtime: como o SDK funciona no navegador, cache, eventos e solução de problemas
- Integração com o Backend: integração da API no servidor para consultas de visitantes
Níveis de risco
Cada visitante recebe um nível de risco em linguagem clara com base no seu score, para que sua equipe possa agir sem precisar ler as letras miúdas:
| Score | Nível | Significado |
|---|---|---|
| 0-19 | minimal | Comportamento normal, sem alertas |
| 20-39 | low | Pequenas anomalias detectadas |
| 40-59 | medium | Alguns sinais suspeitos |
| 60-79 | high | Provável automação ou falsificação |
| 80-100 | critical | Fortes indicadores de bot |
Demonstração ao vivo
Experimente o fingerprinting em você mesmo: Demo ao vivo
Painel
Gerencie sua conta: Backoffice
Em resumo
- Versão do SDK: 3.2.0 (Schema: 2026-01-10)
- Implantação: globalmente distribuído para baixa latência em todo o mundo
- Latência: visitantes pontuados em bem menos de um décimo de segundo
- Autenticação: gerenciada automaticamente pelo SDK — nada para configurar
- Intervalo padrão de coleta: 7 dias (configurável)
Suporte
- Contato: fale conosco para suporte ou consultas comerciais
- Solicitar demo: solicite uma demonstração para ver a Noxtica em ação