Manual de configuración · Módulo Convoca Assistant¶
Este manual es para la persona de la junta directiva que decide con qué contenido responde el asistente de la web y con qué prioridad.
1. Dónde está esta pantalla¶
- Entra en el escritorio de WordPress.
- En el menú lateral izquierdo, pulsa Convoca Assistant.
- Pulsa Conocimiento.
El título de la pantalla es «Conocimiento» y debajo resume su propósito:
Gestiona las fuentes de conocimiento del asistente. Puedes activar o desactivar tipos de contenido y ajustar su peso en las búsquedas.
2. Bloque «Contenido indexable»¶
Se explica así: «Accede directamente a los listados para gestionar el contenido». Son cuatro botones que llevan al listado de cada tipo de contenido para editarlo:
- Gestionar FAQs
- Gestionar Base de Conocimiento
- Entradas
- Páginas
Son atajos, no ajustes: no cambian nada por sí solos.
3. Bloque «Fuentes activas»¶
Indicación de la pantalla: «Marca las fuentes de conocimiento que quieres incluir en el asistente».
| Fuente | Qué incluye | Valor recomendado |
|---|---|---|
| Entradas — «Entradas estándar de WordPress» | Las noticias y publicaciones del blog. | Marcada. |
| Páginas — «Páginas estáticas de WordPress» | Las páginas fijas: quiénes somos, contacto, inscripciones. | Marcada. |
| FAQ — «Preguntas frecuentes» | Las preguntas frecuentes de la web. | Marcada. Es la fuente que da respuestas más cortas y fiables. |
| Base de Conocimiento — «Artículos de la base de conocimiento» | Los artículos largos de ayuda. | Marcada. |
| Productos WooCommerce (no disponible) — «Productos con precio y SKU» | Precios de tienda. | No se puede marcar: aparece en gris. |
4. Bloque «Peso por tipo de contenido»¶
Indicación de la pantalla: «A mayor peso, más relevante será ese tipo de contenido en las búsquedas».
En la captura se ve la fila Entradas con el valor 1 y la nota «(defecto: 1)».
Valores recomendados:
- Deja todo en 1 mientras no haya quejas de respuestas raras.
- Si el asistente contesta con una noticia antigua cuando debería contestar con la página de inscripciones, baja el peso de Entradas o sube el de Páginas.
- Si el asistente da respuestas demasiado largas, sube el peso de FAQ.
Por confirmar: qué otras filas aparecen en este bloque (la captura solo muestra «Entradas») y cuál es el valor máximo permitido.
5. Otras pestañas del menú¶
- Sinónimos: palabras que significan lo mismo para el asistente («cuota», «mensualidad», «pago de socio»). Ayuda a que entienda la pregunta aunque no use la palabra exacta.
- Ajustes: ajustes generales del asistente. Por confirmar: qué campos incluye exactamente.
- Analytics: informes ampliados de lo que pregunta la gente.
- Sin respuesta: las preguntas que el asistente no ha sabido contestar. Es la lista más útil para mejorar la web.
- Herramientas: utilidades del módulo. Por confirmar: qué incluye.
6. Orden recomendado para dejar el asistente fino¶
- Revisa que Fuentes activas tenga marcadas Entradas, Páginas, FAQ y Base de Conocimiento.
- Abre Sin respuesta y anota las cinco preguntas más repetidas que no sabe contestar.
- Crea o mejora el contenido que responde a esas preguntas (una FAQ por pregunta, texto corto y claro).
- Añade Sinónimos de las palabras raras que use la gente.
- Vuelve a Dashboard y pulsa Regenerar índice ahora.
- Espera unos días y mira la Tasa de resolución: debería subir.
7. Problemas conocidos¶
- assistant#11 — El índice se regenera con cada visita al sitio (14 reindexados en 30 minutos en una prueba). Alarga los tiempos de respuesta y ensucia el «Tiempo medio» del Dashboard. https://github.com/josecarlosnieto91/convoca-assistant/issues/11
Preguntas frecuentes¶
¿Tengo que indexar a mano cada vez que publico una noticia? El asistente trabaja con el índice. En el Dashboard hay un botón Regenerar índice ahora, así que conviene entrar después de publicar algo importante.
¿Qué es el «peso»? Una forma de decir «a esta fuente hazle más caso». No borra contenido: cambia el orden en que se eligen las respuestas.
¿Si desmarco una fuente, borro ese contenido? No. Solo deja de usarse para responder. El contenido sigue publicado en la web.
¿De dónde salen las preguntas que veo en «Sin respuesta»? De lo que la gente escribe en el asistente de la web pública. Nadie tiene que apuntarlo a mano.
¿Es normal que haya 5 sin respuesta y 16 consultas en un mes? En un sitio pequeño, sí. Lo importante es la tendencia: si crece, falta contenido o sinónimos.
¿Administras el sistema y buscas los detalles técnicos (ganchos, capacidades, API)? Están en la referencia técnica: docs/plugins/convoca-assistant.md.