sendPaidMedia

Categoría: Multimedia · Bot API 10.3 · Documentación oficial

Envía contenido multimedia de pago (Bot API 8.0+).

Devuelve: Si la llamada tiene éxito, devuelve Message.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`business_connection_id`	`String`	Opcional	ID de la conexión empresarial
`chat_id`	`Integer or String`	Sí	ID del chat o @username
`message_thread_id`	`Integer`	Opcional	ID del tema del foro
`direct_messages_topic_id`	`Integer`	Opcional	ID del tema de mensajes directos (Bot API 10.0)
`star_count`	`Integer`	Sí	Cantidad de Telegram Stars (1-2500)
`media`	`Array of InputPaidMedia`	Sí	Array JSON de InputPaidMedia
`payload`	`String`	Opcional	Payload del pago
`caption`	`String`	Opcional	Leyenda (0-1024)
`parse_mode`	`String`	Opcional	HTML, Markdown o MarkdownV2
`caption_entities`	`Array of MessageEntity`	Opcional	Array JSON de MessageEntity
`show_caption_above_media`	`Boolean`	Opcional	Mostrar la leyenda encima del contenido multimedia
`disable_notification`	`Boolean`	Opcional	Enviar sin sonido
`protect_content`	`Boolean`	Opcional	Proteger el contenido
`allow_paid_broadcast`	`Boolean`	Opcional	Permitir difusión de pago
`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

Las descripciones de los parámetros son resúmenes breves; consulta la documentación oficial para ver el texto completo.

Ejemplo de solicitud

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());

Guía paso a paso: Cómo crear un bot en Telegram paso a paso: de BotFather a tu primer mensaje

sendPhotoEnvía una foto.
sendVideoEnvía un video.
sendDocumentEnvía un documento.
sendAudioEnvía un audio.
sendAnimationEnvía una animación (GIF).
sendStickerEnvía un sticker.
sendVoiceEnvía un mensaje de voz.
sendVideoNoteEnvía un videomensaje (video circular).
sendMediaGroupEnvía un grupo de archivos multimedia (álbum).
sendDiceEnvía un dado.
sendLivePhotoEnvía una Live Photo (foto + video, Bot API 10.0).