Libreria media

Per fare in modo che il bot invii immagini e file, devono essere conservati da qualche parte. GetMyBot ha una libreria media propria: carichi il file una volta sola e la piattaforma lo inserisce automaticamente nei messaggi. La libreria deduplica i file identici ed è una funzionalità premium; per lo scenario base esiste il caricamento gratuito tramite chat Telegram.

Storage proprio

Il file caricato viene salvato nello storage della piattaforma e riceve un identificatore media. Nel blocco messaggio «Foto» o «File» puoi fare riferimento a questo identificatore — all'invio la piattaforma inserirà automaticamente il file giusto. Caricamento: POST /api/bots/{id}/media, lettura per anteprima: GET /api/bots/{id}/media/{mediaID}.

Deduplicazione per contenuto

Ogni file è identificato dall'hash sha256 del contenuto. Se carichi lo stesso file di nuovo, la piattaforma non crea un duplicato ma restituisce il link all'oggetto già salvato. Così le immagini identiche non occupano spazio due volte e l'identificatore rimane stabile.

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 premium non è disponibile, esiste un percorso gratuito: sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. Il file viene inviato tramite la chat Telegram indicata e in risposta viene restituito il file_id Telegram, che può essere usato nei messaggi del bot. Questo metodo è disponibile a tutti senza requisiti premium; il limite di dimensione è sempre 2 MiB.

Cosa usare

  • Riutilizzi regolarmente le stesse immagini e vuoi deduplicazione e anteprima — libreria media (premium).
  • Hai bisogno di ottenere rapidamente un file_id senza abbonamento — sink-upload tramite una chat di servizio.

Passo successivo