Quais formatos as fotos aceitam no Telegram e quais são as restrições?

Telegram Bot API aceita imagens nas seguintes formato:

1. JPEG / JPG - principal e aconselhável formato para enviar fotos via bot.
2. PNG - suportado, mas nem sempre recomendado, especialmente em Tamanhos Grandes.
3. WEBP - suportado, mas mais comumente usado para adesivos.
4. GIF — não suportado no método e a animação será enviada.

Importante: os formatos de foto enviados pelo bot são realmente limitados o que o Telegram reconhece como"photo". Isso significa que, na prática, o bot deve enviar imagens em JPEG para que o Telegram as interprete corretamente como uma foto (e não como um arquivo).

Tem um limite de tamanho de 20 MB.

Link direto para a imagem - deve levar diretamente ao arquivo e não à página da web.

Exemplo: https://example.com/images/photo.jpg ✅

Errado: https://example.com/gallery/photo?id=123 ❌ (esta é uma página, não um arquivo)

Formato da imagem - deve ser compatível (geralmente JPG, JPEG, PNG, WEBP):

A URL deve terminar em .jpg, .jpeg, .png, .webp, etc.

Exemplo: https://cdn.domain.com/photo123.jpg ✅

O arquivo deve estar disponível publicamente:

Sem autorização, tokens ou cookies.

Telegram (servidor) deve ser capaz de baixá-lo diretamente por essa URL.

O conteúdo do URL deve ser uma imagem válida:

Cabeçalho Content-Type deve ser, por exemplo: image/jpeg, image/png.

Você pode obter rapidamente o código da imagem de duas maneiras:

Colar o link para a imagem e, em seguida, clique no botão "Testar"

Ativar o modo de depuração no evento comando/erro desconhecido e enviar uma foto para o bot, como resultado, o código da imagem estará disponível na seção "Dados de teste"

Razão:

- Formato de foto inválido (por exemplo, o URL não leva à imagem ou o file_id é inválido).

Como corrigir:

- Certifique-se de que:

1. A URL termina em .jpg, .png e leva a imagem Não uma página HTML.
2. file_id é relevante para este bot (se usado).
3. Título URL-Content-Type: image / jpeg ou image / png.

Пример exemplo errado: "https://example.com/page?id=123"

Razão:

- Por URL, O Telegram espera uma imagem e recebe HTML ou outro tipo de conteúdo não suportado.

Como corrigir:

- Certifique-se de que o cabeçalho Content-Type do link seja image/jpeg, image/png, etc.

Razão:

- O campo photo está ausente ou um arquivo vazio foi transferido.

Como corrigir:

– Certifique-se de que o Campo photo esteja correto (URL, InputFile ou file_id) e que a imagem realmente exista.

Razão:

- O arquivo excede o limite (20 MB para sendPhoto).

Como corrigir:

- Reduza o tamanho da imagem ou use sendDocument (até 50 MB) se você não quiser exibir como uma foto.

Razão:

- O chat_id está incorreto ou o bot não tem acesso ao chat.

Como corrigir:

- Certifique-se de que:

1. O bot é adicionado ao grupo / canal.
2. O ID é válido (por exemplo, @yourchannelname ou número).
3. O bot tem permissão para enviar mensagens.

Razão:

- O usuário ou canal bloqueou o bot.

Como corrigir:

Nada além de pedir ao usuário desbloquear bote.

O código do tipo de mensagem para enviar solicitações (messageType) é "2"