API de PostHog: qué puedes hacer y cómo usarla con agentes de IA
PostHog es una plataforma de analítica de producto con eventos, embudos, grabaciones de sesión, feature flags y experimentos. Tiene una API pública para enviar eventos y una API privada para consultar datos y gestionar los recursos del proyecto. La usan equipos de producto e ingeniería, en la nube o en una instalación propia.
Qué ofrece la API de PostHog
Captura de eventos
Envío de eventos y propiedades de usuarios desde sistemas y aplicaciones.
Consultas
Preguntas a los datos con HogQL, el lenguaje de consulta de PostHog.
Insights y dashboards
Lectura y creación de informes guardados.
Feature flags
Creación y evaluación de flags para liberar funciones.
Personas y cohortes
Perfiles de usuarios y grupos según su comportamiento.
Grabaciones de sesión
Acceso a las grabaciones de navegación.
Cómo acceder a la API de PostHog
- Con las credenciales de tu empresaEl envío de eventos usa la clave pública del proyecto. Las consultas y la gestión usan una clave de API personal con los ámbitos que elijas.
- Las grabaciones de sesión pueden contener datos personales: usa el enmascaramiento y restringe el acceso.
- Las consultas pesadas cuentan para los límites de uso.
- Los cambios en las feature flags afectan a usuarios reales.
Documentación oficial: posthog.com/docs/api
Qué hace un agente de iTeam con la API de PostHog
Por qué no convirtió la visita
El agente consulta el embudo y las grabaciones de las sesiones que abandonaron, y resume los puntos de fricción para el equipo.
Pregunta en lenguaje natural
El responsable pregunta cuántos registros llegaron de una campaña y el agente arma la consulta y responde.
Flag con aprobación
El equipo pide liberar una función para un grupo y el agente prepara el cambio en la flag, que se aplica tras la aprobación.
Alerta de error de seguimiento
El agente detecta cuándo un evento importante dejó de llegar y avisa a ingeniería.
De la credencial al agente trabajando, con aprobación
Crea la clave de API personal
En PostHog, genera una clave personal con ámbitos de lectura y, si hace falta, de escritura en flags.
Regístrala en la bóveda de iTeam
La clave queda en la bóveda. Las consultas son libres y los cambios en flags y experimentos requieren aprobación.
Compara las cifras
Durante las primeras semanas, contrasta las respuestas del agente con los insights de PostHog.
Equipos de IA listos para este trabajo
Reportes e indicadores
Nina junta los datos, Darwin revisa los números y el informe de indicadores llega a Slack con lo que cambió y por qué.
Análisis de datos
Escribes la pregunta en Slack o en el chat; Nina consulta tu base de datos y responde con el número, la consulta usada y un gráfico.
Mesa de ayuda de TI
Jaca resuelve en Slack o Teams lo que ya está documentado, Nina vigila el SLA en Jira y TI se queda con los problemas de verdad.
Preguntas sobre la API de PostHog
¿La API de PostHog es gratuita?
PostHog tiene un nivel gratuito mensual y cobra por el uso que lo supera. La API acompaña al plan y a los límites del proyecto.
¿Necesito programar para usar la API de PostHog con iTeam?
No necesariamente. iTeam usa la documentación y el servidor MCP de PostHog, y el equipo de implantación configura los accesos.
¿Funciona con PostHog instalado en mi propio servidor?
En general sí, siempre que la API sea accesible desde la red de la integración.
