Blog et base de connaissances du service
Envoyer un message avec une photo dans le bot Telegram
Publié: 22.07.2025

Quels formats prend une photo dans Telegram et quelles sont les restrictions?

Exigences de photo lors de l'expédition

Telegram bot API accepte les images dans les éléments suivants formats:

  1. JPEG / JPG - principal et recommandé format pour envoyer une photo via un bot.
  2. PNG - pris en charge, mais pas toujours recommandé, surtout pour les grandes tailles.
  3. WEBP - pris en charge, mais plus souvent utilisé pour les autocollants.
  4. GIFnon pris en charge dans la méthode et l'animation sera envoyée.

Important: les formats de photo envoyés par le bot sont en fait limités ce que Telegram reconnaît comme "photo". Cela signifie qu'en pratique, le bot doit envoyer des images en JPEG pour que Telegram les interprète correctement comme une photo (pas comme un fichier).

A une limite de taille de 20 MO.

Paramètres et paramètres du message photo

Exigences de lien photo

Lien direct vers l'image - devrait conduire directement au fichier, pas à la page Web.

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

Faux: https://example.com/gallery/photo?id=123 ❌ (c'est une page, pas un fichier)

Exigences de lien photo-1

Format d'image - doit être compatible (généralement JPG, JPEG, PNG, WEBP):

L'URL doit se terminer par .jpg, .jpeg, .png, .webp, etc.

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

Le fichier doit être accessible au public:

Sans autorisation, jetons ou cookies.

Telegram (serveur) devrait pouvoir le télécharger directement sur cette URL.

Le contenu de l'URL doit être une image valide:

En-tête Content-Type devrait être, par exemple: image/jpeg, image/png.

Comment obtenir le code de l'image à envoyer par file_id

Vous pouvez obtenir rapidement le code de l'image de deux façons:

Collez le lien vers l'image, puis cliquez sur le bouton “Tester”

Comment obtenir le code de l'image à envoyer par file_id-1

Activer le mode de débogage dans l'événement commande/erreur inconnue et envoyer une photo au bot, en conséquence, le code de l'image sera disponible dans la section "données de Test"


Comment obtenir le code de l'image à envoyer par file_id-2


Comment obtenir le code de l'image à envoyer par file_id-3

Erreurs populaires lors de l'envoi d'une photo dans le bot Telegram

400 Mauvaise requête: identifiant de fichier incorrect / URL HTTP spécifié

Raison:

- Format photo incorrect (par exemple, l'URL ne mène pas à l'image ou file_id est invalide).

Comment réparer:

- Assurez-vous que:

  1. L'URL se termine par .jpg, .png et mène à image pas une page HTML.
  2. file_id est pertinent pour ce bot (si utilisé).
  3. En-tête par URL-Content-Type: image / jpeg ou image / png.

📌 Exemple de mauvais: "https://example.com/page?id=123"

400 Mauvaise requête: mauvais type de contenu de la page Web

Raison:

- Sur l'URL Telegram attend une image, et reçoit HTML ou un autre type de contenu non pris en charge.

Comment réparer:

- Vérifiez que l'en-tête Content-Type sur le lien est image / jpeg, image/png, etc.

400 Mauvaise demande: la photo doit être non vide

Raison:

- Champ photo manquant ou fichier vide transféré.

Comment réparer:

- Assurez-vous que le champ photo est correctement défini (URL, InputFile, ou file_id) et que l'image existe réellement.

413 Demander Une Entité Trop Grande

Raison:

- Le fichier dépasse la limite (20 MO pour sendPhoto).

Comment réparer:

- Réduisez la taille de l'image ou utilisez sendDocument (jusqu'à 50 MO) si vous n'avez pas besoin de l'afficher en tant que photo.

400 Mauvaise requête: chat introuvable

Raison:

- Le chat_id est incorrect ou le bot n'a pas accès au chat.

Comment réparer:

- Assure-toi que:

  1. Bot Ajouté au groupe / canal.
  2. L'ID correct est spécifié (par exemple, @yourchannelname ou nombre).
  3. Le bot a le droit d'envoyer des messages.


403 Interdit: le bot a été bloqué par l'utilisateur

Raison:

- L'utilisateur ou le canal a bloqué le bot.

Comment réparer:

- Rien d'autre que de demander à l'utilisateur déverrouiller robot.

Informations techniques pour " API BOT-MARKET»

Le code de type de message pour envoyer des requêtes (messageType) est “2”

Comments
to write comments
Comment list is empty. Start now!