API do PostHog: o que dá para fazer e como usar com agentes de IA
O PostHog é uma plataforma de análise de produto com eventos, funis, gravações de sessão, feature flags e experimentos. Tem uma API pública para enviar eventos e uma API privada para consultar dados e gerenciar recursos do projeto. É usado por times de produto e engenharia, na nuvem ou em instalação própria.
Os grandes recursos da API, em português claro.
Envio de eventos e propriedades de usuários a partir de sistemas e aplicativos.
Perguntas aos dados com HogQL, a linguagem de consulta do PostHog.
Leitura e criação de relatórios salvos.
Criação e avaliação de flags para liberar funções.
Perfis de usuários e grupos por comportamento.
Acesso às gravações de navegação.
Como se acessa a API do PostHog.
- Com credencial da sua empresaO envio de eventos usa a chave pública do projeto; consultas e gestão usam chave de API pessoal com escopos escolhidos.
- Documentação oficialposthog.com/docs/api
- Gravações de sessão podem conter dados pessoais: use mascaramento e restrinja acesso.
- Consultas pesadas contam limites de uso.
- Mudanças em feature flags afetam usuários reais.
- api posthog
- posthog api documentação
- posthog hogql api
- posthog feature flags api
- posthog personal api key
- posthog mcp
- integração posthog
O que um agente do iTeam faz com a API do PostHog.
O agente consulta o funil e as gravações das sessões que abandonaram e resume os pontos de atrito para o time.
O gestor pergunta quantos cadastros vieram de uma campanha e o agente monta a consulta e responde.
O time pede para liberar uma função para um grupo e o agente prepara a mudança na flag, aplicada após aprovação.
O agente percebe quando um evento importante parou de chegar e avisa engenharia.
Da credencial ao agente trabalhando, com aprovação.
Crie a chave de API pessoal
No PostHog, gere uma chave pessoal com escopos de leitura e, se precisar, de escrita em flags.
Cadastre no cofre do iTeam
A chave fica no cofre; consultas são livres e mudanças em flags e experimentos exigem aprovação.
Compare os números
Nas primeiras semanas, confira as respostas do agente com os insights do PostHog.
Dúvidas sobre a API do PostHog.
A API do PostHog é gratuita?
O PostHog tem uma camada gratuita mensal e cobra por uso acima dela; a API acompanha o plano e os limites do projeto.
Preciso programar para usar a API do PostHog com o iTeam?
Não necessariamente. O iTeam usa a documentação e o servidor MCP do PostHog, e o time de implantação configura acessos.
Funciona com PostHog instalado no servidor?
Em geral sim, desde que a API esteja acessível pela rede da integração.
Qual a diferença entre a chave pública do projeto e a chave de API pessoal do PostHog?
A chave pública do projeto envia eventos e pode ficar no site. A chave de API pessoal, com escopos escolhidos, consulta dados e gerencia o projeto, e deve ficar em segredo. O agente que lê e analisa usa a pessoal, de preferência com escopos só de leitura.
O agente de IA consegue rodar consultas HogQL no PostHog?
Sim, a API de consultas aceita HogQL, a variação de SQL do PostHog. O agente transforma a pergunta, como quantos usuários concluíram o cadastro, em consulta e devolve o resultado em texto. Use janelas de tempo curtas para não gastar o limite de uso do plano.
O PostHog tem servidor MCP para agentes de IA?
Sim, o PostHog tem um servidor MCP próprio, que permite a agentes consultar dados e recursos do projeto. Confirme em posthog.com/docs as ferramentas disponíveis e use a mesma chave de API pessoal com escopos mínimos, para o agente não alterar o que só deveria ler.
O agente pode alterar feature flags no PostHog?
A API gerencia feature flags, mas a mudança afeta usuários reais. O agente deve propor a alteração e uma pessoa aprovar, sobretudo ao mexer na porcentagem de liberação ou na segmentação. Experimentos em andamento também não devem ser alterados sem o responsável saber.
Gravações de sessão do PostHog têm dados pessoais?
Podem ter: o que o usuário digita ou vê pode aparecer na gravação. Use o mascaramento de campos, restrinja quem acessa e mantenha o agente fora das gravações, a menos que seja necessário e esteja previsto na política de privacidade do produto.
O PostHog instalado no meu servidor funciona com o agente?
A API é a mesma, mas o endereço é o do seu servidor, e o agente precisa alcançá-lo pela rede. A TI libera o caminho, e a chave de API pessoal é gerada na própria instalação. Confira em posthog.com/docs/api as diferenças da sua versão.
O PostHog limita consultas e uso da API?
Consultas pesadas contam limites de uso e podem demorar. Faça o agente usar janelas de tempo curtas e agregar dentro do PostHog, em vez de baixar eventos brutos, o que também mantém a resposta rápida para quem perguntou.
O PostHog é útil para quem trabalha com marketing e não com produto?
Sim, quando o marketing quer saber de onde vêm os usuários que ativam. O agente responde em português a partir de eventos e funis. Sem eventos bem nomeados, porém, as respostas ficam vagas, então combine a nomenclatura dos eventos antes de ligar o agente.
