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 Settings → Integrações → PostHog, informe:
- API key pessoal do PostHog;
- Host — US cloud, EU cloud ou self-hosted;
- Group type que representa a conta no seu setup (empresa, workspace…);
- Janela de backfill — quantos dias de histórico importar (default: 30).
A partir daí a sincronização roda de hora em hora. O mapeamento preserva a semântica do PostHog:
| PostHog | Holdy |
|---|---|
event | event |
timestamp | occurred_at |
distinct_id | user_id (identificado) ou anonymous_id |
| group escolhido | conta |
properties | properties (internas $ viram context) |
uuid | external_id (deduplicação) |
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. - Mesma porta de entrada — conectores usam o mesmo endpoint público da API REST. Nenhum atalho interno.
- Convivência com o SDK — você pode usar conector e SDK ao mesmo tempo; a identidade é resolvida no mesmo grafo.