Convoca Publisher v1.4.0¶
Publica automáticamente tus entradas de WordPress en 8 redes sociales. Sin suscripciones, sin dependencias externas, sin límites artificiales. Los tokens se almacenan cifrados con AES-256-GCM.
Redes soportadas: Facebook, Instagram, LinkedIn, Twitter/X, TikTok, Google My Business, Telegram, Mastodon.
Pestañas del panel¶
El panel (Convoca Publisher) tiene 5 pestañas:
| Pestaña | Para qué sirve |
|---|---|
| Configuración | Tokens de cada red, publicación automática, aviso de privacidad |
| Canales | Estado de cada red + botón Verificar conexión |
| Probar | Selecciona una entrada y publica en todas las redes |
| Plantillas | Personaliza el mensaje de cada red con variables |
| Guía | Instrucciones para obtener credenciales de cada red |
Configurar canales¶
Obtener credenciales¶
Usa la pestaña Guía para instrucciones detalladas. Resumen:
| Canal | ¿Qué necesitas? | Dónde obtenerlo |
|---|---|---|
| Facebook / Instagram | Token de página (Graph API) + Page ID | developers.facebook.com |
| Access Token (OAuth 2.0) | linkedin.com/developers | |
| Twitter / X | Bearer Token (API v2) | developer.twitter.com |
| TikTok | Access Token + Open ID | developers.tiktok.com |
| Google My Business | Token OAuth + Location ID | console.cloud.google.com |
| Telegram | Bot Token + Chat ID | @BotFather en Telegram |
| Mastodon | Access Token + Instance URL | Tu instancia de Mastodon |
Verificar conexión¶
En la pestaña Canales, cada red tiene un botón Verificar conexión que:
- Hace una llamada real a la API
- Muestra ✅ si todo funciona (nombre del bot/perfil)
- Muestra ❌ con el mensaje de error si falla
Tokens cifrados
Los tokens se almacenan cifrados con AES-256-GCM. La clave se deriva de AUTH_KEY + SECURE_AUTH_KEY de WordPress. Si cambias estas constantes, tendrás que reconfigurar los canales.
Plantillas por canal¶
Cada canal puede tener un mensaje diferente. Configúralas en Convoca Publisher → Plantillas.
Variables disponibles¶
| Variable | Se sustituye por |
|---|---|
{title} |
Título de la entrada |
{excerpt} |
Extracto |
{url} |
Enlace permanente |
{hashtags} |
Las 5 primeras etiquetas como hashtags |
{date} |
Fecha de publicación |
{author} |
Nombre del autor |
{featured_image} |
URL de la imagen destacada |
Plantillas por defecto¶
| Canal | Plantilla por defecto |
|---|---|
| Facebook / LinkedIn / Telegram / Mastodon | {title} — {url} {hashtags} |
| Twitter/X | {title} {url} {hashtags} |
| TikTok | {title} |
| Google My Business | {excerpt} — {url} |
Ejemplo¶
Publicar una entrada¶
Publicación automática¶
Al publicar una entrada, Convoca Publisher:
- Detecta la publicación
- Valida que el título no esté vacío y que haya imagen destacada
- Prepara el mensaje con la plantilla de cada canal activo
- Publica en cada red seleccionada
- Muestra el resultado en el metabox del editor
Metabox del editor¶
En el editor de entradas, el metabox Convoca Publisher muestra:
- Canales: checkboxes para seleccionar redes
- Estado: publicado, pendiente, error
- Warnings: avisos si falta título o imagen destacada
- Programar: fecha/hora para publicación diferida
- Republicar: botón para reintentar envío fallido
Publicación programada¶
Puedes publicar el post ahora pero enviarlo a redes más tarde:
- Marca los canales deseados en el metabox
- Rellena Programar publicación con la fecha deseada
- Publica el post
Si no indicas fecha, se envía inmediatamente.
Validaciones¶
| Condición | Qué ocurre |
|---|---|
| Título vacío | ⚠️ Warning en metabox + registro en historial |
| Sin imagen destacada | ⚠️ Warning (no bloquea, pero algunas redes necesitan imagen) |
Cola de reintentos¶
Si una publicación falla:
- Guarda el intento en la cola
- Reintenta una vez (máximo 2 intentos por post)
- Si vuelve a fallar, se marca como error permanente
Historial¶
Convoca Publisher → Historial muestra las últimas 200 publicaciones: fecha, canal, estado, enlace al post, mensaje de error. También incluye estadísticas de la cola de reintentos.
REST API¶
Endpoints (requieren manage_options):
GET /wp-json/convoca-publisher/v1/status
POST /wp-json/convoca-publisher/v1/publish/{post_id}
POST /wp-json/convoca-publisher/v1/publish/{post_id}?dry_run=true
POST /wp-json/convoca-publisher/v1/test/{channel}
Solución de problemas¶
| Problema | Solución |
|---|---|
| Token caducado | Reconfigura el canal. Los tokens de Facebook/Twitter caducan periódicamente |
| Error 401/403 | El token no tiene permisos suficientes. Revisa los scopes |
| Instagram no publica | Instagram requiere una página de Facebook vinculada. Publica a través del canal de Facebook |
| TikTok no funciona | Requiere Content Posting API. Usa Verificar conexión para diagnosticar |
| Rate limit | El sistema reintenta automáticamente una vez |
| No aparece el metabox | Asegúrate de que el post type es "post" (no funciona en páginas ni CPTs) |