Invio di un messaggio con una foto nel bot di Telegram
Messaggio con foto in Telegram è un formato di messaggio in cui l'utente invia un'immagine con o senza didascalia. Tali messaggi vengono utilizzati nelle chat private, nei gruppi e in particolare nei canali in cui i Contenuti visivi aiutano a catturare l'attenzione degli abbonati. Le foto su Telegram possono essere accompagnate da testo, hashtag, link ed emoji, rendendolo uno strumento utile per il content marketing visivo e la promozione del marchio.
Quali formati accetta una foto in Telegram e quali sono le restrizioni?
Requisiti della foto durante l'invio
L'API bot di Telegram accetta le immagini nei seguenti formati:
- JPEG / JPG - principale e consigliabile formato per inviare foto tramite bot.
- PNG - supportato, ma non sempre consigliato, soprattutto per le dimensioni più grandi.
- WEBP - supportato, ma più comunemente usato per gli adesivi.
- GIF — non supportato nel metodo e verrà inviata l'animazione.
È importante: i formati di foto inviati dal bot sono effettivamente limitati ciò che Telegram riconosce come"foto". Ciò significa che in pratica il bot deve inviare immagini in JPEG in modo che Telegram li interpreti correttamente come una foto (e non come un file).
Ha un limite di dimensione di 20 MB.
Opzioni e impostazioni per un messaggio con una foto
Requisiti per il collegamento della foto
Collegamento diretto all'immagine - dovrebbe portare direttamente al file, non alla pagina web.
Esempio: https://example.com/images/photo.jpg ✅
Sbagliato: https://example.com/gallery/photo?id=123 ❌ (questa è una pagina, non un file)
Formato dell'immagine - deve essere compatibile (di solito JPG, JPEG, PNG, WEBP):
L'URL deve terminare con .jpg, .jpeg, .png, .webp, ecc.
Esempio: https://cdn.domain.com/photo123.jpg ✅
Il file deve essere accessibile pubblicamente:
Senza autorizzazione, token o cookie.
Telegram (server) dovrebbe essere in grado di scaricarlo direttamente su questo URL.
Il contenuto DELL'URL deve essere un'immagine valida:
Intestazione Content-Type dovrebbe essere, per esempio: image/jpeg, image/png.
Come ottenere il codice immagine da inviare tramite file_id
Puoi ottenere rapidamente il codice immagine in due modi:
Incolla il link all'immagine, quindi fai clic sul pulsante " Prova”
Abilita la modalità di debug nell'evento comando/errore sconosciuto e invia una foto al bot, di conseguenza il codice immagine sarà disponibile nella sezione"Test data"
Errori popolari durante l'invio di foto nel bot di Telegram
400 Richiesta errata: identificatore di file errato / URL HTTP specificato
Motivo:
- Formato foto non valido (ad esempio, L'URL non porta a un'immagine o file_id non è valido).
Come risolvere:
- Assicurarsi che:
- L'URL termina con .jpg, .png e porta a immagine, non una pagina HTML.
- file_id è rilevante per questo bot (se utilizzato).
- Il titolo dell'URL è Content-Type: image / jpeg o image / png.
📌 Esempio di sbagliato: "https://example.com/page?id=123"
400 Richiesta errata: tipo errato di contenuto della pagina Web
Motivo:
- Tramite L'URL, Telegram si aspetta un'immagine e riceve HTML o un altro tipo di contenuto non supportato.
Come risolvere:
- Controlla che L'intestazione Content-Type sul link sia image / jpeg, image / png, ecc.
400 Richiesta errata: la foto deve essere non vuota
Motivo:
- Campo foto mancante o file vuoto trasferito.
Come risolvere:
- Assicurati che il campo photo sia impostato correttamente (URL, InputFile o file_id) e che l'immagine esista effettivamente.
413 Entità richiesta troppo grande
Motivo:
- Il file supera il limite (20 MB per sendPhoto).
Come risolvere:
- Ridurre le dimensioni dell'immagine o utilizzare sendDocument (fino a 50 MB), se non si desidera visualizzare come una foto.
400 Richiesta non valida: chat non trovata
Motivo:
- Viene fornito un ID chat_id errato o il bot non ha accesso alla chat.
Come risolvere:
- Assicurati che:
- Il bot viene aggiunto al gruppo / canale.
- Viene fornito L'ID corretto (ad esempio @yourchannelname o numero).
- Il bot ha i diritti per inviare messaggi.
403 Forbidden: il bot è stato bloccato dall'utente
Motivo:
- L'utente o il canale ha bloccato il bot.
Come risolvere:
- Nient'altro che chiedere all'utente sbloccare soprascarpe.
Informazioni tecniche per»API BOT-MARKET"
Il codice del tipo di messaggio per l'invio di richieste (messageType) è " 2”
