Biblioteca de medios

Para que el bot envíe imágenes y archivos, hace falta almacenarlos en algún lugar. GetMyBot tiene su propia biblioteca de medios: subes el archivo una vez y la plataforma lo inserta automáticamente en los mensajes. La biblioteca deduplica los archivos idénticos y es una función premium; para el caso básico hay carga gratuita a través del chat de Telegram.

Almacenamiento propio

El archivo subido se guarda en el almacenamiento de la plataforma y recibe un identificador de media. En el bloque de mensaje «Foto» o «Archivo» se puede referenciar ese identificador — al enviar, la plataforma insertará el archivo adecuado. Carga: POST /api/bots/{id}/media, lectura para previsualización: GET /api/bots/{id}/media/{mediaID}.

Deduplicación por contenido

Cada archivo se identifica por el hash sha256 de su contenido. Si subes el mismo archivo de nuevo, la plataforma no crea un duplicado, sino que devuelve un enlace al objeto ya guardado. Así las imágenes idénticas no ocupan espacio dos veces, y el identificador permanece estable.

Acceso premium

La biblioteca de medios es una función premium (image_storage). Está disponible en un plan de pago que la incluye; sin una suscripción activa, la carga en la biblioteca devuelve el error 402 (pago requerido). La previsualización de archivos ya guardados funciona sin restricciones.

El tamaño de un archivo al cargarlo en la biblioteca está limitado a 2 MiB.

Carga a través del chat de Telegram (sin premium)

Si la biblioteca premium no está disponible, existe una vía gratuita: sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. El archivo se envía a través del chat de Telegram indicado y la respuesta devuelve el file_id de Telegram, que se puede usar en los mensajes del bot. Este método está disponible para todos sin requisito premium; el límite de tamaño también es de 2 MiB.

Qué usar

  • Si reutilizas habitualmente las mismas imágenes y quieres deduplicación y previsualización — biblioteca de medios (premium).
  • Si necesitas obtener un file_id rápidamente sin suscripción — sink-upload a través del chat de servicio.

Qué sigue