Telegram ботында фотосуреттен хабарлама жіберу
Telegram-дағы фото хабарлама-бұл пайдаланушы суретті қолтаңбамен бірге немесе онсыз жіберетін хабарлама форматы. Мұндай хабарламалар жеке чаттарда, топтарда және әсіресе көрнекі мазмұн ізбасарлардың назарын аударуға көмектесетін арналарда қолданылады. Telegram фотосуреттері мәтінмен, хэштегтермен, сілтемелермен және эмодзилермен бірге жүруі мүмкін, бұл оны визуалды мазмұнды маркетинг пен брендтерді жылжытудың ыңғайлы құралы етеді.
Telegram-да фотосурет қандай форматтарды қабылдайды және қандай шектеулер бар?
Жіберу кезінде фотосуретке қойылатын талаптар
Telegram Bot API суреттерді келесі форматтарда қабылдайды:
- JPEG / JPG — бот арқылы фотосуреттерді жіберудің негізгі және ұсынылған форматы.
- PNG-қолдау көрсетіледі, бірақ әрқашан ұсынылмайды, әсіресе үлкен өлшемдерде.
- WEBP-қолдау көрсетіледі, бірақ стикерлер үшін жиі қолданылады.
- GIF-әдіске қолдау көрсетілмейді және анимация жіберіледі.
Маңызды: бот жіберген фото форматтары Telegram "Фото"деп танитын нәрсемен шектеледі. Бұл дегеніміз, іс жүзінде бот суреттерді 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 мекен жайы бойынша мазмұн жарамды сурет болуы керек:
Мазмұн түрінің тақырыбы, мысалы: 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 немесе басқа қолдау көрсетілмейтін мазмұн түрін алады.
Қалай түзетуге болады:
– Сілтеме бойынша мазмұн түрінің тақырыбы image/jpeg, image/png және т. б. екенін тексеріңіз.
400 Қате Сұрау: фотосурет бос болмауы керек
Себебі:
- Photo өрісі жоқ немесе бос файл жіберілді.
Қалай түзетуге болады:
- Photo өрісі дұрыс орнатылғанына көз жеткізіңіз (URL, InputFile, немесе file_id) және сурет шынымен бар.
413 Сұрау Нысаны Тым Үлкен
Себебі:
- Файл шектен асады(sendPhoto үшін 20 МБ).
Қалай түзетуге болады:
- Сурет өлшемін кішірейтіңіз немесе фотосурет ретінде көрсету қажет болмаса, sendDocument (50 МБ дейін) пайдаланыңыз.
400 Қате Сұрау: чат табылмады
Себебі:
- Қате chat_id көрсетілген немесе бот чатқа кіре алмайды.
Қалай түзетуге болады:
– Көз жеткізіңіз:
- Бот топқа/арнаға қосылды.
- Дұрыс идентификатор көрсетілген (мысалы, @yourchannelname немесе сан).
- Бот хабарламаларды жіберуге құқылы.
403 Тыйым салынған: ботты пайдаланушы бұғаттаған
Себебі:
– Пайдаланушы немесе арна ботты бұғаттады.
Қалай түзетуге болады:
- Пайдаланушыдан боттың құлпын ашуды сұраудан басқа ештеңе жоқ.
"API Bot-MARKET" үшін техникалық ақпарат
Сұраныстарды жіберуге арналған хабарлама түрінің коды (messageType) "2" - ге тең
