Manual de usuario · Módulo Convoca Assistant¶
Este manual es para la persona de la junta directiva que responde dudas de la web y quiere saber cómo va el asistente, qué le preguntan y qué no sabe contestar.
1. Dónde está el panel¶
- Entra en el escritorio de WordPress.
- En el menú lateral izquierdo, pulsa Convoca Assistant.
- Pulsa Dashboard.
La pantalla se titula «Convoca Assistant — Dashboard».
Desde este mismo menú también se llega a Conocimiento, Sinónimos, Analytics, Sin respuesta, Ajustes y Herramientas, además de los listados Todas las FAQs y Todos los artículos.
2. Los cuatro números de arriba¶
| Indicador | Qué significa | Cómo leerlo |
|---|---|---|
| Consultas (30d) | Cuántas preguntas ha recibido el asistente en 30 días. En la captura, 16. | Si sube, la web tiene tráfico y el asistente se usa. |
| Tasa de resolución | Porcentaje de preguntas que ha sabido responder bien. En la captura, 68,8 %. | Por debajo del 60 % conviene añadir contenido. |
| Sin respuesta (30d) | Preguntas que no ha sabido contestar. En la captura, 5. | De aquí salen las tareas: cada una es un texto que falta. |
| Tiempo medio | Lo que tarda en responder. En la captura, 19,88 ms. | Un número muy alto o que crece sin parar apunta al problema conocido assistant#11. |
3. Panel «Consultas por día»¶
Es el gráfico de actividad diaria. En una web pequeña, es normal que haya días sin ninguna consulta y otros con varias. Sirve para saber cuándo entra la gente: si todo se concentra en septiembre, ahí es donde interesa tener el contenido al día.
4. Panel «Top consultas»¶
Es la lista de lo que más pregunta la gente, con el número de veces y una puntuación (score).
Ejemplo real de la demo:
- ¿Cuánto cuesta hacerse socio? (2x, score: 0.42)
- cuota (2x, score: 0.42)
- ¿cómo me hago socio? (2x, score: 0.25)
- voluntariado (1x, score: 0.90)
- hola (1x, score: 0.00)
- gracias (1x, score: 0.00)
- xyzyy (1x, score: 0.00)
- ¿Cómo funciona? (1x, score: 0.90)
- ¿Cuánto cuesta la cuota? (1x, score: 0.00)
- taller de huerto (1x, score: 0.90)
Cómo se lee esto sin ser técnico:
- score alto (cerca de 0.90) quiere decir que el asistente encontró contenido muy parecido. Bien.
- score 0.00 en «hola», «gracias» o «xyzyy» es normal: son saludos o texto sin sentido, no preguntas.
- score bajo en una pregunta de verdad (como «¿Cuánto cuesta la cuota?») quiere decir que falta un texto claro sobre eso. Es la señal para escribir una página o una pregunta frecuente.
5. Caso de uso: mejorar el asistente con lo que le preguntan¶
- Entra en Convoca Assistant → Sin respuesta.
- Anota las preguntas repetidas que no sabe contestar.
- Escribe una página o una pregunta frecuente para cada una (texto corto, directo, con el dato principal en la primera frase).
- Añade en Sinónimos las palabras que use la gente («cuota», «mensualidad», «pago»).
- Vuelve al Dashboard y pulsa Regenerar índice ahora.
- Comprueba en unos días que Tasa de resolución sube y Sin respuesta baja.
6. Panel «Estado del índice»¶
Es el control técnico del asistente, en la parte de abajo del Dashboard. En la captura aparece así:
- Estado: ● Generado (bien).
- Entradas: 47.
- Tamaño: 28 KB.
- Última generación: Hace 21 minutos.
- Hash:
0f41c2afec527643389884084152f20f. - Botón Regenerar índice ahora.
Qué hay que mirar:
- Si Estado no dice «Generado», pulsa Regenerar índice ahora.
- Entradas no debería ser 0: significaría que no hay contenido que responder.
- Última generación debería cambiar cuando publicas algo nuevo y regeneras.
- Tamaño y Hash son datos de control para quien mantiene el sitio.
7. Problemas conocidos¶
- assistant#11 — El índice se reindexaba con cada visita al sitio: en una prueba se contaron 14 reindexados en 30 minutos. Se nota en que Última generación cambia sin que nadie pulse el botón y en que el sitio va más lento. https://github.com/josecarlosnieto91/convoca-assistant/issues/11
Preguntas frecuentes¶
¿Qué es «Sin respuesta»? La lista de preguntas que el asistente no ha sabido contestar. Es la mejor lista de tareas que puede tener la asociación para la web.
¿Los socios ven estas pantallas? No. Solo quien tenga permiso en el escritorio.
¿Puedo borrar una consulta del listado? No se ve un botón para borrar consultas en la captura. Por confirmar: cómo se limpia el historial.
¿Con qué responde el asistente? Con el contenido indexado de la web: entradas, páginas, preguntas frecuentes y base de conocimiento. Qué se indexa se elige en Conocimiento.
¿Cada cuánto hay que regenerar el índice? Cuando publiques contenido importante. Y siempre después de tocar Conocimiento 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.