DocumentaçãoEnviar dados
Conectores
Já usa PostHog ou Mixpanel? Conecte em minutos e a Holdy importa seus eventos continuamente, com backfill e deduplicação automáticos.
Se o seu produto já está instrumentado no PostHog ou no Mixpanel, você não precisa reinstrumentar nada: a Holdy puxa os eventos de lá em sincronização contínua e os trata exatamente como eventos nativos — mesmo pipeline, mesmos behaviors.
PostHog
Em Configurações → Integrações → PostHog, crie no seu PostHog uma personal API key com os escopos user:read, project:read, group:read, hog_function:write e batch_export:write, escolha a região (US, EU ou self-hosted) e cole a chave. A Holdy descobre o projeto e os tipos de grupo sozinha; quando há mais de um, ela pergunta.
O que acontece por trás, pelo caminho que o próprio PostHog recomenda pra integrações:
- Tempo real — a Holdy cria no seu PostHog um destino (data pipeline) que manda cada evento pra ela em segundos, assinado. Eventos de ruído (
$autocapture,$feature_flag_called, web vitals) ficam de fora, o que também reduz o custo de triggers no seu plano PostHog. - Histórico — os últimos N dias (padrão 30) vêm por exportações oficiais, uma semana por vez, em segundo plano. A tela mostra o progresso.
- Identidade — o e-mail da pessoa e o vínculo entre o anônimo e o identificado chegam junto, então o histórico antes do login é fundido à pessoa, como no SDK.
- Conta — o tipo de grupo que você escolher (empresa, workspace) vira a conta, com o nome do grupo. Sem Group Analytics, a conta nasce da empresa do e-mail corporativo.
O mapeamento preserva a semântica do PostHog:
| PostHog | Holdy |
|---|---|
event | event ($rageclick e $exception viram a fricção do SDK) |
timestamp | occurred_at |
distinct_id · $anon_distinct_id | user_id e anonymous_id |
| e-mail da pessoa | properties.email (resolução de conta) |
| grupo escolhido | conta |
$current_url, $session_id, $browser… | context |
$feature/* | context.feature_flags |
$survey_* | properties.survey_* |
uuid | external_id (deduplicação) |
Pausar desliga o destino no PostHog; desconectar remove. Uma chave revogada ou um destino apagado aparecem na tela com o que fazer, e nada para em silêncio.
Mixpanel
Em Settings → Integrações → Mixpanel, informe as credenciais do projeto e a janela de backfill. A importação usa a Raw Export API, dia a dia.
| Mixpanel | Holdy |
|---|---|
event | event |
properties.time | occurred_at |
properties.distinct_id | user_id |
properties.$email | e-mail para resolução de conta |
properties.$insert_id | external_id (deduplicação) |
O Mixpanel não tem conceito nativo de conta (group) — a Holdy resolve a conta pelo domínio do e-mail do usuário, no pipeline de identidade.
Garantias
- Deduplicação determinística — cada evento carrega o ID da origem como
external_id; re-importar uma janela nunca duplica dados. - Mesmo pipeline — conectores entram pelo mesmo caminho de validação, deduplicação e identidade do SDK e da API REST.
- SDK é a fonte, o conector traz o passado — a partir do primeiro evento do SDK, os eventos novos vêm só dele; o conector importa o histórico de antes. Os dois podem ficar ligados juntos sem contar nada duas vezes.