# Pubblicazione su Facebook

Il BOT supporta la pubblicazione di offerte su Pagine e Gruppi Facebook tramite l'utilizzo delle API ufficiali. 

{% hint style="danger" %}
**Facebook ha rimosso il supporto ai Gruppi dalle API ufficiali.**

Purtroppo al momento non c'é possibilità di pubblicare sui gruppi Facebook, solo sulle pagine.
{% endhint %}

### Funzionalità Principali

* 👉 Supporto per un massimo di **3 Pagine** e **3 Gruppi** Facebook per ogni BOT <br>
* 👉 Possibilità di personalizzazione dei Formati di pubblicazione per i singoli Post (ad es. in base allo store, alla percentuale di sconto e molto altro!)<br>
* 👉 Possibilità di filtrare i Post da pubblicare sulla base della tipologia e dello store<br>
* 👉 Possibilità di personalizzare le immagine allegate ai Post su Facebook, con distinzione tra Post Singoli e Post Multipli<br>
* 👉 Possibilità di sincronizzare automaticamente la scadenza offerte con i Post pubblicati sulle Pagine<br>
* 👉 Possibilità di impostare un ritardo minimo di pubblicazione tra post su Pagine e Gruppi (in modo da spalmare i post sull'intera giornata)<br>
* 👉 Limitazione personalizzabile sul numero massimo di post giornalieri su Pagine e Gruppi (si consiglia di non superare **mai** i 25 post)

### Configurazione

Le impostazioni relative alla configurazione Facebook sul BOT si trovano in:\
\
**Impostazioni -> Integrazioni -> Facebook**&#x20;

![](/files/-MZ472DveRrZ3XLz1SlI)

### Creazione di un'App Facebook

Per prima cosa procediamo alla creazione di un'App Facebook da associare al BOT.

{% hint style="info" %}
E' consigliabile eseguire le seguenti operazioni con l'utilizzo di un PCCollegarsi all'indirizzo <https://developers.facebook.com/><br>
{% endhint %}

1. Selezionare il pulsante "**Inizia**" oppure "**Accedi**" in alto a destra.\
   \&#xNAN;*Se non siete loggati, effettuate l'accesso con l'account Facebook sul quale siete amministratori della pagina.*<br>

2. Se non avete mai eseguito la procedura di configurazione di un account "Facebook for Developers", verrà mostrata la seguente schermata. Selezionare "**Continua**".\
   Altrimenti procedere al punto 5.<br>

   <figure><img src="/files/KCxDs4Zbm5yhmGbCr6J9" alt=""><figcaption></figcaption></figure>

3. Nella schermata seguente selezionare "**Marketer**" e premere "**Completa l'iscrizione**".<br>

   <figure><img src="/files/I75NTeMgZ0gFBTjtlYXB" alt=""><figcaption></figcaption></figure>

4. Selezionando "**Le mie app**" (menu in alto) ci si troverà di fronte a una pagina simile alla seguente (potrebbero essere visualizzate alcune app di altri sviluppatori se le avete collegate in passato)<br>

   <figure><img src="/files/u7sq7SGauZzuTU0oqtFr" alt=""><figcaption></figcaption></figure>

5. Selezionare il pulsante "**Crea un'app**" in alto a destra.<br>

6. Inserire "**DealsApp**" (senza virgolette) nel campo "Nome dell'App" e premere il pulsante "**Avanti**"<br>

   <figure><img src="/files/EG8mAdaolsooIM0eNVlL" alt=""><figcaption></figcaption></figure>

7. Nella schermata dei "Casi d'uso" selezionare "**Gestisci tutto sulla tua Pagina**" e premere "**Avanti**" (*se non dovesse essere visibile selezionare "Tutti" a lato e cercarlo nella lista*)<br>

   <figure><img src="/files/gohQcLPRd6ltWSgmv8qk" alt=""><figcaption></figcaption></figure>

8. Selezionare "**Non voglio ancora collegare un portfolio business**":<br>

   <figure><img src="/files/oE8E6suQzrUdzUMlOVWw" alt=""><figcaption></figcaption></figure>

9. Selezionare "**Avanti**", senza intraprendere alcuna azione, nella pagina dei "**Requisiti di Pubblicazione"**<br>

10. Selezionare "Vai alla dashboard" ed inserire la password dell'account se richiesta<br>

11. Selezionare dal menu laterale la voce "**Impostazioni app**" e poi "**Di base**".<br>

12. Copiare il contenuto dei campi **ID app** e **Chiave segreta** (è necessario selezionare il pulsante "**Mostra**" accanto per visualizzare il contenuto di quest'ultima), ed incollarli su un blocco note (o in una posizione a piacere), ci serviranno in seguito sul BOT.<br>

13. Inserire nel campo "**URL dell'Informativa sulla privacy**" il seguente link: <https://dealsbot.io/privacy-policy-facebook-app.html><br>

14. Selezionare "**Salva modifiche**" (in basso a destra). Il risultato dovrebbe essere simile al seguente:<br>

    <figure><img src="/files/0LM6IDmdwuXUTeXUYVgQ" alt=""><figcaption></figcaption></figure>

15. Selezionare dal menu laterale "**Impostazioni app**" e poi "**Avanzate**".<br>

16. Cercare il campo "**Token client**" e copiarne il contenuto su un blocco note (o in una posizione a piacere), ci servirà in seguito sul BOT.<br>

    <figure><img src="/files/dlIIPzaS7mrS95qvMB4U" alt=""><figcaption></figcaption></figure>

17. Dal menu laterale selezionare il menu "Facebook Login for Business" ed in seguito Impostazioni:<br>

    <figure><img src="/files/neYajrGTw0a2n1jXUidC" alt=""><figcaption></figcaption></figure>

18. Trovare sulla destra la casella "**Accesso dai dispositivi**" ed abilitarla.

<figure><img src="/files/bwXw0aHYzpxtBUkptwEZ" alt=""><figcaption></figcaption></figure>

21. Selezionare il pulsante **"Salva Modifiche"** in basso.<br>

22. Dal menu laterale di sinistra selezionare "**Casi d'uso**", poi premere il pulsante "**Personalizza**" accanto al caso d'uso "*Gestisci tutto sulla tua pagina*":<br>

    <figure><img src="/files/alhkkFEiJXg2SDp8z1Bt" alt=""><figcaption></figcaption></figure>

23. Dalla schermata che si apre nascondere l'eventuale popup che compare premendo "Fine":\
    ![](/files/Mqq7S5IGof7y7WPwdT5x)<br>

24. Scorrere la lista delle Autorizzazioni verso il basso fino a che si trovano i seguenti due elementi:
    1. **pages\_manage\_posts**
    2. **pages\_read\_engagement**\
       \
       ![](/files/4KRcwGCX00EkuxaguC3A)<br>

25. Premere il pulsante "**Aggiungi**" accanto ad ognuna delle due azioni (comparirà al suo posto il pulsante "*Azioni*"):<br>

    <figure><img src="/files/nMFdhEVWJquigpcya5nQ" alt=""><figcaption></figcaption></figure>

26. Adesso torniamo nel menu laterale di sinistra e selezioniamo la sezione "**Pubblicazione**":\
    ![](/files/OLKXOGoqWFsDMQZqMcue)<br>

27. Selezioniamo il pulsante "**Pubblica**" in basso a destra per completare la pubblicazione dell'App<br>

28. Se tutto è stato eseguito correttamente si riceverà un messaggio di conferma simile al seguente:\
    ![](/files/HfAebx9HdbCqTG4XLuLo)<br>

29. **Fatto!** Le operazioni di creazione dell'App sono completate! Spostiamoci ora sul BOT.

### Configurazione dell'App sul BOT

Ora dobbiamo collegare l'App appena creata sul BOT Telegram.

1. Dal BOT navigare in **Impostazioni -> Integrazioni -> Facebook**<br>
2. Selezionare **Configurazione App**, ci si troverà di fronte alla seguente schermata:\ <br>

   <figure><img src="/files/Rifq42wqE16X01xsf9FE" alt=""><figcaption></figcaption></figure>
3. Selezionare **Configura API**.<br>
4. Inviare un messaggio contenente l'**App ID** ottenuto al **punto 9** del paragrafo precedente.\
   **Nota:** inviare soltanto l'App ID senza ulteriori testi.<br>
5. Inviare ora un messaggio contenente l'**App Secret** ottenuto al punto 9 del pragrafo precedente.\
   **Nota:** inviare soltanto l'App Secret senza ulteriori testi.<br>
6. Inviare ora un messaggio contente il **Token Client** ottenuto al punto 13 del paragrafo precedente.\
   **Nota:** inviare soltanto il Token Client senza ulteriori testi.<br>
7. Se tutto è stato eseguito correttamente tornando al menu precedente comparirà il pulsante "**Configurazione Pagine**".\
   Si può ora passare alla sezione successiva di questa guida.<br>

   <figure><img src="/files/mvTsGh2UQglrzSAZSS0j" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
L'App ID, l'App Secret e il Token Client possono essere utilizzati su più BOT per permettere la pubblicazione da canali diversi.\
E' comunque consigliato rispettare il limite massimo totale di 25 Post giornalieri su una singola pagina per evitare limitazioni da parte di Facebook.
{% endhint %}

{% hint style="danger" %}
**Non condividere MAI l'App Secret o il Token Client.**\
Facendo ciò forniresti l'accesso completo alle tue Pagine Facebook e gruppi.
{% endhint %}

### Configurazione delle Pagina / Gruppi sul BOT

In questa sezione completeremo la configurazione selezionando la Pagina su cui effettuare la pubblicazione.

1. Dal BOT navigare in **Impostazioni -> Integrazioni -> Facebook -> Configurazione Pagine (o Configurazione Gruppi)**<br>

2. Selezionare il pulsante **Aggiungi Pagina (o Aggiungi Gruppo)**. Verrà mostrata una schermata con un codice, simile alla seguente.<br>

   <figure><img src="/files/OQGX0PBxqFDDEF2abEBW" alt=""><figcaption></figcaption></figure>

3. Premere sul primo pulsante **Collega Account**, oppure navigare a: <https://www.facebook.com/device><br>

4. Assicurarsi di essere connessi con l'Account Facebook corretto (su cui si possiedono le pagine), ed inserire nel campo il codice fornito dal BOT.<br>

   <figure><img src="/files/lyWE68h9A2dY7ss6y3dw" alt=""><figcaption></figcaption></figure>

5. Premere **Continua.** Verrà visualizzata una schermata di richiesta permessi simile alla seguente.\
   Ignorare eventuali avvisi di "*App non verificata*", e **concedere tutte le autorizzazioni richieste**.<br>

   <figure><img src="/files/oldwSsa7aWlO7muCYkj8" alt=""><figcaption></figcaption></figure>

6. Se l'operazione è andata a buon fine verrà visualizzata una schermata simile alla seguente:<br>

   <figure><img src="/files/ZkiORHXponW8haYMqf2d" alt=""><figcaption></figcaption></figure>

7. Tornare sul BOT e premere il secondo pulsante Verifica Connessione.<br>

8. Se tutto è andato per il verso giusto dovremmo riuscire a vedere una tastiera contenente la lista delle nostre pagine.<br>

9. Selezioniamo dalla lista la pagina su cui vogliamo far pubblicare il BOT. Se non ci sono stati errori, il nome della pagina comparirà nella tastiera.<br>

   <figure><img src="/files/PU13NynPernH9rJibPUc" alt=""><figcaption></figcaption></figure>

10. Abilitare la spunta a **Facebook Attivo** per iniziare a pubblicare i nuovi Post creati su Facebook.

{% hint style="info" %}
E' possibile collegare **fino a 3 Pagine** e **3 Gruppi** sul BOT
{% endhint %}

{% hint style="info" %}
Una volta collegata almeno una Pagina sarà possibile procedere alla configurazione di eventuali gruppi tramite il pulsante **Configurazione Gruppi**
{% endhint %}

### Limitazioni di Facebook

#### Numero di Post Pubblicabili:

Di default il BOT **limita il numero di Post Giornalieri** per una singola Pagina Facebook a **25**. Per i Gruppi è invece impostato a **20**.\
La motivazione di questa limitazione deriva dal fatto che Facebook ha la tendenza di segnalare come SPAM le pagine che pubblicano un numero troppo elevato di Post giornalieri, penalizzandole lato interazioni. \
Per i Gruppi invece, l'account della pagina collegata potrebbe addirittura essere bannato.\
\
Puoi modificare questo limite **fino a 60** tramite il pulsante `🚧 Limite Post Giornalieri` nelle Impostazioni Facebook. E' **assolutamente sconsigliato** andare oltre ai 25 Post Giornalieri complessivi.

#### **Modifica dei Post sui Gruppi:**

Al momento non è possibile modificare i Post pubblicati sui gruppi tramite API.\
Pertanto, eventuali terminazioni offerte non verranno riportate sui Gruppi Facebook, ma solamente sulle pagine (se abilitate).

#### TAG HTML:

Facebook non supporta la formattazione HTML all'interno del testo. Pertanto eventuali TAG presenti negli stili di Facebook verranno ignorati e / o rimossi. <br>

### Problemi conosciuti

* **Immagini mancanti per i Post sui gruppi:** in alcune occasioni la pubblicazione dell'immagine fallisce sui gruppi e viene pubblicato solo il testo. Purtroppo questo è un **Bug di Facebook** segnalato più di 1 anno fa e non ancora risolto.<br>
* **Copertura dei Post bassa sui gruppi:** in alcune occasioni i Post pubblicati dal BOT sui gruppi ottengono valori di copertura molto bassi. Purtroppo la causa di questo problema è sconosciuta, ma comunque imputabile a Facebook. Sulle pagine invece tutto sembra funzionare regolarmente.

### Errori

#### Sessione Scaduta:

In alcune situazioni può capitare che Facebook disconnetta le sessioni delle Pagine e dei Gruppi collegati. Quando questo accade il BOT invia un messaggio di avviso all'admin principale del BOT ed imposta lo stato di Facebook in "Errore: sessione scaduta". \
Questo solitamente accade in seguito a modifiche della Password dell'account Facebook, o alla disconnessione di tutte le sessioni dall'Account utilizzato per collegare le pagine e i gruppi al BOT.\
Per risolvere è necessario ricollegare Pagine e Gruppi sul BOT da `Impostazioni -> Integrazioni -> Facebook`.\
Rimuovere dunque le Pagine e i Gruppi dalla lista, e procedere alla riconnessione.\
**Non vanno riconfigurate le API, ma solamente le pagine e i gruppi!**\
\
**Una volta riconfigurati riavviare il BOT tramite il menu Impostazioni - Info BOT - Riavvia BOT.**

#### Il BOT non pubblica più sui gruppi / Non riesco a collegare i gruppi:

Il problema potrebbe essere causato dal passaggio automatico a "**Facebook Login For Business**". Controlla la casella e-mail (anche lo spam): dovresti aver ricevuto una e-mail da Facebook che ti informa del passaggio. \
Se hai ricevuto l'e-mail procedi in questo modo:

* Collegati a [developers.facebook.com](https://developers.facebook.com/) - fai il login e nella sezione "**Le Mie App**" seleziona l'applicazione che hai creato per il BOT.
* Nel menu laterale di sinistra seleziona "**Facebook Login For Business**" e poi "**Impostazioni**"
* In alto dovresti vedere un messaggio che ti permette di tornare a "Facebook Login" con un testo cliccabile "**Passa a Facebook Login**"
* Selezionare "Passa a Facebook Login"
* Nella finestra successiva selezionare "**Alcune autorizzazioni non sono disponibile con questo prodotto**". Dalla tendina sotto selezionare poi "**publish\_to\_groups**".&#x20;
* Confermare il passaggio e salvare le modifiche. Il BOT dovrebbe tornare a pubblicare correttamente su Facebook.<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dealsbot.io/integrazioni/pubblicazione-su-pagina-facebook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.