Biblioteca de mídia

Para que o bot envie imagens e arquivos, eles precisam ser armazenados em algum lugar. GetMyBot possui uma biblioteca de mídia própria: você faz o upload do arquivo uma única vez, e a plataforma o insere automaticamente nas mensagens. A biblioteca deduplica arquivos idênticos e é uma funcionalidade premium; para o cenário básico, há upload gratuito via chat Telegram.

Armazenamento próprio

O arquivo enviado é salvo no armazenamento da plataforma e recebe um identificador de mídia. No bloco de mensagem "Foto" ou "Arquivo" é possível referenciar esse identificador — no envio, a plataforma insere automaticamente o arquivo correto. Upload: POST /api/bots/{id}/media, leitura para pré-visualização: GET /api/bots/{id}/media/{mediaID}.

Deduplicação por conteúdo

Cada arquivo é identificado pelo hash sha256 do conteúdo. Se você fizer upload do mesmo arquivo novamente, a plataforma não criará um duplicado, mas retornará o link para o objeto já salvo. Assim, imagens idênticas não ocupam espaço duas vezes, e o identificador permanece estável.

Acesso premium

A biblioteca de mídia é uma funcionalidade premium (image_storage). Está disponível no plano pago que a inclui; sem assinatura ativa, o upload para a biblioteca retorna erro 402 (pagamento necessário). A pré-visualização de arquivos já salvos funciona sem restrições.

O tamanho de um único arquivo no upload para a biblioteca é limitado a 2 MiB.

Upload via chat Telegram (sem premium)

Se a biblioteca premium não estiver disponível, existe um caminho gratuito: sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. O arquivo é enviado pelo chat Telegram especificado, e em resposta é retornado o file_id do Telegram, que pode ser usado nas mensagens do bot. Esse método está disponível a todos sem restrição premium; o limite de tamanho é o mesmo — 2 MiB.

O que usar

  • Se você reutiliza as mesmas imagens regularmente e quer deduplicação e pré-visualização — biblioteca de mídia (premium).
  • Se precisa obter um file_id rapidamente sem assinatura — sink-upload via chat de serviço.

Próximos passos