Wiadomość ze zdjęciem w Telegramie - jest to format wiadomości, w którym użytkownik wysyła obraz wraz z podpisem lub bez. Takie wiadomości są używane w prywatnych czatach, grupach, a zwłaszcza w kanałach, w których treści wizualne pomagają przyciągnąć uwagę obserwujących. Zdjęciu w Telegramie może towarzyszyć tekst, hashtagi, linki i emotikony, co czyni go przydatnym narzędziem do wizualnego marketingu treści i promocji marki.
Jakie formaty akceptuje zdjęcie w Telegramie i jakie są ograniczenia?
Wymagania dotyczące zdjęcia podczas wysyłania
Telegram bot API akceptuje obrazy w następujących format:
- JPEG / JPG - podstawowe i wskazany format wysyłania zdjęć przez bota.
- PNG - obsługiwane, ale nie zawsze zalecane, szczególnie przy większych rozmiarach.
- WEBP - obsługiwane, ale częściej używane do naklejek.
- GIF — nie obsługiwane w metodzie i zostanie wysłana animacja.
Ważny: formaty zdjęć wysyłane przez bota są w rzeczywistości ograniczone tym, co Telegram rozpoznaje jako"zdjęcie". Oznacza to, że w praktyce Bot musi wysyłać obrazy w JPEG, aby Telegram poprawnie zinterpretował je jako zdjęcie(a nie Plik).
Ma limit rozmiaru 20 MB.
Opcje i ustawienia wiadomości ze zdjęciem
Wymagania dotyczące linku do zdjęcia
Bezpośredni link do obrazu - powinien prowadzić bezpośrednio do pliku, a nie do strony internetowej.
Przykład: https://example.com/images/photo.jpg ✅
Źle: https://example.com/gallery/photo?id=123 ❌ (to jest strona, a nie Plik)
Format obrazu - musi być kompatybilny (Zwykle JPG, JPEG, PNG, WEBP) :
Adres URL powinien kończyć się na .jpg, .jpeg, .png, .webp itp.
Przykład: https://cdn.domain.com/photo123.jpg ✅
Plik musi być publicznie dostępny:
Bez autoryzacji, tokenów lub plików cookie.
Telegram (serwer) powinien być w stanie go pobrać na wprost POD TYM adresem URL.
Treść według adresu URL powinna być prawidłowym obrazem:
Nagłówek Content-Type powinien być na przykład: image/jpeg, image/png.
Jak uzyskać kod obrazu do wysłania przez file_id
Możesz szybko uzyskać kod obrazu na dwa sposoby:
Wklej link do zdjęcia, a następnie kliknij przycisk "Testuj"
Włącz tryb debugowania w zdarzeniu nieznane polecenie / błąd i wyślij zdjęcie do bota, w wyniku czego Kod obrazu będzie dostępny w sekcji "Dane testowe"
Popularne błędy podczas wysyłania zdjęć w bocie Telegram
400 złe żądanie: podano niewłaściwy Identyfikator pliku/adres URL HTTP
Przyczyna:
- Nieprawidłowy format photo (np. adres URL nie prowadzi do obrazu lub file_id jest nieprawidłowy).
Jak naprawić:
- Upewnij się, że:
- Adres URL kończy się na .jpg, .png i prowadzi do obraz, a nie strony HTML.
- file_id jest odpowiedni dla tego bota (jeśli jest używany).
- Tytuł URL-Content-Type: image / jpeg lub image / png.
📌 Przykład złego: "https://example.com/page?id=123"
400 złe żądanie: niewłaściwy typ zawartości strony internetowej
Przyczyna:
- W adresie URL Telegram oczekuje obrazu i odbiera HTML lub inny nieobsługiwany typ zawartości.
Jak naprawić:
- Sprawdź, czy nagłówek Content-Type w linku to image / jpeg, image / png itp.
400 zła Prośba: zdjęcie musi być niepuste
Przyczyna:
- Brak pola photo lub przesłany pusty plik.
Jak naprawić:
- Upewnij się, że pole photo jest ustawione poprawnie (URL, InputFile, lub file_id), a obraz rzeczywiście istnieje.
413 Żądanie Podmiotu Za Duże
Przyczyna:
- Plik przekracza limit (20 MB dla sendPhoto).
Jak naprawić:
- Zmniejsz rozmiar obrazu lub użyj sendDocument (do 50 MB), jeśli nie potrzebujesz wyświetlania jako Zdjęcia.
400 błąd: nie znaleziono czatu
Przyczyna:
- Podano nieprawidłowy chat_id lub bot nie ma dostępu do czatu.
Jak naprawić:
- Upewnij się, że:
- Bot został dodany do grupy / kanału.
- Podany jest poprawny identyfikator (np. @yourchannelname lub liczba).
- Bot ma prawa do wysyłania wiadomości.
403 Forbidden: bot został zablokowany przez użytkownika
Przyczyna:
- Użytkownik lub kanał zablokował bota.
Jak naprawić:
- Nic innego, jak tylko poprosić użytkownika odblokować bot.
Informacje techniczne dla"API BOT-MARKET"
Kod typu wiadomości do wysyłania żądań (messageType) to "2"
