Actualizaciones importantes desde que se escribió esta guía:
-
La Revisión de la Aplicación ahora es obligatoria. Desde septiembre de 2021, Meta requiere que su aplicación pase la Revisión de la Aplicación y sea aprobada para el permiso oEmbed Read (ahora llamado Meta oEmbed Read para aplicaciones creadas después del 8 de abril de 2025). Sin esto, las llamadas a la API oEmbed fallarán. Consulte la guía de envío de Revisión de la Aplicación de Meta para obtener consejos sobre cómo ser aprobado.
-
Es posible que los oneboxes de Instagram no se muestren correctamente. A partir del 3 de noviembre de 2025, Meta eliminó los campos
thumbnail_url,thumbnail_width,thumbnail_heightyauthor_namede las respuestas oEmbed de Instagram. El código del onebox de Instagram de Discourse depende actualmente de estos campos (lib/onebox/engine/instagram_onebox.rb), lo que puede resultar en embeds rotos o vacíos. -
Solo se admiten las URL de publicaciones e IGTV. Actualmente, Discourse solo convierte a onebox las URL de Instagram
/p/(publicación) y/tv/(IGTV). Las URL de Reels (/reel/) no son compatibles. -
La interfaz de usuario de la Consola de Desarrolladores de Facebook ha cambiado significativamente desde que se tomaron las capturas de pantalla a continuación en diciembre de 2020. Los pasos generales siguen siendo similares, pero las pantallas y opciones exactas pueden verse diferentes.
Si ya tiene una Aplicación de Facebook asociada con su sitio de Discourse, desplácese hasta Añadir oEmbed a su Aplicación de Facebook.
Si no tiene una cuenta de Desarrollador de Facebook ni una Aplicación de Facebook:
Vaya a https://developers.facebook.com/. Se le pedirá que inicie sesión en su cuenta de Facebook si no ha iniciado sesión. Se le puede pedir que ‘convierta’ su cuenta de Facebook en una cuenta de desarrollador si no lo ha hecho antes. Se le puede pedir que verifique su cuenta con Facebook añadiendo un número de teléfono o completando otros pasos. Solo tendrá que seguir las indicaciones y hacer lo que Facebook le exija.
Una vez que tenga una cuenta de Desarrollador de Facebook, haga clic en ‘Mis Aplicaciones’ desde la pantalla de inicio de Desarrollador de Facebook:
…y en ‘Crear Aplicación’:
Seleccione un tipo de aplicación de ‘Otra cosa’ (‘Something Else’) y haga clic en ‘Continuar’ (‘Continue’):
Introduzca un ‘Nombre de visualización de la aplicación’ (‘App Display Name’) y un ‘Correo electrónico de contacto de la aplicación’ (‘App Contact Email’). Una vez que haya leído sus Términos y Políticas, puede hacer clic en ‘Crear Aplicación’ (‘Create App’):
Si es un robot: nada que ver aquí. Bip bop boop. 
Si no es un robot: haga clic en “No soy un robot”, siga las indicaciones y haga clic en ‘Enviar’ (‘Submit’).
¡Felicidades! ¡Tiene una Aplicación de Facebook!
Añadir oEmbed a su Aplicación de Facebook:
Desplácese hasta la parte inferior de la lista de Productos, encuentre ‘oEmbed’ y haga clic en ‘Configurar’ (‘Set Up’):
Si está de acuerdo con el uso que se le dará al producto oEmbed, marque la casilla y luego haga clic en ‘Confirmar’ (‘Confirm’):
El producto oEmbed se ha añadido. Haga clic en ‘Configuración’ (‘Settings’):
El ‘Nombre de visualización’ (‘Display Name’) y el ‘Correo electrónico de contacto’ (‘Contact Email’) ya deberían estar rellenados. Deberá introducir las URL de su ‘Política de Privacidad’ (‘Privacy Policy’) y ‘Términos de Servicio’ (‘Terms of Service’). Seleccione una ‘Categoría’ (‘Category’) de la lista de opciones disponibles. Haga clic en ‘Guardar cambios’ (‘Save Changes’) cuando esté satisfecho con todo:
Haga clic en el interruptor en la parte superior de la pantalla para cambiar de modo ‘En desarrollo’ (‘In development’) a modo ‘Activo’ (‘Live’):
Haga clic en ‘Cambiar modo’ (‘Switch Mode’):
Enviar su aplicación para la Revisión de la Aplicación (obligatorio desde 2021):
Antes de que su aplicación pueda acceder a la API oEmbed en producción, debe enviarla para Revisión de la Aplicación y solicitar el permiso oEmbed Read (o Meta oEmbed Read para aplicaciones creadas después del 8 de abril de 2025).
- En el panel de control de su aplicación, vaya a Revisión de la Aplicación → Permisos y Características.
- Busque oEmbed Read (o Meta oEmbed Read) y haga clic en Solicitar (‘Request’).
- Es posible que primero deba realizar una llamada de prueba exitosa a la API antes de que el botón de solicitud esté activo. Puede tardar hasta 24 horas después de su primera llamada a la API.
- Al enviar, proporcione una URL en su sitio de Discourse que contenga una inserción de Instagram y explique que su sitio utiliza el software de foro Discourse para insertar publicaciones de Instagram mediante la API oEmbed.
Consulte la documentación de oEmbed de Meta para obtener orientación detallada sobre el envío.
Generar su Token de Acceso de Aplicación:
Habiendo hecho todo eso, podemos generar un Token de Aplicación siguiendo las instrucciones de Facebook sobre Tokens de Acceso de Aplicación. Necesitará el valor del campo ‘ID de la Aplicación’ (‘App ID’) y el valor del campo ‘Secreto de la Aplicación’ (‘App Secret’). Para obtener el Secreto de la Aplicación, haga clic en ‘Mostrar’ (‘Show’). Se le puede pedir que se reautentique o similar, pero debería obtener un valor hexadecimal largo que pueda copiar:
Según la documentación de Facebook, debe enviar esos valores a Facebook para generar un token. ¿Está familiarizado con el uso de curl? ¡Genial! Sugieren lo siguiente (reemplazando {your-app-id} y {your-app-secret}) con los valores que copió de la pantalla anterior.
curl -X GET "https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials"
Alternativamente, copiar solo la URL (después de reemplazar esos dos valores) en su navegador también debería funcionar:
https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials
Facebook responderá con un pequeño fragmento de JSON, que debería parecerse a este ejemplo:
{"access_token":"1234567890654321|c3bd55c09fc5e561552ad7a8717","token_type":"bearer"}
Copie el valor de su access_token, excluyendo las comillas (es decir, en mi ejemplo sería 1234567890654321|c3bd55c09fc5e561552ad7a8717), y vaya a la Configuración de su sitio de Discourse. Busque la configuración del sitio llamada facebook_app_access_token en la configuración de Onebox. Pegue el valor ‘access_token’ en este campo:
Haga clic en el 
… ¡y ya está!
Pegar una URL como https://www.instagram.com/p/CIRhYzFM7Lu/ en una publicación de su sitio debería dar como resultado un onebox encantador, ¡como este!
esperando que mi segunda aplicación sea…
), pero la principal diferencia es que oEmbed debe solicitarse después de que su aplicación haya pasado la Revisión de la aplicación.
