이 가이드가 처음 작성된 이후의 주요 업데이트 사항:
-
앱 리뷰(App Review)가 이제 필수입니다. 2021년 9월부터 Meta는 앱이 App Review를 통과하고 oEmbed Read 권한(2025년 4월 8일 이후 생성된 앱의 경우 Meta oEmbed Read로 명명됨)에 대한 승인을 받아야 합니다. 이를 수행하지 않으면 oEmbed API 호출이 실패합니다. 승인에 대한 팁은 Meta의 App Review 제출 가이드를 참조하십시오.
-
Instagram 원박스(onebox)가 올바르게 렌더링되지 않을 수 있습니다. 2025년 11월 3일부로 Meta는 Instagram oEmbed 응답에서
thumbnail_url,thumbnail_width,thumbnail_height,author_name필드를 제거했습니다. Discourse의 Instagram 원박스 코드는 현재 이러한 필드에 의존하고 있으며(lib/onebox/engine/instagram_onebox.rb), 이로 인해 깨지거나 빈 임베드가 생성될 수 있습니다. -
게시물(post) 및 IGTV URL만 지원됩니다. Discourse는 현재 Instagram
/p/(게시물) 및/tv/(IGTV) URL만 원박스로 처리합니다. 릴스(Reels)(/reel/) URL은 지원되지 않습니다. -
Facebook Developer Console UI가 크게 변경되었습니다. 아래 스크린샷은 2020년 12월에 촬영되었는데, 그 이후로 UI가 크게 달라졌습니다. 일반적인 단계는 유사하지만, 정확한 화면과 옵션은 다르게 보일 수 있습니다.
이미 Discourse 사이트에 연결된 Facebook 앱이 있다면 Facebook 앱에 oEmbed 추가 섹션으로 스크롤하십시오.
Facebook Developer 계정과 Facebook 앱이 없는 경우:
https://developers.facebook.com/으로 이동하십시오. 현재 로그인되어 있지 않으면 Facebook 계정에 로그인하도록 안내됩니다. 이전에 개발자 계정으로 전환하지 않은 경우 Facebook 계정을 개발자 계정으로 '전환’하라는 요청을 받을 수 있습니다. 전화번호를 추가하거나 기타 단계를 완료하여 Facebook에서 계정을 인증해야 할 수도 있습니다. 안내에 따라 Facebook이 요구하는 사항을 수행하기만 하면 됩니다.
Facebook Developer 계정이 있으면 Facebook Developer 홈 화면에서 'My Apps’를 클릭하십시오:
…그리고 'Create App’을 클릭하십시오:
앱 유형으로 'Something Else’를 선택하고 'Continue’를 클릭하십시오:
'App Display Name’과 'App Contact Email’을 입력하십시오. 약관 및 정책을 읽은 후 'Create App’을 클릭할 수 있습니다:
로봇인 경우: 볼 것이 없습니다. 삐 부루 부루. 
로봇이 아닌 경우: "I’m not a robot"을 클릭하고, 안내에 따라 'Submit’을 클릭하십시오.
축하합니다! 이제 Facebook 앱이 있습니다!
Facebook 앱에 oEmbed 추가:
제품 목록 하단으로 스크롤하여 'oEmbed’를 찾은 후 'Set Up’을 클릭하십시오:
oEmbed 제품 사용 방법에 동의하는 경우 확인란을 클릭한 후 'Confirm’을 클릭하십시오:
oEmbed 제품이 추가되었습니다. 'Settings’를 클릭하십시오:
'Display Name’과 'Contact Email’은 이미 입력되어 있을 것입니다. 'Privacy Policy’와 'Terms of Service’의 URL을 입력해야 합니다. 사용 가능한 옵션 목록에서 'Category’를 선택하십시오. 모든 것이 만족스러우면 'Save Changes’를 클릭하십시오:
화면 상단의 토글을 클릭하여 ‘In development’ 모드에서 ‘Live’ 모드로 변경하십시오:
'Switch Mode’를 클릭하십시오:
앱 리뷰에 앱 제출 (2021년부터 필수):
앱이 프로덕션 환경에서 oEmbed API에 액세스하려면 App Review에 제출하고 oEmbed Read 권한(2025년 4월 8일 이후 생성된 앱의 경우 Meta oEmbed Read)을 요청해야 합니다.
- 앱 대시보드에서 App Review → Permissions and Features로 이동하십시오.
- oEmbed Read(또는 Meta oEmbed Read)를 찾아 Request를 클릭하십시오.
- 요청 버튼이 활성화되기 전에 성공적인 테스트 API 호출을 먼저 수행해야 할 수 있습니다. 첫 번째 API 호출 후 최대 24시간이 소요될 수 있습니다.
- 제출할 때, Instagram 임베드가 포함된 Discourse 사이트의 URL을 제공하고, 사이트가 Discourse 포럼 소프트웨어를 사용하여 oEmbed API로 Instagram 게시물을 임베드한다고 설명하십시오.
상세한 제출 가이드는 Meta의 oEmbed 문서를 참조하십시오.
앱 액세스 토큰 생성:
이 모든 작업을 완료했으므로, 이제 Facebook의 App Access Tokens에 대한 지침을 따르면서 앱 토큰을 생성할 수 있습니다. ‘App ID’ 필드의 값과 ‘App Secret’ 필드의 값이 필요합니다. App Secret를 얻으려면 'Show’를 클릭하십시오. 재인증 등을 요청받을 수 있지만, 복사할 수 있는 긴 16진수 값이 생성되어야 합니다:
Facebook 문서에 따르면, 토큰을 생성하려면 이러한 값을 Facebook에 전송해야 합니다. curl 사용에 익숙합니까? 좋습니다! 다음을 제안합니다(위 화면에서 복사한 값으로 {your-app-id}와 {your-app-secret}를 대체하십시오).
curl -X GET "https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials"
대신, 두 값을 대체한 후 URL만 브라우저에 복사해도 작동할 수 있습니다:
https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials
Facebook은 다음과 같은 예시와 유사한 작은 JSON 조각으로 응답합니다:
{"access_token":"1234567890654321|c3bd55c09fc5e561552ad7a8717","token_type":"bearer"}
access_token의 값을 복사하십시오(따옴표 제외, 즉 제 예시에서는 1234567890654321|c3bd55c09fc5e561552ad7a8717), 그리고 Discourse 사이트의 설정으로 이동하십시오. Onebox 설정에서 facebook_app_access_token이라는 사이트 설정을 찾습니다. 이 필드에 ‘access_token’ 값을 붙여넣으십시오:
을 클릭하면 … 완료입니다!
https://www.instagram.com/p/CIRhYzFM7Lu/와 같은 URL을 사이트의 게시물에 붙여넣으면 다음과 같은 아름다운 원박스가 생성되어야 합니다:
두 번째 앱도 승인을 기다리고 있어요…
)에서와 같이 일부 페이지 레이아웃이 수정되었지만, 주요 차이점은 oEmbed가 앱이 App Review를 통과한 이후에 요청해야 한다는 점입니다.
