Analytics
PostHog dans votre produit et vos agents IA, via une API
Le toolkit PostHog couvre les organisations et projets, les définitions d'événements, les requêtes ad hoc, les insights, les dashboards, les personnes, les cohortes et les annotations. Votre client connecte PostHog une fois avec une clé API personnelle, et votre produit ou agent IA appelle chaque opération via Connect, qui stocke les identifiants et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
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": {}
}
}Fonctionnement
Du client connecté au premier appel à PostHog.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte PostHog. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec PostHog.
Analytics dans votre produit
Exécutez une requête et lisez les insights et les tuiles de dashboards avec leurs résultats en cache pour afficher des analytics produit dans vos propres écrans.
Un agent répond aux questions de données
Un agent IA liste les définitions d'événements et exécute une requête pour répondre à ce qu'ont fait les utilisateurs, chaque appel restant dans le journal d'audit.
Marquer les lancements sur les graphiques
Créez une annotation quand une campagne ou une release sort, pour que ce moment apparaisse sur tous les graphiques du projet.
Tools
12 tools PostHog
- Lister les organisationsGETListe les organisations accessibles avec la clé, chacune avec ses projets dans teams. Le project_id de chaque team est ce que demandent les autres outils. Paginez avec limit et offset.
- Lister les définitions d'événementsGETListe les événements suivis dans le projet avec nom, description, tags et last_seen_at, à utiliser dans les requêtes et annotations. Paginez avec limit et offset.
- Exécuter une requêtePOSTExécute une requête d'analytics ad hoc et renvoie ses résultats, jusqu'à 100 lignes sauf si le SQL définit un LIMIT. Ce n'est pas un export : PostHog refuse OFFSET, limite chaque projet à 3 requêtes simultanées et débite chaque requête d'un budget de lecture horaire.
- Lister les insightsGETListe les insights du projet avec id, short_id, nom, description et query. Sauf si basic est true, chacun porte aussi son résultat en cache. Paginez avec limit et offset.
- Obtenir un insightGETRenvoie un insight avec sa requête et son résultat. Par défaut, le résultat vient du cache, et refresh à blocking le recalcule quand il est périmé.
- Lister les dashboardsGETListe les dashboards du projet avec id, nom, description, pinned et tags. Paginez avec limit et offset.
- Obtenir un dashboardGETRenvoie un dashboard avec ses filtres et ses tuiles, chaque tuile avec son insight et le résultat en cache.
- Lister les personnesGETListe les personnes du projet avec leurs distinct_ids et propriétés. search les trouve par email, nom, id de la personne ou distinct id. Paginez avec limit et offset.
- Lister les cohortesGETListe les cohortes du projet avec id, nom, description, nombre de personnes et si elles sont statiques. Paginez avec limit et offset.
- Lister les annotationsGETListe les annotations du projet, les notes épinglées à un moment des graphiques, avec id, content, date_marker et scope. Paginez avec limit et offset.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
À la connexion, votre client indique aussi {region} : l'adresse de son compte sur l'API de l'app.
Questions sur le toolkit PostHog
Dois-je intégrer l'API PostHog moi-même ?
Non. Connect fournit 12 tools PostHog décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte PostHog ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
