Cloud Deployment

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.

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.

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

• Sua chave pública é destinada ao navegador e é segura para expor no código do cliente.
• Gerencie e rotacione chaves a partir do seu dashboard.
• Para consumir resultados no servidor, configure um webhook — cada identificação é entregue ao seu endpoint, assinada com X-Tracio-Signature.

Webhooks

Você pode configurar webhooks para receber notificações da nuvem. Veja Webhooks para detalhes de configuração e do payload.