Skip to main content

Registrar evento analítico

POST 
/api/widget/projects/:projectId/analytics

Registra eventos analíticos para un proyecto para permitir el seguimiento de interacciones de usuario, flujo de conversación y rendimiento del sistema. Estos eventos se utilizan para poblar los paneles de análisis en el AI Findr Hub, ayudándote a comprender el comportamiento del usuario y optimizar la experiencia de tu asistente IA.

Campos requeridos:

  • action (string): El tipo de evento que se está registrando. Consulta las acciones disponibles a continuación.
  • conversationId (string): El ID de la conversación donde ocurrió este evento
  • datetime (string): Marca de tiempo del evento en formato RFC3339 (ISO 8601)

Acciones disponibles:

  • query:initial: Primera consulta del usuario en una conversación
  • query:suggestion: El usuario seleccionó una consulta sugerida de la lista de sugerencias
  • query:followup: El usuario envió un mensaje de seguimiento en una conversación en curso
  • response:generated: El asistente IA generó una respuesta con fuentes y razonamiento
  • feedback:select: El usuario seleccionó una opción de feedback (positivo/negativo/neutral) antes de enviar
  • feedback:submit: El usuario envió feedback detallado con texto opcional y opciones seleccionadas
  • click:responselink: El usuario hizo clic en un enlace dentro de la respuesta del asistente IA
  • click:sourcelink: El usuario hizo clic en un enlace de fuente en la respuesta
  • click:cta:[componentId]: El usuario hizo clic en un componente CTA (reemplazar [componentId] con el ID real)
  • form:submit: El usuario envió datos a través de un formulario presentado por el asistente IA
  • widget:open: El usuario abrió el widget del asistente IA

Estructura del payload: Cada tipo de acción tiene su propia estructura de payload específica con los campos relevantes. El payload contiene datos específicos del evento, como consultas, respuestas, detalles de feedback, objetivos de clic o envíos de formularios. Todos los campos adicionales más allá de los requeridos se almacenan en el payload analítico para el consumo del panel de análisis.

Uso de analítica: Los eventos registrados aparecen en el panel de analítica de AI Findr Hub, permitiendo obtener información sobre patrones de conversación, participación de los usuarios, brechas de conocimiento y rendimiento del sistema. Utiliza estos datos para optimizar el contenido, mejorar la experiencia del usuario y medir la efectividad del asistente IA.

Request​

Responses​

Evento registrado exitosamente