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 ?
| Besoin | Méthode | Conditions |
|---|---|---|
| Conserver et réutiliser des images, prévisualiser, éviter les doublons | Médiathèque | Forfait avec image_storage, fichier ≤ 2 Mio |
Obtenir un file_id Telegram sans abonnement | sink-upload par un chat de service | Chat Telegram, fichier ≤ 2 Mio |
Pour aller plus loin
- Messages et boutons : blocs Photo et Fichier.
- Paiements et solde : forfaits et fonctions premium.
- Importer depuis sambot : médias d’une archive.
- Chats et opérateurs : chats de service pour sink-upload.