Analítica
Mention en tu producto y en tus agentes de IA, con una API
El toolkit de Mention cubre la cuenta y sus listas de referencia, alertas, las menciones que recogen y etiquetas. Con Connect, tu producto o agente de IA lo llama todo por un solo endpoint, mientras Connect guarda el token de API y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
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": []
}
}Cómo funciona
Del cliente conectado a la primera llamada a Mention.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Mention. 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 Mention.
Configura el monitoreo de marca
Una herramienta de reputación crea una alerta con consulta, idiomas y fuentes para un cliente nuevo y refina la consulta después.
Lleva menciones a un panel
Un SaaS lista las menciones que recogió una alerta, con fuente, idioma y tono, y pagina hasta las más antiguas.
Agente que organiza menciones
Un agente de IA marca menciones como leídas o favoritas, define el tono, las mueve a una carpeta y las etiqueta.
Tools
10 tools de Mention
- Obtener cuentaGETDevuelve la cuenta de Mention de la conexión con id, nombre, email e idioma. El id es el account_id que piden las otras herramientas.
- Obtener datos de la appGETDevuelve las listas de referencia de Mention: alert_languages, alert_countries y alert_sources, cuyas claves son los códigos que aceptan alertas y filtros de menciones, además de alert_tones y mention_folders.
- Listar alertasGETLista las alertas de la cuenta con id, nombre, consulta, idiomas, fuentes y conteo de menciones por carpeta. Cuando hay más alertas, la respuesta trae _links.more con el cursor de la página siguiente.
- Crear alertaPOSTCrea una alerta, que empieza a recoger las menciones que coinciden con su consulta, y la devuelve con su id. Las menciones recogidas cuentan en la cuota del plan de Mention.
- Actualizar alertaPUTActualiza una alerta, normalmente para refinar su consulta, y la devuelve. Solo cambian los campos enviados. Una consulta enviada reemplaza la actual y requiere su type.
- Listar mencionesGETLista las menciones que recogió una alerta, con título, texto, URL, fuente, idioma, tono y carpeta. La respuesta trae _links.more, cuyo href lleva el cursor de las menciones más antiguas. Algunos filtros no se pueden combinar, como indica cada uno.
- Obtener menciónGETDevuelve una mención con título, texto, URLs, fuente, idioma, tono, carpeta, las marcas de leída y favorita, sus tareas y la primera página de sus menciones hijas.
- Actualizar menciónPUTOrganiza una mención: la marca como leída o favorita, la mueve a una carpeta, define el tono o la etiqueta, y la devuelve. Solo cambian los campos enviados. El contenido de una mención nunca cambia.
- Listar etiquetasGETLista las etiquetas de una alerta con id, nombre, conteo de menciones y palabras clave de etiquetado automático. El id es lo que aceptan las tags de Actualizar mención.
- Crear etiquetaPOSTCrea una etiqueta en una alerta y la devuelve con su id. Una alerta admite hasta 100 etiquetas, y las menciones nuevas que contienen una de las palabras clave se etiquetan automáticamente.
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.
Preguntas sobre el toolkit de Mention
¿Necesito implementar la API de Mention?
No. Connect ya trae 10 tools de Mention 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 Mention?
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.
