Повідомлення з фото в Telegram - це формат повідомлення, в якому користувач надсилає зображення разом із підписом або без нього. Такі повідомлення використовуються в особистих чатах, групах і особливо в каналах, де візуальний контент допомагає привернути увагу передплатників. Фото в Telegram може супроводжуватися текстом, хештегами, посиланнями і емодзі, що робить його зручним інструментом для візуального контент-маркетингу і просування брендів.
Які формати приймає фото в Telegram і які бувають обмеження?
Вимоги до фото при відправці
Telegram bot API приймає зображення в наступних формат:
- JPEG / JPG - основний і рекомендований формат для відправки фото через бота.
- PNG - підтримується, але не завжди рекомендується, особливо при великих розмірах.
- WEBP - підтримується, але частіше використовується для стікерів.
- GIF — не підтримується у методі і буде відправлена анімація.
Важливо: формати фото, що відправляються ботом, фактично обмежуються тим, що Telegram розпізнає як"photo". Це означає, що на практиці бот повинен надсилати зображення у JPEG, щоб Telegram коректно інтерпретував їх як фото (а не як файл).
Має обмеження за розміром в 20 МБ.
Параметри і настройки у повідомлення з фото
Вимоги до посилання на фото
Пряме посилання на зображення - повинна вести безпосередньо до файлу, а не до веб-сторінці.
Приклад: https://example.com/images/photo.jpg ✅
Неправильно: https://example.com/gallery/photo?id=123 ❌ (це сторінка, а не файл)
Формат зображення - повинен бути сумісним (зазвичай JPG, JPEG, PNG, WEBP):
URL повинен закінчуватися на .jpg, .jpeg, .png, .webp і т. п.
Приклад: https://cdn.domain.com/photo123.jpg ✅
Файл повинен бути публічно доступним:
Без авторизації, токенів або cookies.
Telegram (сервер) повинен мати можливість завантажити його безпосередньо за цією URL-адресою.
Контент по URL повинен бути валідним зображенням:
Заголовок Content-Type повинен бути, наприклад: image/jpeg, image/png.
Як отримати код зображення для надсилання через file_id
Швидко отримати код картинки можна двома способами:
Вставити посилання на картинку, а потім натиснути кнопку "тестувати"
Включити режим налагодження в подію невідома команда / помилка і отправіпь боту фото, в результаті код картинки буде доступний в розділі "Test data"
Популярні помилки при відправці фото в боті Telegram
400 неправильний запит: вказано неправильний ідентифікатор файлу / HTTP URL
Причина:
- Невірний формат photo (наприклад, URL не веде до зображення або file_id недійсний).
Як виправити:
- Переконайтеся, що:
- URL закінчується на .jpg, .png і веде до зображення, а не HTML-сторінці.
- file_id актуальний для цього бота (якщо використовується).
- Заголовок за URL-Content-Type: image/jpeg або image / png.
📌 Приклад неправильного: "https://example.com/page?id=123"
400 неправильний запит: неправильний тип вмісту веб-сторінки
Причина:
- За URL Telegram очікує зображення, а отримує HTML або інший непідтримуваний тип контенту.
Як виправити:
- Перевір, щоб заголовок Content-Type за посиланням був image/jpeg, image / png і т. п.
400 неправильний запит: фотографія повинна бути не порожньою
Причина:
- Відсутнє поле photo або переданий порожній файл.
Як виправити:
- Переконайся, що поле photo задано правильно (URL, InputFile, або file_id) і зображення дійсно існує.
413 Об'єкт запиту занадто великий
Причина:
- Файл перевищує ліміт (20 МБ для sendPhoto).
Як виправити:
- Зменши розмір зображення або використовуй sendDocument (до 50 МБ), якщо не потрібно відображення як фото.
400 неправильний запит: чат не знайдено
Причина:
- Вказано неправильний chat_id, або бот не має доступу до чату.
Як виправити:
- Переконайся, що:
- Бот додано до групи / каналу.
- Вказано правильний ID (наприклад, @yourchannelname або число).
- Бот має права на відправку повідомлень.
403 заборонено: бот був заблокований Користувачем
Причина:
- Користувач або канал заблокував бота.
Як виправити:
- Ніяк, крім як попросити користувача розблокувавши бот.
Технічна інформація для»API Bot-MARKET"
Код типу повідомлення для відправки запитів (messageType) дорівнює "2"
