Bibliothèque de médias

Pour que le bot envoie des images et des fichiers, il faut les stocker quelque part. GetMyBot dispose d'une bibliothèque de médias propre : vous téléversez un fichier une seule fois, et la plateforme l'insère automatiquement dans les messages. La bibliothèque déduplique les fichiers identiques et relève des fonctionnalités premium ; pour le cas d'usage de base, il existe un téléversement gratuit via un chat Telegram.

Stockage propre

Un fichier téléversé est enregistré dans le stockage de la plateforme et reçoit un identifiant de média. Dans le bloc message « Photo » ou « Fichier », on peut référencer cet identifiant — à l'envoi, la plateforme insère automatiquement le fichier approprié. Téléversement : POST /api/bots/{id}/media, lecture pour prévisualisation : GET /api/bots/{id}/media/{mediaID}.

Déduplication par contenu

Chaque fichier est identifié par son hachage sha256 de contenu. Si vous téléversez à nouveau le même fichier, la plateforme ne crée pas de doublon, mais renvoie un lien vers l'objet déjà enregistré. Ainsi, les images identiques n'occupent pas deux fois de l'espace, et l'identifiant reste stable.

Accès premium

La bibliothèque de médias est une fonctionnalité premium (image_storage). Elle est disponible sur un forfait payant qui l'inclut ; sans abonnement actif, le téléversement dans la bibliothèque renvoie une erreur 402 (paiement requis). La prévisualisation des fichiers déjà enregistrés fonctionne sans restriction.

La taille d'un seul fichier lors du téléversement dans la bibliothèque est limitée à 2 Mio.

Téléversement via un chat Telegram (sans premium)

Si la bibliothèque premium n'est pas disponible, il existe un chemin gratuit : sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. Le fichier est envoyé via le chat Telegram indiqué, et la réponse renvoie un file_id Telegram utilisable dans les messages du bot. Cette méthode est accessible à tous sans accès premium ; la limite de taille est également 2 Mio.

Que choisir

  • Vous réutilisez régulièrement les mêmes images et souhaitez la déduplication et la prévisualisation — bibliothèque de médias (premium).
  • Vous avez besoin d'obtenir rapidement un file_id sans abonnement — sink-upload via un chat de service.

Pour aller plus loin