Knowledge base GetMyBot

Libreria media

Conserva foto e file per i messaggi del bot. Caricali nella libreria oppure ottieni un file_id tramite Telegram senza la libreria a pagamento.

In questa pagina

Se il bot invia spesso lo stesso programma del corso o la stessa foto, carica il file nella libreria media e riutilizzalo nei messaggi. Anche se lo carichi più volte, un file identico viene conservato in una sola copia. Questa funzione è inclusa nei piani a pagamento che offrono l'archiviazione dei file (image_storage).

Per Telegram esiste anche una soluzione senza libreria a pagamento: caricare il file tramite una chat di servizio e ottenere il suo identificatore Telegram file_id. Qui trovi entrambi i metodi e i loro limiti.

Storage proprio

Il file caricato viene salvato in GetMyBot e riceve un identificatore. Selezionalo nel blocco messaggio «Foto» o «File»; all'invio il bot userà il file corrispondente. Tramite API: caricamento POST /api/bots/{id}/media, lettura per l'anteprima GET /api/bots/{id}/media/{mediaID}.

Deduplicazione per contenuto

Se carichi di nuovo lo stesso file, GetMyBot trova la copia già salvata e restituisce l'identificatore precedente. I file identici non occupano spazio due volte. Il confronto usa l'impronta SHA-256 del file; la ricerca dei duplicati si chiama deduplicazione.

Accesso premium

La libreria media è una funzionalità premium (image_storage). È disponibile con un piano a pagamento che la include; senza un abbonamento attivo, il caricamento nella libreria restituisce l'errore 402 (pagamento richiesto). L'anteprima dei file già salvati funziona senza limitazioni.

La dimensione di un singolo file al caricamento nella libreria è limitata a 2 MiB.

Caricamento tramite chat Telegram (senza premium)

Se la libreria a pagamento non è disponibile, carica il file tramite una chat Telegram di servizio. GetMyBot restituirà il file_id, con cui il bot potrà inviare nuovamente il file. Non serve un abbonamento a pagamento; anche qui il limite è 2 MiB. Per chi usa l'API, l'operazione si chiama sink-upload: POST /api/bots/{id}/chats/{chatID}/sink-upload.

Cosa usare

EsigenzaMetodoRequisiti
Conservare e riutilizzare immagini identiche, vedere l'anteprima ed evitare duplicatiLibreria mediaPiano con image_storage, file fino a 2 MiB
Ottenere un file_id Telegram senza abbonamentosink-upload tramite chat di servizioChat Telegram, file fino a 2 MiB

Passo successivo