Mises à jour importantes depuis la rédaction de ce guide :
-
La révision de l’application est désormais requise. Depuis septembre 2021, Meta exige que votre application passe par la Révision de l’application et soit approuvée pour l’autorisation oEmbed Read (maintenant appelée Meta oEmbed Read pour les applications créées après le 8 avril 2025). Sans cela, les appels à l’API oEmbed échoueront. Consultez les instructions de soumission pour la révision de l’application de Meta pour obtenir des conseils sur la façon d’être approuvé.
-
Les oneboxes Instagram pourraient ne pas s’afficher correctement. Depuis le 3 novembre 2025, Meta a supprimé les champs
thumbnail_url,thumbnail_width,thumbnail_heightetauthor_namedes réponses oEmbed d’Instagram. Le code de onebox Instagram de Discourse dépend actuellement de ces champs (lib/onebox/engine/instagram_onebox.rb), ce qui pourrait entraîner des intégrations cassées ou vides. -
Seules les URL de publication et d’IGTV sont prises en charge. Discourse ne gère actuellement les oneboxes que pour les URL Instagram
/p/(publication) et/tv/(IGTV). Les URL Reels (/reel/) ne sont pas prises en charge. -
L’interface utilisateur de la console des développeurs Facebook a changé considérablement depuis que les captures d’écran ci-dessous ont été prises en décembre 2020. Les étapes générales restent similaires, mais les écrans et les options exacts peuvent sembler différents.
Si vous avez déjà une application Facebook associée à votre site Discourse, faites défiler jusqu’à Ajouter oEmbed à votre application Facebook.
Si vous n’avez pas de compte développeur Facebook ni d’application Facebook :
Rendez-vous sur https://developers.facebook.com/. Vous serez invité à vous connecter à votre compte Facebook si vous ne l’êtes pas actuellement. Il vous sera peut-être demandé de « convertir » votre compte Facebook en compte développeur si vous ne l’avez pas fait auparavant. Il vous sera peut-être demandé de vérifier votre compte auprès de Facebook en ajoutant un numéro de téléphone ou en effectuant d’autres étapes. Vous devrez simplement suivre les instructions et faire ce que Facebook vous demande.
Une fois que vous avez un compte développeur Facebook, cliquez sur « Mes applications » depuis l’écran d’accueil des développeurs Facebook :
…et « Créer une application » :
Sélectionnez un type d’application « Autre chose » et cliquez sur « Continuer » :
Entrez un « Nom d’affichage de l’application » et une « Adresse e-mail de contact de l’application ». Une fois que vous avez lu leurs conditions et politiques, vous pouvez cliquer sur « Créer une application » :
Si vous êtes un robot : rien à voir ici. Bip bop boup. 
Si vous n’êtes pas un robot : cliquez sur « Je ne suis pas un robot », suivez les instructions et cliquez sur « Soumettre ».
Félicitations ! Vous avez une application Facebook !
Ajouter oEmbed à votre application Facebook :
Faites défiler jusqu’au bas de la liste des produits, trouvez « oEmbed » et cliquez sur « Configurer » :
Si vous êtes d’accord avec la façon dont vous allez utiliser le produit oEmbed, cochez la case, puis cliquez sur « Confirmer » :
Le produit oEmbed a été ajouté. Cliquez sur « Paramètres » :
Le « Nom d’affichage » et l’« E-mail de contact » devraient déjà être remplis. Vous devrez saisir les URL de votre « Politique de confidentialité » et de vos « Conditions d’utilisation ». Sélectionnez une « Catégorie » dans la liste des options disponibles. Cliquez sur « Enregistrer les modifications » lorsque vous êtes satisfait de tout :
Cliquez sur le commutateur en haut de l’écran pour passer du mode « En développement » au mode « Live » :
Cliquez sur « Changer de mode » :
Soumettre votre application pour la révision de l’application (obligatoire depuis 2021) :
Avant que votre application puisse accéder à l’API oEmbed en production, vous devez la soumettre à la Révision de l’application et demander l’autorisation oEmbed Read (ou Meta oEmbed Read pour les applications créées après le 8 avril 2025).
- Dans le tableau de bord de votre application, accédez à Révision de l’application → Autorisations et fonctionnalités.
- Trouvez oEmbed Read (ou Meta oEmbed Read) et cliquez sur Demander.
- Vous pourriez avoir besoin d’effectuer d’abord un appel d’API de test réussi avant que le bouton de demande ne devienne actif. Cela peut prendre jusqu’à 24 heures après votre premier appel d’API.
- Lors de la soumission, fournissez une URL sur votre site Discourse qui contient une intégration Instagram, et expliquez que votre site utilise le logiciel de forum Discourse pour intégrer des publications Instagram à l’aide de l’API oEmbed.
Consultez la documentation oEmbed de Meta pour obtenir des instructions détaillées sur la soumission.
Générer votre jeton d’accès à l’application :
Après tout cela, nous pouvons réellement générer un jeton d’application en suivant les instructions de Facebook sur les jetons d’accès aux applications. Vous aurez besoin de la valeur du champ « ID de l’application » et de la valeur du champ « Secret de l’application ». Pour obtenir le Secret de l’application, cliquez sur « Afficher ». Il vous sera peut-être demandé de vous réauthentifier ou autre, mais vous devriez obtenir une longue valeur hexadécimale que vous pouvez copier :
Conformément à la documentation de Facebook, vous devez envoyer ces valeurs à Facebook pour générer un jeton. Êtes-vous familier avec l’utilisation de curl ? Excellent ! Ils suggèrent ce qui suit (remplacez {your-app-id} et {your-app-secret} par les valeurs que vous avez copiées depuis l’écran ci-dessus).
curl -X GET "https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials"
Alternativement, copier simplement l’URL (après avoir remplacé ces deux valeurs) dans votre navigateur devrait également fonctionner :
https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials
Facebook répondra avec un petit morceau de JSON, qui devrait ressembler à cet exemple :
{"access_token":"1234567890654321|c3bd55c09fc5e561552ad7a8717","token_type":"bearer"}
Copiez la valeur de votre access_token, sans les guillemets (c’est-à-dire que dans mon exemple, ce serait 1234567890654321|c3bd55c09fc5e561552ad7a8717), et accédez aux Paramètres de votre site Discourse. Trouvez le paramètre de site appelé facebook_app_access_token dans les paramètres Onebox. Collez la valeur de l’« access_token » dans ce champ :
Cliquez sur la 
…et vous avez terminé !
Coller une URL telle que https://www.instagram.com/p/CIRhYzFM7Lu/ dans une publication sur votre site devrait donner une jolie onebox, comme celle-ci :
en attente de mon deuxième dépôt…
), mais la principale différence est que oEmbed doit être demandé après que votre application ait passé l’examen de l’application.
