sendPhoto

Categoria: Mídia · Bot API 10.3 · Documentação oficial

Envia uma foto.

Retorno: Em caso de sucesso, retorna Message.

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`business_connection_id`	`String`	Opcional	ID da conexão comercial
`chat_id`	`Integer or String`	Sim	Chat ID ou @username
`message_thread_id`	`Integer`	Opcional	ID do tópico do fórum
`direct_messages_topic_id`	`Integer`	Opcional	ID do tópico de mensagens diretas (Bot API 10.0)
`ephemeral_message_parameters`	`EphemeralMessageParameters`	Opcional	Objeto JSON EphemeralMessageParameters — mensagem efêmera visível para um único usuário (Bot API 10.3)
`photo`	`InputFile or String`	Sim	URL ou file_id da foto
`caption`	`String`	Opcional	Legenda (0-1024)
`parse_mode`	`String`	Opcional	HTML, Markdown, MarkdownV2
`caption_entities`	`Array of MessageEntity`	Opcional	Array JSON de MessageEntity para a legenda
`show_caption_above_media`	`Boolean`	Opcional	Mostrar legenda acima da foto
`has_spoiler`	`Boolean`	Opcional	Ocultar conteúdo (spoiler)
`disable_notification`	`Boolean`	Opcional	Enviar sem som
`protect_content`	`Boolean`	Opcional	Proteger conteúdo
`allow_paid_broadcast`	`Boolean`	Opcional	Permitir transmissão paga
`message_effect_id`	`String`	Opcional	ID do efeito da mensagem
`suggested_post_parameters`	`SuggestedPostParameters`	Opcional	Objeto JSON SuggestedPostParameters
`reply_parameters`	`ReplyParameters`	Opcional	Objeto JSON ReplyParameters
`reply_markup`	`InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply`	Opcional	Objeto JSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply

As descrições dos parâmetros são resumos concisos; consulte a documentação oficial para ver o texto completo.

Exemplo de requisição

curl

curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendPhoto" \
  -H "Content-Type: application/json" \
  -d '{"chat_id":123456789,"photo":"https://telegram.org/img/t_logo.png"}'

Python

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/sendPhoto",
    json={
        "chat_id": 123456789,
        "photo": "https://telegram.org/img/t_logo.png"
    },
    timeout=30,
)
print(resp.json())

JavaScript

const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendPhoto`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "chat_id": 123456789,
    "photo": "https://telegram.org/img/t_logo.png"
  }),
});
console.log(await res.json());

Guia passo a passo: Como criar um bot no Telegram grátis: do BotFather à primeira mensagem

sendVideoEnvia um vídeo.
sendDocumentEnvia um documento.
sendAudioEnvia um áudio.
sendAnimationEnvia uma animação (GIF).
sendStickerEnvia um sticker.
sendVoiceEnvia uma mensagem de voz.
sendVideoNoteEnvia uma mensagem de vídeo (vídeo circular).
sendMediaGroupEnvia um grupo de mídias (álbum).
sendPaidMediaEnvia mídia paga (Bot API 8.0+).
sendDiceEnvia um dado.
sendLivePhotoEnvia uma live photo (foto + vídeo, Bot API 10.0).