Manual de configuración · Módulo Convoca Publisher¶
Este manual es para la persona de la junta directiva que conecta las cuentas de redes sociales de la asociación con la web. Es la parte más farragosa del módulo, así que ve red por red y sin prisa.
1. Dónde está esta pantalla¶
- Entra en el escritorio de WordPress.
- En el menú lateral izquierdo, pulsa Convoca Publisher.
- Se abre en la pestaña Canales.
La pantalla se titula «Convoca Publisher» y tiene siete pestañas: Canales, Cola, Configuración, Plantillas, Probar, Moderación y Guía.
Debajo del título, la pantalla avisa de algo importante:
Una cuenta es una cuenta; puedes tener varias de la misma red (la página y el grupo de Facebook), cada una con su credencial y su plantilla.
2. Cómo se lee cada tarjeta¶
Cada red ocupa una sección con:
- el estado a la derecha (✅ Configurado, ❌ Falta token, ⚠️ Error al verificar, 🔑 Necesita reconexión),
- la frase «Esta red no publica todavía: no tiene ninguna cuenta configurada» cuando no hay nada puesto,
- la pista de dónde se consigue la credencial, con su enlace,
- y el botón Añadir cuenta.
3. Tabla de redes: qué se necesita y dónde se consigue¶
| Red | Qué se necesita | Dónde se consigue (según la propia pantalla) |
|---|---|---|
| Facebook (con Instagram) | Credencial de la página de Facebook de la asociación | Meta for Developers — https://developers.facebook.com/apps/ |
| Google My Business | Credencial de la ficha del negocio | Google Cloud Console — https://console.cloud.google.com/apis/credentials |
| Credencial de la página de la asociación | LinkedIn Developer Portal — https://www.linkedin.com/developers/apps |
|
| Mastodon | Credencial de tu instancia | En los ajustes de tu instancia: Preferencias → Desarrollo |
| Telegram | Credencial del bot/canal | Por confirmar: el texto de ayuda de esta red no aparece en la captura. |
| TikTok | Credencial de la cuenta | Por confirmar: el texto de ayuda de esta red no aparece en la captura. |
| X | Credencial de la cuenta | Por confirmar: el texto de ayuda de esta red no aparece en la captura. |
En la captura solo se ven las cuatro primeras tarjetas; la lista de redes continúa hacia abajo.
Valor recomendado en todos los casos: una cuenta por red, con su credencial, y la de la página oficial (no la personal de nadie).
4. Cómo conectar una red, paso a paso¶
- Entra en Convoca Publisher → Canales.
- Localiza la tarjeta de la red que quieras conectar.
- Pulsa el enlace de ayuda de esa tarjeta y consigue la credencial en el sitio que indica (por ejemplo, Meta for Developers).
- Vuelve a la web y pulsa Añadir cuenta.
- Pega la credencial y guarda.
- Comprueba que el estado de esa tarjeta cambia a ✅ Configurado.
Si al guardar aparece ⚠️ Error al verificar, la red ha recibido la credencial y no la acepta: vuelve a copiarla entera y sin espacios.
5. Qué significa cada estado¶
| Estado | Qué quiere decir | Qué hacer |
|---|---|---|
| ✅ Configurado | La credencial está puesta y la red responde. | Nada. Vigila la caducidad. |
| ❌ Falta token | No hay credencial para esa red. | Conseguirla y pulsar Añadir cuenta. |
| ⚠️ Error al verificar | Hay credencial, pero la red no la acepta. | Repetir el copiado o pedir una nueva. |
| 🔑 Necesita reconexión | La red ha dejado de aceptar la credencial. | Volver a conectar esa cuenta. |
6. Caducidad y salud de la credencial¶
La tarjeta de cada red muestra la salud y la caducidad de su credencial. Es la información más útil de esta pantalla: una credencial caducada deja de publicar sin avisar por correo.
Recomendación: una vez al mes, entra en Convoca Publisher → Canales y repasa la caducidad de las redes que uses.
7. Las otras pestañas¶
- Configuración: ajustes generales del módulo. Por confirmar: qué ajustes concretos incluye (no hay captura de esta pestaña).
- Plantillas: textos modelo para las publicaciones, uno por cuenta.
- Probar: sirve para comprobar que una red funciona antes de usarla de verdad.
- Moderación: para revisar o aprobar publicaciones.
- Guía: ayuda dentro del propio módulo.
- Cola: publicaciones pendientes de salir. Por confirmar: si permite programar día y hora.
8. Problemas conocidos¶
- publisher#8 — El aviso «Falta token» debería llevar directamente a cómo conseguir la credencial; hoy hay que buscarlo uno mismo. https://github.com/josecarlosnieto91/convoca-publisher/issues/8
Preguntas frecuentes¶
¿Puedo conectar dos cuentas de la misma red? Sí, la propia pantalla lo dice: cada una con su credencial y su plantilla. Útil para la página y el grupo de Facebook.
¿Dónde apunto las credenciales? Guárdalas en un gestor de contraseñas de la asociación. Son como una contraseña: quien las tenga puede publicar en nombre de la asociación.
Si una red da error, ¿me entero? Mirando el estado en Canales. Conviene que sea una tarea mensual fija de alguien de la junta.
¿Puedo dejar redes sin conectar? Sí. Se quedan en Falta token y no pasa nada.
¿Las publicaciones se ven antes en la web o en la red? Las redes las reciben al publicarse desde la web. Por confirmar: el detalle del orden y los tiempos (no hay captura del flujo de publicación).
¿Administras el sistema y buscas los detalles técnicos (ganchos, capacidades, API)? Están en la referencia técnica: docs/plugins/convoca-publisher.md.