Documentação/Visão geral

Visão geral

A Holdy transforma observações de produto em melhorias de produto, continuamente. Ela não é uma ferramenta de analytics: em vez de responder perguntas com gráficos, ela cria conhecimento acionável de forma proativa — encontra oportunidades no comportamento de uso e propõe planos de ação com evidência.

Como funciona

Todo dado entra como evento e percorre um pipeline determinístico:

  1. Entrada — eventos chegam pelo SDK, pela API REST ou por conectores (PostHog e Mixpanel).
  2. Dados — cada evento é normalizado e ligado a um usuário e a uma conta (identity resolution, incluindo o merge de sessões anônimas quando o usuário se identifica).
  3. Conhecimento — eventos viram behaviors: padrões de uso com significado ("ativou o workspace", "convidou o time"). Você define os principais por composição; a IA sugere candidatos.
  4. Detecção — a Holdy observa o estado de cada behavior por conta e detecta mudanças, que viram signals (positivos, negativos ou neutros).
  5. Inteligência — signals são interpretados com contexto de negócio e viram opportunities: o que melhorar, para quem, com qual impacto esperado.
  6. Execução — cada opportunity gera um action plan visível no produto, com a evidência que o sustenta.

Conceitos

ConceitoO que é
EventFato bruto e imutável emitido pelo seu produto ("invite_sent"). Nunca aparece direto na interface — é evidência de drill-down.
BehaviorPadrão de uso com significado, definido por composição de eventos. Versionado: mudar a definição cria uma versão nova.
ObservationEstado atual de um behavior num escopo ("ativação em 82% no plano Enterprise").
SignalMudança de estado detectada. Tipado como positivo, negativo ou neutro, e expira — sinal velho não vira ruído.
InsightExplicação do porquê de um signal, escrita pela IA sempre citando os behaviors envolvidos.
OpportunityDecisão acionável: signal + insight + contexto de negócio. É a unidade central do produto.
Action planPlano concreto de execução para uma opportunity, entregue na interface.
EvidenceTodo signal, insight e opportunity liga aos dados que o sustentam: métricas, timeline e eventos crus.

Princípios

  • A IA nunca calcula métrica. Métricas são determinísticas, calculadas por engines. A IA interpreta.
  • Nada existe sem evidência. Toda recomendação carrega o caminho até os dados que a geraram.
  • Proativa por padrão, exploratória sempre. Nenhuma tela exige input para mostrar valor — mas toda pergunta pode ser feita no chat.

Para começar a enviar dados, siga o início rápido.