Saltar a contenido

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
LinkedIn 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

📢 {title}

{excerpt}

🔗 {url}
{hashtags}

Publicar una entrada

Publicación automática

Al publicar una entrada, Convoca Publisher:

  1. Detecta la publicación
  2. Valida que el título no esté vacío y que haya imagen destacada
  3. Prepara el mensaje con la plantilla de cada canal activo
  4. Publica en cada red seleccionada
  5. 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:

  1. Marca los canales deseados en el metabox
  2. Rellena Programar publicación con la fecha deseada
  3. 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:

  1. Guarda el intento en la cola
  2. Reintenta una vez (máximo 2 intentos por post)
  3. 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)