sendMediaGroup
Надсилає групу медіа (альбом).
Повертає: У разі успіху повертає Array of Message.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
business_connection_id | String | Ні | ID бізнес-підключення |
chat_id | Integer or String | Так | ID чату або @username |
message_thread_id | Integer | Ні | ID теми форуму |
direct_messages_topic_id | Integer | Ні | ID теми особистих повідомлень (Bot API 10.0) |
media | Array of InputMediaAudio, InputMediaDocument, InputMediaLivePhoto, InputMediaPhoto and InputMediaVideo | Так | JSON-масив InputMedia (2-10 елементів) |
disable_notification | Boolean | Ні | Надіслати без звуку |
protect_content | Boolean | Ні | Захистити вміст |
allow_paid_broadcast | Boolean | Ні | Дозволити платну розсилку |
message_effect_id | String | Ні | ID ефекту повідомлення |
reply_parameters | ReplyParameters | Ні | JSON-об’єкт ReplyParameters |
Приклад запиту
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());
Покроковий посібник: Як створити бота в Телеграм: від @BotFather до першого повідомлення
Схожі методи
sendPhotoНадсилає фото.sendVideoНадсилає відео.sendDocumentНадсилає документ.sendAudioНадсилає аудіо.sendAnimationНадсилає анімацію (GIF).sendStickerНадсилає стікер.sendVoiceНадсилає голосове повідомлення.sendVideoNoteНадсилає відеоповідомлення (кругле відео).sendPaidMediaНадсилає платний медіаконтент (Bot API 8.0+).sendDiceНадсилає кубик.sendLivePhotoНадсилає живе фото (фото + відео, Bot API 10.0).