sendPaidMedia

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

Envia mídia paga (Bot API 8.0+).

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)
`star_count`	`Integer`	Sim	Quantidade de Telegram Stars (1-2500)
`media`	`Array of InputPaidMedia`	Sim	Array JSON de InputPaidMedia
`payload`	`String`	Opcional	Payload do pagamento
`caption`	`String`	Opcional	Legenda (0-1024)
`parse_mode`	`String`	Opcional	HTML, Markdown, MarkdownV2
`caption_entities`	`Array of MessageEntity`	Opcional	Array JSON de MessageEntity
`show_caption_above_media`	`Boolean`	Opcional	Mostrar legenda acima da mídia
`disable_notification`	`Boolean`	Opcional	Enviar sem som
`protect_content`	`Boolean`	Opcional	Proteger conteúdo
`allow_paid_broadcast`	`Boolean`	Opcional	Permitir transmissão paga
`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/sendPaidMedia" \
  -H "Content-Type: application/json" \
  -d '{
  "chat_id": 123456789,
  "star_count": 100,
  "media": [
    {
      "type": "photo",
      "media": "https://telegram.org/img/t_logo.png"
    }
  ]
}'

Python

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/sendPaidMedia",
    json={
        "chat_id": 123456789,
        "star_count": 100,
        "media": [
            {
                "type": "photo",
                "media": "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}/sendPaidMedia`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "chat_id": 123456789,
    "star_count": 100,
    "media": [
      {
        "type": "photo",
        "media": "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

sendPhotoEnvia uma foto.
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).
sendDiceEnvia um dado.
sendLivePhotoEnvia uma live photo (foto + vídeo, Bot API 10.0).