Node.js

Inteligência de dispositivos para Node.js

Receba e verifique os webhooks de identificação em Node.js e Express. Adicione identificação de visitantes, detecção de bots e smart signals à sua aplicação Node.js em minutos.

Comece agora Agendar uma demonstração

Instalação rápida

Adicione o SDK ao seu projeto com o gerenciador de pacotes de sua preferência.

npmnpm install express

yarnyarn add express

pnpmpnpm add express

Uso básico

Coloque tudo em funcionamento com a configuração mínima.

$typescript

import express from 'express'
const app = express()
// Capture the raw body so the signature can be verified byte-for-byte.
app.use(express.json({ verify: (req, _res, buf) => ((req as any).rawBody = buf) }))
// Identification events are pushed here in real time
app.post('/webhook/tracio', (req, res) => {
  const event = req.body
  console.log(event.visitorId, event.bot.result)
  res.status(200).send('OK')
})
app.listen(3000)

Padrões avançados

Padrões prontos para produção com tratamento de erros, estados de carregamento e configuração avançada.

Handler de Express com verificação de assinatura — Clique para expandir

import express from 'express'
import crypto from 'crypto'
const app = express()
app.use(express.json({ verify: (req, _res, buf) => ((req as any).rawBody = buf) }))
// Recompute the HMAC-SHA256 over "<t>.<rawBody>" and compare it.
function verify(rawBody: Buffer, header: string, secret: string): boolean {
  const p = Object.fromEntries(header.split(',').map((kv) => kv.split('=') as [string, string]))
  const signed = Buffer.concat([Buffer.from(`${p.t}.`), rawBody])
  const expected = crypto.createHmac('sha256', secret).update(signed).digest('hex')
  const a = Buffer.from(p.v1, 'hex')
  const b = Buffer.from(expected, 'hex')
  return a.length === b.length && crypto.timingSafeEqual(a, b)
}
app.post('/webhook/tracio', (req, res) => {
  const sig = req.headers['x-tracio-signature'] as string
  if (!verify((req as any).rawBody, sig, process.env.TRACIO_WEBHOOK_SECRET!)) {
    return res.status(401).json({ error: 'Invalid signature' })
  }
  const event = req.body
  if (event.bot.result === 'bot') {
    return res.status(200).json({ action: 'blocked', visitorId: event.visitorId })
  }
  if (event.decision.riskScore > 50) {
    return res.status(200).json({ action: 'review', visitorId: event.visitorId })
  }
  res.status(200).json({ action: 'allow', visitorId: event.visitorId })
})
app.listen(3000)

Opções de configuração

Todas as opções disponíveis para inicializar e configurar o SDK.

publicKeystringSua chave pública do painel — segura para enviar no navegador

endpointstringURL de endpoint personalizada para implantações roteadas via proxy — uma URL explícita prevalece sobre region

regionstringRegião de dados: us ou eu

timeoutMsnumberTimeout de toda a chamada getResult(), em milissegundos

linkedIdstringO ID interno da conta do usuário autenticado, para vincular visitas que compartilham um dispositivo

tagstringRótulo livre anexado à requisição de identificação, ex.: checkout ou login

debugbooleanRegistra o ciclo de vida do script e a atividade de rede no console do navegador

scriptUrlstringSubstituição completa da URL do script do agente — para self-hosting ou Subresource Integrity

Próximos passos

Aprofunde-se com a referência completa da API, a configuração de webhooks e guias avançados.

Documentação

Referência completa da API, guias de integração e boas práticas.

Ler a documentação

Webhooks

Entrega de eventos em tempo real, schema de payload e verificação de assinatura.

Ver Webhooks