# Pubblicazione sui Social (dfsocialautopost) > Panoramica Il modulo DataFirefly Pubblicazione Automatica sui Social (dfsocialautopost) pubblica automaticamente i tuoi nuovi prodotti PrestaShop su cinque social network: Facebook Page, Telegram, X (Twitter), LinkedIn e Pinterest. Non appena… - Pagina: - Lingua: it - Aggiornato il: 2026-06-27 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfsocialautopost/index.md), [en](https://www.datafirefly.com/en/documentation/dfsocialautopost/index.md), [es](https://www.datafirefly.com/es/documentation/dfsocialautopost/index.md), [de](https://www.datafirefly.com/de/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) - Indice: ## Panoramica Il modulo **DataFirefly Pubblicazione Automatica sui Social** (dfsocialautopost) pubblica automaticamente i tuoi nuovi prodotti PrestaShop su cinque social network: **Facebook Page, Telegram, X (Twitter), LinkedIn e Pinterest**. Non appena un prodotto viene creato o aggiornato, viene messo in coda e poi pubblicato da un cron sicuro, con la sua immagine, il suo prezzo e un messaggio personalizzabile per rete. Il modulo è compatibile con PrestaShop 8.0-9.x, PHP 7.4-8.3, multinegozio, e non richiede alcuna dipendenza da Composer. ## Installazione 1. Scarica l'archivio `dfsocialautopost.zip` dal tuo account DataFirefly. 2. Nel back office di PrestaShop, vai su **Moduli > Gestore moduli**, fai clic su **Carica un modulo** e seleziona lo ZIP. 3. Il modulo si installa, crea la sua tabella di coda, registra i suoi hook e genera un token cron univoco. 4. Fai clic su **Configura** per accedere alle impostazioni. All'installazione, il modulo congela automaticamente la **data di avvio**: nessun prodotto esistente viene pubblicato. Solo i prodotti creati o modificati dopo l'installazione entrano nella coda. ## Configurazione generale ### Modalità di pubblicazione Sono disponibili due modalità: - **Coda + cron sicuro** (consigliato): ogni prodotto viene aggiunto alla coda e pubblicato in background dal cron. È la modalità più affidabile, che non rallenta mai il salvataggio di un prodotto e gestisce i tentativi in modo pulito. - **Immediato (best-effort)**: la pubblicazione viene tentata direttamente al salvataggio del prodotto. Più semplice da testare, ma dipendente dalla disponibilità delle reti in quel momento. ### Il cron sicuro La pagina di configurazione mostra un **URL di cron** protetto da un token segreto, con un pulsante di copia. Ha la seguente forma: ``` https://TUO-DOMINIO/index.php?fc=module&module=dfsocialautopost&controller=cron&token=TUO_TOKEN ``` Aggiungi questo URL all'attività cron del tuo hosting, ad esempio ogni 5-10 minuti: ``` */10 * * * * curl -s "https://TUO-DOMINIO/index.php?fc=module&module=dfsocialautopost&controller=cron&token=TUO_TOKEN" >/dev/null 2>&1 ``` Il token impedisce qualsiasi attivazione non autorizzata del cron. Non condividerlo pubblicamente. In caso di fuga, rigeneralo dalla configurazione: il vecchio URL smetterà di funzionare. ### Protezione anti-retroattiva La data di avvio congelata all'installazione garantisce che il tuo catalogo già online non venga mai pubblicato in massa. Puoi avviare la diffusione con tranquillità: escono solo i prodotti nuovi. ### Filtri Puoi affinare ciò che viene pubblicato: - **Per categoria**: pubblicare solo i prodotti appartenenti a determinate categorie. - **Per stato attivo**: pubblicare solo i prodotti attivi. - **Per data di aggiunta**: combinato con la protezione anti-retroattiva. ## Connessione dei social network Ogni rete si attiva in modo indipendente e dispone delle proprie credenziali. Un pulsante **Testa la connessione** ne verifica immediatamente la validità. ### Facebook (Page) - **Page ID**: l'identificativo numerico della tua pagina Facebook. - **Page Access Token**: un token di accesso di pagina (permessi di pubblicazione), ottenuto tramite un'app Meta / Graph API. Il modulo pubblica tramite la Graph API (endpoint `/feed`, o `/photos` quando è disponibile un'immagine). ### Telegram - **Bot Token**: il token fornito da @BotFather alla creazione del tuo bot. - **Chat ID**: l'identificativo del canale o gruppo di destinazione (il bot deve esservi amministratore). ### X (Twitter) - **API Key** e **API Secret** (chiavi consumer). - **Access Token** e **Access Token Secret**. Il modulo firma le sue richieste con OAuth 1.0a, pubblica il testo tramite l'API v2 e carica l'immagine tramite l'endpoint media v1.1. ### LinkedIn - **Access Token**: token di accesso con permesso di pubblicazione. - **Organization URN**: l'URN della tua pagina aziendale, nel formato `urn:li:organization:XXXXXX`. ### Pinterest - **Access Token**: token di accesso dell'API Pinterest v5. - **Board ID**: l'identificativo della bacheca su cui appuntare i prodotti. ## Modelli di messaggio e variabili Per ogni rete, componi un modello di messaggio. Le seguenti variabili vengono sostituite al momento della pubblicazione: - `{name}` — nome del prodotto - `{price}` — prezzo IVA inclusa - `{price_tax_excl}` — prezzo IVA esclusa - `{reference}` — riferimento - `{description_short}` — descrizione breve - `{url}` — URL della scheda prodotto - `{category}` — categoria predefinita - `{manufacturer}` — produttore - `{quantity}` — quantità in stock - `{shop_name}` — nome del negozio Adatta il tono a ogni rete: breve e diretto su X, visivo su Pinterest, istituzionale su LinkedIn. L'immagine di copertina del prodotto viene inviata automaticamente quando la rete lo consente. ## La coda Il menu di amministrazione del modulo mostra la coda. Ogni riga indica il prodotto, il canale, lo stato, il numero di tentativi, il messaggio e la data. Gli stati possibili sono: - **In coda** — in attesa di essere elaborato dal cron. - **In corso** — in fase di pubblicazione. - **Pubblicato** — diffuso con successo; l'identificativo restituito dalla rete viene conservato. - **Fallito** — la pubblicazione è fallita dopo il numero di tentativi consentito. Sono disponibili due azioni: **Ripubblica** una riga ed **Elabora la coda** manualmente dalla barra degli strumenti. ## Risoluzione dei problemi - **Non viene pubblicato nulla**: verifica che il cron venga effettivamente chiamato (URL + token corretti) e che almeno una rete sia attivata con credenziali valide. - **Una sola rete fallisce**: usa il pulsante di test di connessione della rete interessata; un fallimento non impedisce alle altre reti di pubblicare. - **Nessuna immagine**: alcune reti richiedono un'immagine accessibile pubblicamente; assicurati che il prodotto abbia un'immagine di copertina. - **Duplicati**: la coda deduplica le voci; in modalità immediata, evita di combinarla con il cron sullo stesso prodotto.