Analytics
Mention dans votre produit et vos agents IA, via une API
Le toolkit Mention couvre le compte et ses listes de référence, les alertes, les mentions qu'elles collectent et les tags. Avec Connect, votre produit ou agent IA appelle le tout par un seul endpoint, pendant que Connect stocke le jeton d'API et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/mention_create_alert/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"account_id": "<account_id>",
"name": "<name>",
"query": {},
"languages": []
}
}Fonctionnement
Du client connecté au premier appel à Mention.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Mention. 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 Mention.
Configurer la veille de marque
Un outil de réputation crée une alerte avec requête, langues et sources pour un nouveau client, puis affine la requête plus tard.
Alimenter un tableau de bord
Un SaaS liste les mentions collectées par une alerte, avec source, langue et tonalité, et remonte vers les plus anciennes.
Agent qui trie les mentions
Un agent IA marque des mentions comme lues ou favorites, définit la tonalité, les range dans un dossier et les tague.
Tools
10 tools Mention
- Obtenir le compteGETRenvoie le compte Mention de la connexion avec id, nom, e-mail et langue. L'id est l'account_id que demandent les autres outils.
- Obtenir les données de l'appGETRenvoie les listes de référence de Mention : alert_languages, alert_countries et alert_sources, dont les clés sont les codes que prennent les alertes et les filtres de mentions, ainsi que alert_tones et mention_folders.
- Lister les alertesGETListe les alertes du compte avec id, nom, requête, langues, sources et nombre de mentions par dossier. Quand il y a plus d'alertes, la réponse contient _links.more avec le curseur de la page suivante.
- Créer une alertePOSTCrée une alerte, qui commence à collecter les mentions correspondant à sa requête, et la renvoie avec son id. Les mentions collectées comptent dans le quota du forfait Mention.
- Mettre à jour une alertePUTMet à jour une alerte, généralement pour affiner sa requête, et la renvoie. Seuls les champs envoyés changent. Une requête envoyée remplace l'actuelle et exige son type.
- Lister les mentionsGETListe les mentions collectées par une alerte, avec titre, texte, URL, source, langue, tonalité et dossier. La réponse contient _links.more, dont le href porte le curseur des mentions plus anciennes. Certains filtres ne peuvent pas être combinés, comme chacun l'indique.
- Obtenir une mentionGETRenvoie une mention avec titre, texte, URLs, source, langue, tonalité, dossier, les indicateurs lue et favorite, ses tâches et la première page de ses mentions enfants.
- Mettre à jour une mentionPUTClasse une mention : la marque comme lue ou favorite, la déplace dans un dossier, définit sa tonalité ou la tague, et la renvoie. Seuls les champs envoyés changent. Le contenu d'une mention ne change jamais.
- Lister les tagsGETListe les tags d'une alerte avec id, nom, nombre de mentions et mots-clés d'étiquetage automatique. L'id est ce que prennent les tags de Mettre à jour une mention.
- Créer un tagPOSTCrée un tag dans une alerte et le renvoie avec son id. Une alerte peut contenir jusqu'à 100 tags, et les nouvelles mentions contenant l'un des mots-clés sont taguées automatiquement.
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 Mention
Dois-je intégrer l'API Mention moi-même ?
Non. Connect fournit 10 tools Mention 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 Mention ?
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.
