Explicar mención

Parámetros

• mentionId (ruta, UUID, obligatorio): Mención que se explicará.

Cuerpo de la solicitud

Este endpoint no requiere un cuerpo JSON.

Respuesta

Devuelve un objeto Mention público con relevanceReason, tags y aiReplySuggestion, o null si la mención no está disponible.

• id (string): UUID de la mención.
• websiteId (string | null): UUID del sitio web.
• source (string): REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS, FACEBOOK o FACEBOOK_GROUP.
• keyword (string | null): Valor de palabra clave que coincidió.
• title, contentText, url, author, subreddit (string | null): Contexto de título, cuerpo y enlace. subreddit contiene el subreddit en fuentes de Reddit y el id del grupo en FACEBOOK_GROUP, y es null en las demás fuentes.
• status (string): NEW, APPROVED o REJECTED.
• relevanceScore (number | null): Puntuación de relevancia de IA de 0 a 100, o null.
• relevanceReason (string | null): Explicación de IA de la coincidencia, o null.
• aiReplySuggestion (string | null): Respuesta redactada por IA para que una persona la revise antes de publicarla, o null.
• tags (string[]): Etiquetas de relevancia generadas por IA.
• publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt (ISO string | null): Marcas de publicación, ingesta, revisión, creación y actualización en formato ISO 8601, o null.

Notas

Si la explicación todavía no existe, RedReplier la genera de forma diferida. El sitio web necesita una descripción; sin ella, la mención vuelve sin cambios.

Errores

• 400 Bad Request: Entrada, URL, UUID, enum, parámetro de consulta o cuerpo no válido.
• 401 Unauthorized: Bearer token ausente o no válido, o code: "token_issuer_lost_access" cuando la persona que creó la clave API fue desactivada o salió del workspace.
• 403 Forbidden: code: "subscription_required" cuando el plan del workspace no incluye acceso a la API, code: "workspace_access_denied" cuando X-Workspace-Id indica un workspace al que esta credencial no puede acceder, o code: "permission_denied" cuando tu rol en el workspace no tiene el permiso redreplier.write (lo tienen Admin y Editor).
• 404 Not Found: El recurso no existe para la cuenta del token.
• 429 Too Many Requests: Límite de solicitudes superado. Espera los segundos indicados en Retry-After.
• 500 Internal Server Error: Error inesperado del servidor.