Biblioteca de archivos
Guarda fotos y archivos para reutilizarlos en los mensajes del bot, o consigue un identificador de archivo de Telegram sin la biblioteca de pago.
En esta página
Si tu bot envía con frecuencia el mismo programa de un curso o la misma foto, súbelo a la biblioteca de archivos para volver a usarlo en los mensajes. Un archivo idéntico se guarda una sola vez, aunque lo subas varias veces. La biblioteca está incluida en los planes de pago que ofrecen almacenamiento de archivos (image_storage).
También puedes enviar un archivo por Telegram sin la biblioteca de pago: súbelo mediante un chat de servicio para obtener su identificador de Telegram, file_id. Aquí se explican ambas opciones.
Almacenamiento de GetMyBot
Cada archivo que subes se guarda en GetMyBot y recibe un identificador. Selecciónalo en un bloque de mensaje de tipo Foto o Archivo y el bot lo adjuntará al enviar el mensaje. Si usas la API, la carga es POST /api/bots/{id}/media y la vista previa es GET /api/bots/{id}/media/{mediaID}.
Evitar archivos duplicados
Si vuelves a subir exactamente el mismo archivo, GetMyBot encuentra la copia existente y devuelve el mismo identificador. Así no ocupa espacio dos veces. Para comparar los archivos usa una huella digital llamada SHA-256; esta forma de evitar duplicados se conoce como deduplicación.
Plan de pago
La biblioteca es una función de pago (image_storage). Está disponible con un plan que la incluya. Sin una suscripción activa, intentar subir un archivo devuelve el error 402 (pago requerido). Puedes seguir viendo las vistas previas de archivos que ya estaban guardados.
Cada archivo que subas a la biblioteca puede ocupar como máximo 2 MiB.
Subir un archivo mediante Telegram sin la biblioteca
Si no tienes acceso a la biblioteca de pago, puedes subir el archivo mediante un chat de servicio de Telegram. GetMyBot devolverá un file_id que el bot puede utilizar para volver a enviar ese archivo. No requiere una suscripción de pago y también admite archivos de hasta 2 MiB. Para desarrolladores, la operación se llama sink-upload: POST /api/bots/{id}/chats/{chatID}/sink-upload.
Qué opción elegir
| Necesitas | Opción | Requisitos |
|---|---|---|
| Guardar y reutilizar imágenes, ver una vista previa y evitar duplicados | Biblioteca de archivos | Plan con image_storage, archivos de hasta 2 MiB |
Obtener un file_id de Telegram sin suscripción | sink-upload mediante un chat de servicio | Chat de Telegram, archivos de hasta 2 MiB |
Siguientes pasos
- Mensajes y botones: bloques Foto y Archivo.
- Pagos y saldo: planes y funciones de pago.
- Importar desde sambot: trasladar imágenes y archivos.
- Chats y operadores: chats de servicio para
sink-upload.