Início rápido

Existem três portas de entrada, e todas convergem no mesmo endpoint — escolha a que encaixa no seu caso:

• SDK — o caminho primário. Instrumenta seu produto direto, no browser e no servidor.
• Conectores — se você já usa PostHog ou Mixpanel, a Holdy puxa os eventos de lá. Sem código.
• API REST — para qualquer outra stack, um POST simples.

1. Crie uma API key

Em Settings → API, crie uma chave. Ela tem o formato hol_live_… (ou hol_test_… em ambiente de teste) e vai no header Authorization de toda chamada.

2. Instale o SDK

npm install @holdy/sdk

3. Envie o primeiro evento

import { initHoldy } from '@holdy/sdk/web'

const holdy = initHoldy({ apiKey: 'hol_live_...' })

holdy.track('invite_sent', { plan: 'pro' })

Pronto — o evento entra no pipeline. O SDK gerencia sessão anônima, fila e retry sozinho.

4. Identifique usuário e conta

Quando o usuário faz login, identifique-o; quando você sabe a que empresa ele pertence, associe a conta:

holdy.identify('user_42', { role: 'admin' })
holdy.group('acme-inc', { plan: 'scale' })

Os IDs são os do seu produto — a Holdy resolve a identidade do lado dela, incluindo o merge do histórico anônimo quando o usuário se identifica.

O que acontece depois

Com eventos fluindo, a Holdy começa a compor behaviors (você define os principais em minutos, com sugestões da IA), observa o estado por conta e passa a detectar signals. As primeiras opportunities aparecem no Overview — com a evidência de onde vieram.