Analytics
Segment dans votre produit et vos agents IA, via une API
Le toolkit Segment lit les sources, destinations et entrepôts de données d'un workspace de la région US via la Public API, ainsi que les métriques de livraison, les synchronisations d'entrepôt et le volume d'événements reçus. Avec Connect, un produit ou un agent IA inspecte le pipeline de données du client sans construire l'intégration.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/segment_list_sources/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {}
}Fonctionnement
Du client connecté au premier appel à Segment.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Segment. 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 Segment.
Santé du pipeline dans votre produit
Affichez quelles destinations reçoivent les données de chaque source et lisez les métriques de livraison d'une période pour repérer les livraisons en échec.
Contrôle des synchronisations d'entrepôt
Listez les dernières synchronisations d'un entrepôt avec statut et durée pour vérifier que les données arrivent.
Volume d'événements pour un agent
Laissez un agent IA lire combien d'événements le workspace a reçus par intervalle, regroupés par source ou nom d'événement, et expliquer une baisse ou un pic.
Tools
11 tools Segment
- Lister les sourcesGETListe les sources du workspace avec id, name, slug, enabled, metadata et labels. Renvoie les 200 premières, car la connexion n'envoie pas de pagination ; pagination.totalEntries indique s'il y en a plus.
- Obtenir une sourceGETRenvoie une source avec ses réglages, write keys, metadata et labels.
- Lister les destinations connectéesGETListe les destinations qui reçoivent des données d'une source, avec id, name, enabled et metadata. Renvoie les 200 premières, car la connexion n'envoie pas de pagination.
- Lister les entrepôts connectésGETListe les entrepôts qui reçoivent des données d'une source. Renvoie les 200 premiers, car la connexion n'envoie pas de pagination.
- Lister les destinationsGETListe les destinations du workspace avec id, name, enabled, metadata et le sourceId auquel chacune appartient. Renvoie les 200 premières, car la connexion n'envoie pas de pagination ; pagination.totalEntries indique s'il y en a plus.
- Obtenir une destinationGETRenvoie une destination avec ses réglages, metadata et le sourceId auquel elle appartient.
- Obtenir les métriques de livraisonGETRenvoie les métriques de livraison d'une destination pour les événements d'une source sur une période, chaque métrique avec son total et sa ventilation. Sans dates, couvre la dernière heure minute par minute.
- Lister les entrepôtsGETListe les entrepôts du workspace avec id, enabled, metadata et settings. Renvoie les 200 premiers, car la connexion n'envoie pas de pagination ; pagination.totalEntries indique s'il y en a plus.
- Obtenir un entrepôtGETRenvoie un entrepôt avec ses réglages et metadata.
- Lister les synchronisations d'un entrepôtGETListe les dernières synchronisations d'un entrepôt, avec statut et durée, pour vérifier que les données arrivent. Renvoie les 200 premières, car la connexion n'envoie pas de pagination.
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.
Questions sur le toolkit Segment
Dois-je intégrer l'API Segment moi-même ?
Non. Connect fournit 11 tools Segment 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 Segment ?
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.
