# Publicación en Redes Sociales (dfsocialautopost)

> 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.…

- Página: <https://www.datafirefly.com/es/documentation/dfsocialautopost/>
- Idioma: es
- Actualizado el: 2026-06-27
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfsocialautopost/index.md), [en](https://www.datafirefly.com/en/documentation/dfsocialautopost/index.md), [de](https://www.datafirefly.com/de/documentation/dfsocialautopost/index.md), [it](https://www.datafirefly.com/it/documentation/dfsocialautopost/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfsocialautopost/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfsocialautopost/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfsocialautopost/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

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

1. Descarga el archivo `dfsocialautopost.zip` desde tu cuenta DataFirefly.
2. 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.
3. El módulo se instala, crea su tabla de cola, registra sus hooks y genera un token de cron único.
4. 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_TOKEN
```

Añ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>&1
```

El 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.

### LinkedIn

- **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`.

### Pinterest

- **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.
