sendMediaGroup

Kategori: Media · Bot API 10.3 · Dokumentasi resmi

Mengirim grup media (album).

Nilai kembalian: Jika berhasil, mengembalikan Array of Message.

Parameter

Parameter	Tipe	Wajib	Deskripsi
`business_connection_id`	`String`	Opsional	ID koneksi bisnis
`chat_id`	`Integer or String`	Ya	ID chat atau @username
`message_thread_id`	`Integer`	Opsional	ID topik forum
`direct_messages_topic_id`	`Integer`	Opsional	ID topik pesan langsung (Bot API 10.0)
`media`	`Array of InputMediaAudio, InputMediaDocument, InputMediaLivePhoto, InputMediaPhoto and InputMediaVideo`	Ya	Array JSON InputMedia (2-10 item)
`disable_notification`	`Boolean`	Opsional	Kirim tanpa suara
`protect_content`	`Boolean`	Opsional	Lindungi konten
`allow_paid_broadcast`	`Boolean`	Opsional	Izinkan siaran berbayar
`message_effect_id`	`String`	Opsional	ID efek pesan
`reply_parameters`	`ReplyParameters`	Opsional	Objek JSON ReplyParameters

Deskripsi parameter berupa ringkasan singkat; lihat dokumentasi resmi untuk teks lengkapnya.

Contoh permintaan

curl

curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendMediaGroup" \
  -H "Content-Type: application/json" \
  -d '{
  "chat_id": 123456789,
  "media": [
    {
      "type": "photo",
      "media": "https://telegram.org/img/t_logo.png"
    },
    {
      "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}/sendMediaGroup",
    json={
        "chat_id": 123456789,
        "media": [
            {
                "type": "photo",
                "media": "https://telegram.org/img/t_logo.png"
            },
            {
                "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}/sendMediaGroup`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "chat_id": 123456789,
    "media": [
      {
        "type": "photo",
        "media": "https://telegram.org/img/t_logo.png"
      },
      {
        "type": "photo",
        "media": "https://telegram.org/img/t_logo.png"
      }
    ]
  }),
});
console.log(await res.json());

Panduan langkah demi langkah: Cara Membuat Bot Telegram: dari BotFather sampai Pesan Pertama

sendPhotoMengirim foto.
sendVideoMengirim video.
sendDocumentMengirim dokumen.
sendAudioMengirim audio.
sendAnimationMengirim animasi (GIF).
sendStickerMengirim stiker.
sendVoiceMengirim pesan suara.
sendVideoNoteMengirim video note (video bulat).
sendPaidMediaMengirim media berbayar (Bot API 8.0+).
sendDiceMengirim dadu.
sendLivePhotoMengirim live photo (foto + video, Bot API 10.0).