Mettre à jour une mention avec l'API Mention
Classe 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.
- Identifiant
- mention_update_mention
L'appel
POST https://connect.reportei.com/api/tools/mention_update_mention/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>",
"alert_id": "<alert_id>",
"mention_id": "<mention_id>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| account_id | string | Oui | Id of the account, from Get account. |
| alert_id | string | Oui | Id of the alert, from List alerts. |
| mention_id | string | Oui | Id of the mention, from List mentions. |
| read | boolean | Non | true marks the mention as read. |
| favorite | boolean | Non | true marks the mention as favorite, which also marks it as read. Needs the admin role on the alert. |
| trashed | boolean | Non | true puts the mention in the trash. Needs the admin role on the alert. |
| folder | string | Non | Folder to move the mention to.Valeurs : inbox, archive, spam, trash |
| tone | integer | Non | Tone of the mention: -1 negative, 0 neutral, 1 positive.Valeurs : -1, 0, 1 |
| tags | array | Non | Tags of the mention, each an existing tag of the alert by its id from List tags. Send every tag the mention should have. |
Connexions possibles
Votre client connecte son compte Mention une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
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 réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/mention_update_mention. Il devient la définition de tool de votre agent sans conversion.
Autres 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.
- 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.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
