Discord, 웹사이트 링크 미리보기에 Components V2 지원…버튼·이미지 갤러리 직접 구성 가능
Discord의 웹사이트 링크 미리보기에 Components V2를 이용한 새로운 형식인 Component Embed를 적용할 수 있게 됐어요.
지금까지 Discord에서 웹사이트 링크를 보내면 주로 Open Graph(OG) 메타데이터를 이용해 제목, 설명, 썸네일 등이 정해진 형태로 표시됐어요. Component Embed를 적용한 사이트는 웹페이지가 Discord에 제공하는 JSON을 통해 미리보기의 구성 자체를 지정할 수 있어요.
지원 구성 요소
지원되는 구성 요소를 이용하면 텍스트와 썸네일을 나란히 배치하거나, 여러 이미지를 Media Gallery로 표시하고, 구분선이나 강조 색상을 넣는 식으로 기존 링크 미리보기보다 자유롭게 만들 수 있어요.
버튼도 넣을 수 있습니다. 다만 여기서 사용할 수 있는 버튼은 URL을 여는 Link Button이에요. 봇 메시지의 일반 버튼처럼 custom_id를 이용해 애플리케이션에 상호작용을 전달하는 버튼은 링크 미리보기에서 사용할 수 없어요.
지원되는 주요 구성 요소는 Container, Section, Text Display, Thumbnail, Media Gallery, Separator, Action Row, Link Button이에요. 일반적인 Components V2에서 제공하는 선택 메뉴나 파일 첨부 등의 기능까지 모두 사용할 수 있는 것은 아니에요.
적용 방식
사이트 운영자는 Discord가 페이지를 불러올 때 확인할 수 있도록 discord:component-embed 형식의 데이터를 HTML에 포함하거나, 별도의 JSON 파일을 연결하는 방식으로 미리보기를 제공할 수 있어요.
즉 Discord 사용자가 별도로 설정하는 기능은 아니에요. 웹사이트 측에서 Component Embed를 지원해야 해당 사이트의 링크를 Discord에 붙여 넣었을 때 새로운 미리보기가 나타나요.
기존 Open Graph 정보도 함께 유지하는 것이 권장돼요. Discord 외의 서비스에서는 여전히 Open Graph를 사용하고, Discord에서도 Component Embed를 사용할 수 없는 경우 기존 미리보기 정보가 필요할 수 있어요.
지원 및 문서화 현황
Component Embed는 현재 Discord에서 실제 사용할 수 있는 기능이에요. 웹사이트에 해당 기능을 구현하고 Discord에 링크를 공유했을 때 새로운 형식의 미리보기가 정상적으로 표시되는 것도 직접 확인됐지만, 현재 Discord의 공개 개발자 문서 인덱스에는 Link Previews / Component Embeds 문서가 정식 항목으로 노출되어 있지 않아요.
Discord API 문서 저장소의 관련 문서 작업과 이를 사용한 실제 구현은 확인되고 있으므로 기능 자체는 사용할 수 있는 상태로 보이지만, 세부 규격이나 제한은 이후 변경될 수 있어요.