¿Qué formatos acepta la foto en Telegram y Cuáles son las restricciones?

Telegram bot API toma imágenes en los siguientes formatos:

1. JPEG / JPG - principal y recomendable formato para enviar una foto a través de un bot.
2. PNG - apoyado, pero no siempre recomendado, especialmente en tamaños más grandes.
3. WEBP - compatible, pero más utilizado para pegatinas.
4. GIF — no soportado en el método y se enviará la animación.

Es importante: los formatos de foto enviados por el bot están realmente limitados lo que Telegram reconoce como"photo". Esto significa que, en la práctica, el bot debe enviar imágenes en JPEG para que Telegram los interprete correctamente como una foto (y no como un archivo).

Tiene un límite de Tamaño de 20 MB.

Enlace directo a la imagen - debe conducir directamente al archivo, no a la página web.

Ejemplo: https://example.com/images/photo.jpg ✅

Incorrecto: https://example.com/gallery/photo?id=123 ❌ (es una página, no un archivo)

Formato de imagen - debe ser compatible (generalmente JPG, JPEG, PNG, WEBP):

La URL debe terminar en .jpg, .jpeg, .png, .webp, etc.

Ejemplo: https://cdn.domain.com/photo123.jpg ✅

El archivo debe estar disponible públicamente:

Sin autorización, tokens o cookies.

Telegram (servidor) debería poder descargarlo directamente en esta URL.

El contenido de la URL debe ser una imagen válida:

Título Content-Type debe ser, por ejemplo: image/jpeg, image/png.

Puede obtener rápidamente el código de imagen de dos maneras:

Inserte el enlace a la imagen y luego haga clic en el botón "Probar"

Active el modo de depuración en el evento comando/error desconocido y envíe una foto al bot, como resultado, el código de la imagen estará disponible en la sección "datos de prueba"

Razón:

- Formato de foto incorrecto (por ejemplo, la URL no conduce a la imagen o file_id no es válido).

Cómo arreglar:

- Asegúrese de que:

1. La URL termina en .jpg, .png y conduce a imagen, no una página HTML.
2. file_id es relevante para este bot (si se usa).
3. Encabezado por URL-Content-Type: image / jpeg o image / png.

📌 Ejemplo incorrecto: "https://example.com/page?id=123"

Razón:

- Por URL Telegram espera una imagen, y recibe HTML u otro tipo de contenido no compatible.

Cómo arreglar:

- Compruebe que el encabezado Content-Type del enlace sea image / jpeg, image / png, etc.

Razón:

- Falta un campo de foto o se transfiere un archivo vacío.

Cómo arreglar:

- Asegúrese de que el campo photo se establece correctamente (URL, InputFile, o file_id)y la imagen existe.

Razón:

- El archivo excede el límite (20 MB para sendPhoto).

Cómo arreglar:

- Reduzca el Tamaño de la imagen o use sendDocument (hasta 50 MB) si no necesita mostrarse como una foto.

Razón:

- Se especifica el chat_id incorrecto, o el bot no tiene acceso al chat.

Cómo arreglar:

- Asegúrate de que:

1. Bot agregado al grupo / canal.
2. Se proporciona el ID correcto (por ejemplo, @yourchannelname o un número).
3. El bot tiene derechos para enviar mensajes.

Razón:

- Usuario o canal bloqueado bot.

Cómo arreglar:

- Nada más que pedir al usuario desbloquear bota.

El código de tipo de mensaje para enviar solicitudes (messageType) es "2"