Aggiornamenti importanti da quando questa guida è stata scritta originariamente:
-
La Revisione dell’app è ora obbligatoria. Da settembre 2021, Meta richiede che la tua app superi la Revisione dell’app e sia approvata per il permesso oEmbed Read (ora chiamato Meta oEmbed Read per le app create dopo l’8 aprile 2025). Senza questo, le chiamate API oEmbed falliranno. Consulta le indicazioni per l’invio della Revisione dell’app di Meta per suggerimenti su come ottenere l’approvazione.
-
Le onebox di Instagram potrebbero non essere visualizzate correttamente. A partire dal 3 novembre 2025, Meta ha rimosso i campi
thumbnail_url,thumbnail_width,thumbnail_heighteauthor_namedalle risposte oEmbed di Instagram. Il codice onebox di Instagram di Discourse attualmente dipende da questi campi (lib/onebox/engine/instagram_onebox.rb), il che potrebbe comportare incorporamenti non funzionanti o vuoti. -
Sono supportati solo gli URL di post e IGTV. Attualmente, Discourse esegue l’uno-boxing solo per gli URL
/p/(post) e/tv/(IGTV) di Instagram. Gli URL Reels (/reel/) non sono supportati. -
L’interfaccia utente della Console per sviluppatori di Facebook è cambiata in modo significativo da quando gli screenshot seguenti sono stati acquisiti a dicembre 2020. I passaggi generali rimangono simili, ma le schermate e le opzioni esatte potrebbero apparire diverse.
Se hai già un’app Facebook associata al tuo sito Discourse, scorri fino a Aggiungere oEmbed alla tua app Facebook.
Se non hai un account Sviluppatore Facebook e un’app Facebook:
Vai su https://developers.facebook.com/. Ti verrà richiesto di accedere al tuo account Facebook se non hai effettuato l’accesso. Potrebbe esserti chiesto di “convertire” il tuo account Facebook in un account sviluppatore se non l’hai fatto in precedenza. Potrebbe esserti chiesto di verificare il tuo account con Facebook aggiungendo un numero di telefono o completando altri passaggi. Dovrai semplicemente seguire le istruzioni e fare ciò che Facebook ti richiede.
Una volta che hai un account Sviluppatore Facebook, fai clic su “Le mie app” dalla schermata iniziale degli sviluppatori di Facebook:
…e “Crea app”:
Seleziona un tipo di app di “Altro” e “Continua”:
Inserisci un “Nome visualizzato dell’app” e un’“Email di contatto dell’app”. Una volta letti i loro Termini e politiche, puoi fare clic su “Crea app”:
Se sei un robot: non c’è nulla da vedere qui. Bip bop boop. 
Se non sei un robot: fai clic su “Non sono un robot”, segui le istruzioni e fai clic su “Invia”.
Congratulazioni! Hai un’app Facebook!
Aggiungere oEmbed alla tua app Facebook:
Scorri fino alla fine dell’elenco dei Prodotti, trova “oEmbed” e fai clic su “Configura”:
Se sei d’accordo con il modo in cui utilizzerai il prodotto oEmbed, seleziona la casella di controllo e poi fai clic su “Conferma”:
Il prodotto oEmbed è stato aggiunto. Fai clic su “Impostazioni”:
“Nome visualizzato” ed “Email di contatto” dovrebbero essere già compilati. Dovrai inserire gli URL per la tua “Informativa sulla privacy” e i “Termini di servizio”. Seleziona una “Categoria” dall’elenco delle opzioni disponibili. Fai clic su “Salva modifiche” quando sei soddisfatto di tutto:
Fai clic sull’interruttore in alto nella schermata per passare dalla modalità “In sviluppo” alla modalità “Live”:
Fai clic su “Cambia modalità”:
Invia la tua app per la Revisione dell’app (obbligatoria dal 2021):
Prima che la tua app possa accedere all’API oEmbed in produzione, devi inviarla per la Revisione dell’app e richiedere il permesso oEmbed Read (o Meta oEmbed Read per le app create dopo l’8 aprile 2025).
- Nella dashboard della tua app, vai a Revisione dell’app → Permessi e Funzionalità.
- Trova oEmbed Read (o Meta oEmbed Read) e fai clic su Richiedi.
- Potrebbe essere necessario prima effettuare una chiamata API di prova riuscita prima che il pulsante di richiesta diventi attivo. Potrebbero essere necessarie fino a 24 ore dopo la prima chiamata API.
- Al momento dell’invio, fornisci un URL sul tuo sito Discourse che contiene un’incorporazione di Instagram e spiega che il tuo sito utilizza il software del forum Discourse per incorporare i post di Instagram utilizzando l’API oEmbed.
Consulta la documentazione oEmbed di Meta per indicazioni dettagliate sull’invio.
Genera il tuo Token di accesso dell’app:
Fatto tutto questo, possiamo effettivamente generare un Token dell’app seguendo le istruzioni di Facebook su Token di accesso dell’app. Avrai bisogno del valore del campo “ID app” e del valore del campo “Segreto app”. Per ottenere il Segreto app, fai clic su “Mostra”. Potrebbe esserti chiesto di autenticarti di nuovo o altro, ma dovresti ottenere un lungo valore esadecimale che puoi copiare:
Come da documentazione di Facebook, devi inviare questi valori a Facebook per generare un token. Hai familiarità con l’uso di curl? Ottimo! Suggeriscono quanto segue (sostituendo {your-app-id} e {your-app-secret} con i valori che hai copiato dalla schermata sopra).
curl -X GET "https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials"
In alternativa, copiare solo l’URL (dopo aver sostituito quei due valori) nel browser dovrebbe funzionare:
https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials
Facebook risponderà con un piccolo blocco di JSON, che dovrebbe assomigliare a questo esempio:
{"access_token":"1234567890654321|c3bd55c09fc5e561552ad7a8717","token_type":"bearer"}
Copia il valore del tuo access_token, escluse le virgolette (cioè, nel mio esempio sarebbe 1234567890654321|c3bd55c09fc5e561552ad7a8717), e vai alle Impostazioni del tuo sito Discourse. Trova l’impostazione del sito chiamata facebook_app_access_token nelle impostazioni Onebox. Incolla il valore ‘access_token’ in questo campo:
Fai clic sulla 
…e hai finito!
Incollare un URL come https://www.instagram.com/p/CIRhYzFM7Lu/ in un post sul tuo sito dovrebbe dare come risultato una bella onebox, proprio come questa:
in attesa che la mia seconda app venga…
), ma la differenza principale è che oEmbed deve essere richiesto dopo che la tua app ha superato la Revisione app.
