Analytics
PostHog no seu produto e nos seus agentes de IA, por uma API
O toolkit do PostHog cobre organizações e projetos, definições de eventos, queries ad hoc, insights, dashboards, pessoas, coortes e anotações. Seu cliente conecta o PostHog uma vez com uma chave de API pessoal, e seu produto ou agente de IA chama cada operação pelo Connect, que guarda as credenciais e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/posthog_run_query/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"project_id": "<project_id>",
"query": {}
}
}Como funciona
Do cliente conectado à primeira chamada no PostHog.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do PostHog. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o PostHog.
Analytics dentro do seu produto
Rode uma query e leia insights e tiles de dashboards com seus resultados em cache para mostrar analytics de produto nas suas próprias telas.
Agente responde perguntas sobre dados
Um agente de IA lista as definições de eventos e roda uma query para responder o que os usuários fizeram, com cada chamada guardada no log de auditoria.
Marque lançamentos nos gráficos
Crie uma anotação quando uma campanha ou release for ao ar, para o momento aparecer em todos os gráficos do projeto.
Tools
12 tools do PostHog
- Listar organizaçõesGETLista as organizações que a chave alcança, cada uma com seus projetos em teams. O project_id de cada team é o que as outras ferramentas pedem. Pagine com limit e offset.
- Listar definições de eventosGETLista os eventos rastreados no projeto com nome, descrição, tags e last_seen_at, para usar em queries e anotações. Pagine com limit e offset.
- Executar queryPOSTExecuta uma query de analytics ad hoc e retorna seus resultados, até 100 linhas a menos que o SQL defina um LIMIT. Não é uma exportação: o PostHog recusa OFFSET, limita cada projeto a 3 queries ao mesmo tempo e debita cada query de um orçamento de leitura por hora.
- Listar insightsGETLista os insights do projeto com id, short_id, nome, descrição e query. A menos que basic seja true, cada um também traz seu resultado em cache. Pagine com limit e offset.
- Obter insightGETRetorna um insight com sua query e resultado. Por padrão o resultado vem do cache, e refresh com blocking o calcula de novo quando está desatualizado.
- Listar dashboardsGETLista os dashboards do projeto com id, nome, descrição, pinned e tags. Pagine com limit e offset.
- Obter dashboardGETRetorna um dashboard com seus filtros e tiles, cada tile com seu insight e o resultado em cache.
- Listar pessoasGETLista as pessoas do projeto com seus distinct_ids e propriedades. search as encontra por email, nome, id da pessoa ou distinct id. Pagine com limit e offset.
- Listar coortesGETLista as coortes do projeto com id, nome, descrição, quantidade de pessoas e se são estáticas. Pagine com limit e offset.
- Listar anotaçõesGETLista as anotações do projeto, as notas fixadas em um momento dos gráficos, com id, content, date_marker e scope. Pagine com limit e offset.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
Na conexão, o cliente informa também {region}: o endereço da conta dele na API do app.
Perguntas sobre o toolkit do PostHog
Preciso implementar a API do PostHog?
Não. O Connect já traz 12 tools do PostHog descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do PostHog?
Pelo modo que o toolkit aceita: Chave de API. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
