Implantação em nuvem

Visão Geral

tracio.ai é uma plataforma de nuvem totalmente gerenciada. Sua aplicação envia sinais do navegador e a nuvem retorna um resultado de identificação. A plataforma cuida do escalonamento, da redundância e do gerenciamento de infraestrutura.

Começar leva minutos: crie uma conta, obtenha sua chave pública, instale o SDK e comece a identificar visitantes.

Somente nuvem gerenciada. A TRACIO não oferece implantação self-hosted nem on-premise — não existe componente de servidor instalável. O que você pode controlar é a região de dados a partir da qual seu tráfego é atendido (veja abaixo) e, se quiser servir o agente a partir do seu próprio domínio, um proxy first-party na frente do endpoint gerenciado, pelas opções endpoint / scriptUrl.

Como Funciona

Sua aplicação se comunica com a nuvem através do SDK JavaScript no cliente. O SDK carrega um agente no navegador, coleta sinais e retorna o resultado de identificação:

Browser (JS SDK)  ──▶  tracio.ai Cloud
                  ◀──  (identification result)

1. O SDK do navegador carrega o agente e coleta sinais.
2. Os sinais são enviados para a nuvem tracio.ai.
3. A nuvem retorna o resultado: informações de visitorId e bot.

Para agir sobre os resultados no seu próprio servidor, receba cada identificação como um webhook assinado ou leia-os sob demanda pela Server API.

Primeiros Passos

1. Cadastre-se e abra seu dashboard.
2. Escolha sua região de dados (veja abaixo).
3. Copie sua chave pública — é seguro incluí-la no código do cliente.
4. Instale o SDK e inicialize-o:

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "5ca175fc...",
  region: "eu",
})

Regiões de Dados

A opção region do SDK seleciona com qual região de dados o SDK se comunica. Ela aceita "us" ou "eu". Quando não definida, o SDK usa o endpoint genérico https://edge.tracio.ai — defina-a explicitamente para fixar uma região.

Gerenciamento de Chaves de API

Seu workspace usa dois tipos de chave, e elas não são intercambiáveis:

• Crie e gerencie ambas no dashboard, em API Keys. Chaves secretas exigem o plano Pro ou superior.
• Uma chave secreta é exibida uma única vez, na criação — do nosso lado fica apenas um hash. Se você a perder, ela não é recuperada: é rotacionada.
• Ao rotacionar uma chave secreta, a anterior continua funcionando por 7 dias, para que você implante sem indisponibilidade. Chaves públicas não são rotacionadas: elas não são segredo e, por design, ficam visíveis no código-fonte da sua página.

Para consumir resultados no servidor você tem duas opções, e elas combinam bem:

• Configure um webhook — cada identificação é entregue ao seu endpoint, assinada com X-Tracio-Signature.
• Chame a Server API com sua chave secreta para ler sob demanda o histórico de um visitante, sessões individuais ou contadores de velocity.

Webhooks

Você pode configurar webhooks para receber eventos de identificação da nuvem no seu próprio servidor. Webhooks estão disponíveis a partir do plano Pro — veja Webhooks para detalhes de configuração, payload e verificação de assinatura.