미디어 라이브러리

봇이 이미지와 파일을 전송하려면 어딘가에 저장해야 합니다. GetMyBot에는 자체 미디어 라이브러리가 있습니다: 파일을 한 번 업로드하면 플랫폼이 메시지에 자동으로 삽입합니다. 라이브러리는 동일한 파일을 중복 제거하며 premium 기능에 속합니다. 기본 시나리오에는 Telegram 채팅을 통한 무료 업로드가 있습니다.

자체 저장소

업로드된 파일은 플랫폼 저장소에 저장되고 미디어 식별자를 받습니다. 메시지 블록 '사진' 또는 '파일'에서 이 식별자를 참조할 수 있습니다 — 전송 시 플랫폼이 자동으로 필요한 파일을 삽입합니다. 업로드: POST /api/bots/{id}/media, 미리보기 읽기: GET /api/bots/{id}/media/{mediaID}.

콘텐츠 기반 중복 제거

각 파일은 sha256 해시로 식별됩니다. 동일한 파일을 다시 업로드하면 플랫폼이 중복을 생성하지 않고 이미 저장된 객체의 링크를 반환합니다. 동일한 이미지가 두 번 공간을 차지하지 않으며 식별자는 안정적입니다.

Premium 접근

미디어 라이브러리는 premium 기능 (image_storage)입니다. 이를 포함하는 유료 요금제에서 사용 가능하며, 활성 구독 없이 라이브러리에 업로드하면 402 (결제 필요) 오류가 반환됩니다. 이미 저장된 파일의 미리보기는 제한 없이 작동합니다.

라이브러리에 업로드 시 파일 하나의 크기는 2 MiB로 제한됩니다.

Telegram 채팅을 통한 업로드 (premium 없이)

premium 라이브러리를 사용할 수 없는 경우 무료 방법이 있습니다: sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. 파일이 지정된 Telegram 채팅을 통해 전송되고, 응답으로 봇 메시지에서 사용할 수 있는 Telegram file_id가 반환됩니다. 이 방법은 premium 없이 모든 사용자에게 제공됩니다. 크기 제한은 동일한 2 MiB입니다.

무엇을 사용할지

  • 동일한 이미지를 자주 재사용하고 중복 제거와 미리보기를 원한다면 — 미디어 라이브러리 (premium).
  • 구독 없이 빠르게 file_id를 얻어야 한다면 — 서비스 채팅을 통한 sink-upload.

다음 단계