בלוג ובסיס הידע של השירות
שליחת הודעה עם תמונה בבוט מברק
פורסם ב: 22.07.2025

אילו פורמטים מקבלת תמונה בטלגרם ומה המגבלות?

דרישות תמונה בעת משלוח

ממשק ה-api של Telegram bot מקבל תמונות ב פורמטים:

  1. JPEG / JPG - עיקרי ו מוּמלָץ פורמט לשליחת תמונה באמצעות בוט.
  2. PNG - נתמך, אך לא תמיד מומלץ, במיוחד בגדלים גדולים יותר.
  3. WEBP - נתמך אך משמש לעתים קרובות יותר למדבקות.
  4. GIFלא נתמך בשיטה ותישלח אנימציה.

חשוב: פורמטים של תמונות שנשלחו על ידי הבוט מוגבלים למעשה על ידי מה שטלגרם מזהה כ - "photo". המשמעות היא שבפועל הבוט צריך לשלוח תמונות JPEG, כדי שטלגרם יפרש אותם בצורה נכונה כתמונה (ולא כקובץ).

יש לו מגבלת גודל של 20 מגהבייט.

אפשרויות והגדרות יש הודעה עם תמונה

תמונה קישור דרישות

קישור ישיר לתמונה - צריך להוביל ישירות לקובץ ולא לדף אינטרנט.

דוגמה: https://example.com/images/photo.jpg ✅

לא נכון: https://example.com/gallery/photo?id=123 ❌ (זה דף, לא קובץ)

תמונה קישור דרישות-1

פורמט תמונה - חייב להיות תואם (בדרך כלל JPG, JPEG, PNG, WEBP):

כתובת האתר צריכה להסתיים ב -.jpg, .jpeg, .png, .webp וכדומה

דוגמה: https://cdn.domain.com/photo123.jpg ✅

הקובץ צריך להיות נגיש לציבור:

ללא הרשאה, אסימונים או עוגיות.

טלגרם (שרת) אמור להיות מסוגל להוריד אותו ישירות לפי כתובת אתר זו.

תוכן לפי כתובת אתר חייב להיות תמונה תקפה:

כותרת Content-Type צריך להיות, למשל: image/jpeg, image/png.

כיצד להשיג קוד תמונה שישלח באמצעות file_id

ישנן שתי דרכים להשיג במהירות את קוד התמונה:

הכנס קישור לתמונה ואז לחץ על כפתור "בדוק"

כיצד להשיג קוד תמונה שישלח באמצעות file_id-1

הפעל מצב ניפוי באגים באירוע פקודה / שגיאה לא ידועה ושלח לבוט תמונה, וכתוצאה מכך קוד התמונה יהיה זמין תחת "נתוני בדיקה"


כיצד להשיג קוד תמונה שישלח באמצעות file_id-2


כיצד להשיג קוד תמונה שישלח באמצעות file_id-3

שגיאות פופולריות בעת שליחת תמונה בבוט מברק

400 בקשה גרועה: מזהה קובץ שגוי/כתובת אתר שגויה שצוינה

סיבה:

- פורמט תמונה שגוי (למשל, כתובת אתר אינה מובילה לתמונה או ש-file_id אינו חוקי).

כיצד לתקן:

- ודא כי:

  1. כתובת האתר מסתיימת ב -.jpg, .png ומוביל ל תמונה, לא דף HTML.
  2. file_id רלוונטי לבוט זה (אם משתמשים בו).
  3. כותרת לפי URL-Content-Type: image / jpeg או image / png.

📌 דוגמה לא נכונה: "https://example.com/page?id=123"

400 בקשה גרועה: סוג שגוי של תוכן דף האינטרנט

סיבה:

- בכתובת האתר מברק מצפה לתמונה, אך מקבל HTML או סוג תוכן אחר שאינו נתמך.

כיצד לתקן:

- בדוק שכותרת סוג התוכן בקישור תהיה image / jpeg, image/png וכו'.

400 בקשה גרועה: התמונה חייבת להיות לא ריקה

סיבה:

- שדה תמונה חסר או קובץ ריק הועבר.

כיצד לתקן:

- תוודא שהשדה photo מוגדר כהלכה (URL, InputFile, או file_id) והתמונה אכן קיימת.

413 בקשה ישות גדולה מדי

סיבה:

- הקובץ חורג מהמגבלה (20MB עבור sendPhoto).

כיצד לתקן:

- צמצם את גודל התמונה או השתמש ב-sendDocument (עד 50 מגהבייט) אם אינך צריך להציג כתמונה.

400 בקשה גרועה: צ ' אט לא נמצא

סיבה:

- רשום chat_id שגוי, או שלבוט אין גישה לצ ' אט.

כיצד לתקן:

- תוודא ש:

  1. בוט נוסף לקבוצה / ערוץ.
  2. מזהה נכון (למשל @yourchannelname או מספר) מוגדר.
  3. לבוט יש זכויות לשלוח הודעות.


403 אסור: בוט נחסם על ידי המשתמש

סיבה:

- המשתמש או הערוץ חסמו את הבוט.

כיצד לתקן:

- לא אלא לבקש מהמשתמש בטל נעילה בוט.

מידע טכני עבור"API BOT-MARKET"

קוד סוג ההודעה לשליחת בקשות (messageType) הוא "2"

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