Analítica
PostHog en tu producto y en tus agentes de IA, con una API
El toolkit de PostHog cubre organizaciones y proyectos, definiciones de eventos, queries ad hoc, insights, dashboards, personas, cohortes y anotaciones. Tu cliente conecta PostHog una vez con una API key personal, y tu producto o agente de IA llama a cada operación a través de Connect, que guarda las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta 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": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a PostHog.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de PostHog. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con PostHog.
Analítica dentro de tu producto
Ejecuta una query y lee insights y tiles de dashboards con sus resultados en caché para mostrar analítica de producto en tus propias pantallas.
Agente responde preguntas de datos
Un agente de IA lista las definiciones de eventos y ejecuta una query para responder qué hicieron los usuarios, con cada llamada guardada en el log de auditoría.
Marca lanzamientos en los gráficos
Crea una anotación cuando salga una campaña o release, para que el momento aparezca en todos los gráficos del proyecto.
Tools
12 tools de PostHog
- Listar organizacionesGETLista las organizaciones a las que llega la key, cada una con sus proyectos en teams. El project_id de cada team es lo que piden las demás herramientas. Pagina con limit y offset.
- Listar definiciones de eventosGETLista los eventos rastreados en el proyecto con nombre, descripción, tags y last_seen_at, para usar en queries y anotaciones. Pagina con limit y offset.
- Ejecutar queryPOSTEjecuta una query de analítica ad hoc y devuelve sus resultados, hasta 100 filas salvo que el SQL defina un LIMIT. No es una exportación: PostHog rechaza OFFSET, limita cada proyecto a 3 queries a la vez y descuenta cada query de un presupuesto de lectura por hora.
- Listar insightsGETLista los insights del proyecto con id, short_id, nombre, descripción y query. Salvo que basic sea true, cada uno también trae su resultado en caché. Pagina con limit y offset.
- Obtener insightGETDevuelve un insight con su query y resultado. Por defecto el resultado viene de la caché, y refresh en blocking lo calcula de nuevo cuando está desactualizado.
- Listar dashboardsGETLista los dashboards del proyecto con id, nombre, descripción, pinned y tags. Pagina con limit y offset.
- Obtener dashboardGETDevuelve un dashboard con sus filtros y tiles, cada tile con su insight y el resultado en caché.
- Listar personasGETLista las personas del proyecto con sus distinct_ids y propiedades. search las encuentra por email, nombre, id de la persona o distinct id. Pagina con limit y offset.
- Listar cohortesGETLista las cohortes del proyecto con id, nombre, descripción, cantidad de personas y si son estáticas. Pagina con limit y offset.
- Listar anotacionesGETLista las anotaciones del proyecto, las notas fijadas en un momento de los gráficos, con id, content, date_marker y scope. Pagina con limit y offset.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Al conectar, tu cliente también indica {region}: la dirección de su cuenta en la API de la app.
Preguntas sobre el toolkit de PostHog
¿Necesito implementar la API de PostHog?
No. Connect ya trae 12 tools de PostHog descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de PostHog?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
