Publicación en Redes Sociales (dfsocialautopost)
Instala y configura la publicación automática de tus nuevos productos en Facebook, Telegram, X, LinkedIn y Pinterest.
Descripción general
El módulo DataFirefly Publicación Automática en Redes Sociales (dfsocialautopost) publica automáticamente tus nuevos productos de PrestaShop en cinco redes sociales: Facebook Page, Telegram, X (Twitter), LinkedIn y Pinterest. En cuanto se crea o actualiza un producto, se pone en cola y se publica mediante un cron seguro, con su imagen, su precio y un mensaje personalizable por red.
El módulo es compatible con PrestaShop 8.0 a 9.x, PHP 7.4 a 8.3, multitienda, y no requiere ninguna dependencia de Composer.
Instalación
- Descarga el archivo
dfsocialautopost.zipdesde tu cuenta DataFirefly. - En el back office de PrestaShop, ve a Módulos > Gestor de módulos, haz clic en Subir un módulo y selecciona el ZIP.
- El módulo se instala, crea su tabla de cola, registra sus hooks y genera un token de cron único.
- Haz clic en Configurar para acceder a los ajustes.
En la instalación, el módulo congela automáticamente la fecha de inicio: ningún producto existente se publica. Solo los productos creados o modificados después de la instalación entran en la cola.
Configuración general
Modo de publicación
Hay dos modos disponibles:
- Cola + cron seguro (recomendado): cada producto se añade a la cola y se publica en segundo plano mediante el cron. Es el modo más fiable, que nunca ralentiza el guardado de un producto y gestiona los reintentos de forma limpia.
- Inmediato (best-effort): la publicación se intenta directamente al guardar el producto. Más sencillo de probar, pero dependiente de la disponibilidad de las redes en ese momento.
El cron seguro
La página de configuración muestra una URL de cron protegida por un token secreto, con un botón de copia. Tiene la siguiente forma:
https://TU-DOMINIO/index.php?fc=module&module=dfsocialautopost&controller=cron&token=TU_TOKENAñade esta URL a la tarea cron de tu alojamiento, por ejemplo cada 5 a 10 minutos:
*/10 * * * * curl -s "https://TU-DOMINIO/index.php?fc=module&module=dfsocialautopost&controller=cron&token=TU_TOKEN" >/dev/null 2>&1El token impide cualquier activación no autorizada del cron. No lo compartas públicamente. Si se filtra, regenéralo desde la configuración: la URL antigua dejará de funcionar.
Protección anti-retroactiva
La fecha de inicio fijada en la instalación garantiza que tu catálogo ya en línea nunca se publique de forma masiva. Puedes iniciar la difusión con tranquilidad: solo salen los productos nuevos.
Filtros
Puedes afinar lo que se publica:
- Por categoría: publicar solo los productos que pertenecen a ciertas categorías.
- Por estado activo: publicar solo los productos activos.
- Por fecha de alta: combinado con la protección anti-retroactiva.
Conexión de las redes sociales
Cada red se activa de forma independiente y dispone de sus propias credenciales. Un botón Probar la conexión comprueba al instante su validez.
Facebook (Page)
- Page ID: el identificador numérico de tu página de Facebook.
- Page Access Token: un token de acceso de página (permisos de publicación), obtenido mediante una aplicación Meta / Graph API.
El módulo publica mediante la Graph API (endpoint /feed, o /photos cuando hay una imagen disponible).
Telegram
- Bot Token: el token proporcionado por @BotFather al crear tu bot.
- Chat ID: el identificador del canal o grupo de destino (el bot debe ser administrador en él).
X (Twitter)
- API Key y API Secret (claves de consumidor).
- Access Token y Access Token Secret.
El módulo firma sus peticiones con OAuth 1.0a, publica el texto mediante la API v2 y sube la imagen mediante el endpoint de medios v1.1.
- Access Token: token de acceso con permiso de publicación.
- Organization URN: la URN de tu página de empresa, en el formato
urn:li:organization:XXXXXX.
- Access Token: token de acceso de la API de Pinterest v5.
- Board ID: el identificador del tablero en el que fijar los productos.
Plantillas de mensaje y variables
Para cada red, compones una plantilla de mensaje. Las siguientes variables se sustituyen en el momento de publicar:
{name}— nombre del producto{price}— precio con IVA{price_tax_excl}— precio sin IVA{reference}— referencia{description_short}— descripción corta{url}— URL de la ficha de producto{category}— categoría por defecto{manufacturer}— fabricante{quantity}— cantidad en stock{shop_name}— nombre de la tienda
Adapta el tono a cada red: breve y directo en X, visual en Pinterest, institucional en LinkedIn. La imagen de portada del producto se envía automáticamente cuando la red lo permite.
La cola
El menú de administración del módulo muestra la cola. Cada fila indica el producto, el canal, el estado, el número de intentos, el mensaje y la fecha. Los estados posibles son:
- En cola — a la espera de ser procesado por el cron.
- En curso — en proceso de publicación.
- Publicado — difundido con éxito; se conserva el identificador devuelto por la red.
- Fallido — la publicación falló tras el número de intentos permitido.
Hay dos acciones disponibles: Republicar una fila y Procesar la cola manualmente desde la barra de herramientas.
Resolución de problemas
- No se publica nada: comprueba que el cron se llama realmente (URL + token correctos) y que al menos una red está activada con credenciales válidas.
- Una sola red falla: usa el botón de prueba de conexión de la red afectada; un fallo no impide que las demás redes publiquen.
- Sin imagen: algunas redes requieren una imagen accesible públicamente; asegúrate de que el producto tenga una imagen de portada.
- Duplicados: la cola deduplica las entradas; en modo inmediato, evita combinarlo con el cron en el mismo producto.