Base de connaissances GetMyBot

Médiathèque

Conserver photos et fichiers pour les messages du bot, ou obtenir un file_id Telegram sans médiathèque payante.

Sur cette page

Si le bot envoie souvent le même programme de cours ou la même photo, téléversez le fichier dans la médiathèque et réutilisez-le. Un fichier identique n’y est conservé qu’une fois, même après plusieurs téléversements. Cette fonction est comprise dans les forfaits payants disposant du stockage de fichiers (image_storage).

Pour Telegram, il existe aussi une méthode sans médiathèque payante : téléverser le fichier par un chat de service et obtenir son identifiant Telegram file_id. Voici les deux méthodes et leurs limites.

Stockage propre

Un fichier téléversé est conservé dans GetMyBot et reçoit un identifiant. Sélectionnez-le dans le bloc de message Photo ou Fichier ; le bot le joindra à l’envoi. Par API : POST /api/bots/{id}/media pour téléverser et GET /api/bots/{id}/media/{mediaID} pour l’aperçu.

Déduplication par contenu

Si vous téléversez à nouveau le même fichier, GetMyBot retrouve la copie existante et renvoie son identifiant. Il n’occupe pas deux fois l’espace. La comparaison utilise l’empreinte SHA-256 ; ce traitement s’appelle déduplication.

Accès premium

La médiathèque est une fonction premium (image_storage), disponible avec un forfait payant qui l’inclut. Sans abonnement actif, le téléversement renvoie 402 Payment Required. L’aperçu des fichiers déjà enregistrés reste accessible.

Un fichier téléversé dans la médiathèque est limité à 2 Mio.

Téléverser par un chat Telegram sans abonnement payant

Si la médiathèque n’est pas disponible, envoyez le fichier dans un chat Telegram de service. GetMyBot renvoie un file_id que le bot peut réutiliser pour l’envoyer. Cette méthode est gratuite ; le fichier est aussi limité à 2 Mio. Pour les développeurs, l’opération sink-upload est POST /api/bots/{id}/chats/{chatID}/sink-upload.

Quelle méthode choisir ?

BesoinMéthodeConditions
Conserver et réutiliser des images, prévisualiser, éviter les doublonsMédiathèqueForfait avec image_storage, fichier ≤ 2 Mio
Obtenir un file_id Telegram sans abonnementsink-upload par un chat de serviceChat Telegram, fichier ≤ 2 Mio

Pour aller plus loin