Saltar a contenido

Manual de instalación · Módulo Convoca Assistant

Este manual es para la persona de la junta directiva que deja instalado el asistente que responde a las preguntas de la web. No hace falta saber programar.

1. Qué es

Convoca Assistant (nombre interno: convoca-assistant, versión 0.2.20) es el módulo que añade un asistente a la web pública de la asociación. Responde a las preguntas de la gente que entra en la web usando el contenido que tenga indexado: las entradas, las páginas, las preguntas frecuentes y los artículos de la base de conocimiento.

En palabras llanas: el asistente no se lo inventa, responde con lo que la asociación ha publicado.

2. Qué necesitas antes de empezar

  • Un usuario con permiso de administrador del escritorio de WordPress.
  • El fichero .zip del módulo.
  • El contenido de la web razonablemente al día. Un asistente sobre contenido viejo da respuestas viejas.
  • Un rato para revisar el Conocimiento después de instalar (qué fuentes se indexan y con qué peso).

3. Pasos de instalación

  1. Entra en el escritorio de WordPress (/wp-admin).
  2. En el menú lateral, pulsa Plugins.
  3. Pulsa Añadir nuevo plugin → Subir plugin → Elegir archivo.
  4. Selecciona el .zip de Convoca Assistant → Instalar ahora.
  5. Pulsa Activar plugin.
  6. Comprueba que en el menú lateral aparece Convoca Assistant con estos apartados: Todas las FAQs, Todos los artículos, Dashboard, Conocimiento, Sinónimos, Analytics, Sin respuesta, Ajustes y Herramientas.
  7. Entra en Convoca Assistant → Dashboard. Si abajo del todo el índice aparece como Generado, ya está listo. Si no, pulsa Regenerar índice ahora.
  8. Entra en Convoca Assistant → Conocimiento y repasa las Fuentes activas: deben estar marcadas Entradas, Páginas, FAQ y Base de Conocimiento.

Pantalla de Conocimiento del asistente

  1. Abre la web pública en otra ventana, sin sesión iniciada, y hazle una pregunta al asistente (por ejemplo, sobre la cuota de socio).

4. Comprobación

  • El menú lateral muestra Convoca Assistant con todos sus apartados.
  • En Dashboard se ven los cuatro indicadores arriba: Consultas (30d), Tasa de resolución, Sin respuesta (30d) y Tiempo medio.
  • En Dashboard → Estado del índice el estado es Generado y hay un número de Entradas mayor que cero.
  • En la web pública, el asistente responde y no se queda en blanco.

Ejemplo real de la demo, recién instalado: 16 consultas en 30 días, 68,8 % de tasa de resolución, 5 sin respuesta, 19,88 ms de tiempo medio y el índice con 47 entradas y 28 KB.

5. Errores típicos y qué hacer

  • No veo el menú «Convoca Assistant». El módulo no está activo, o tu usuario no es administrador.
  • El asistente no responde o responde cosas raras. Mira Estado del índice en el Dashboard. Si el índice no está Generado, pulsa Regenerar índice ahora.
  • El índice crece o se regenera sin parar. Es el problema conocido assistant#11: se reindexaba con cada visita. En una prueba se contaron 14 reindexados en 30 minutos.
  • Responde con datos viejos. Comprueba si el contenido de la web está actualizado y si el índice se generó después del último cambio.
  • Los productos de tienda no aparecen. En Fuentes activas, la fila Productos WooCommerce (no disponible) sale en gris: no se puede marcar.

6. Problemas conocidos

Preguntas frecuentes

¿El asistente se inventa las respuestas? No. Responde con lo que tenga indexado: entradas, páginas, preguntas frecuentes y base de conocimiento.

¿Hay que decirle las respuestas una a una? Para lo básico, no: aprende de lo que ya está publicado. Si quieres respuestas concretas y cortas, se pueden preparar preguntas frecuentes y verlas en Todas las FAQs.

¿Se puede poner en la web sin que nadie lo vea? Por confirmar: si el módulo tiene una opción de «solo visible para administradores» en Ajustes (no hay captura de esa pestaña).

¿Qué pasa si el asistente no sabe responder? La pregunta queda registrada y se puede consultar en Sin respuesta.

¿Consume muchos recursos? No debería. Si el sitio va lento, revisa el problema conocido assistant#11 antes de tocar nada más.

¿Administras el sistema y buscas los detalles técnicos (ganchos, capacidades, API)? Están en la referencia técnica: docs/plugins/convoca-assistant.md.