Отправить группу медиафайлов
Отправляет набор файлов в чат или канал. Варианты типов медиа: audio, document, photo, video
- Параметры
- Расширенный вызов ?
Функция ОтправитьМедиагруппу(Знач Токен, Знач IDЧата, Знач Текст, Знач СоответствиеФайлов, Знач Клавиатура = "", Знач Разметка = "Markdown") Экспорт
| Параметр | CLI опция | Тип | Обяз. | Назначение |
|---|---|---|---|---|
| Токен | --token | Строка | ✔ | Токен бота |
| IDЧата | --chat | Строка, Число | ✔ | ID целевого чата или IDЧата*IDТемы |
| Текст | --text | Строка | ✔ | Текст сообщения |
| СоответствиеФайлов | --media | Соответствие из КлючИЗначение | ✔ | Коллекция файлов: Ключ > Файл, Значение > Тип медиа |
| Клавиатура | --keyboard | Строка | ✖ | Клавиатура. См. СформироватьКлавиатуруПоМассивуКнопок |
| Разметка | --parsemode | Строка | ✖ | Вид обработки текста (HTML, Markdown, MarkdownV2) |
Возвращаемое значение
Соответствие Из КлючИЗначение - сериализованный JSON ответа от Telegram
| Параметр | Описание |
|---|---|
| proxy | ИнтернетПрокси или структура полей Протокол, Сервер, Порт, Пользователь, Пароль, ИспользоватьАутентификациюОС |
| timeout | Таймаут выполнения запроса |
| adv_response | Оформляет ответ в виде полной структуры HTTP-ответа с полями code, body и headers |
| retries | Число попыток отправки HTTP-запроса при коде 5** или внутренних ошибках клиента |
| dontwait | Создает фоновое задание и возвращает его данные (только для 1С и OneScript) |
подсказка
Метод в документации API: sendMediaGroup
Пример использования для 1С:Предприятие/OneScript
Токен = "6129457865:AAFyzNYOAFbu...";
IDЧата = "461699897";
Текст = "Строковое значение";
Картинка = "https://hut.openintegrations.dev/test_data/picture.jpg";
Видео = "https://hut.openintegrations.dev/test_data/video.mp4";
КартинкаПуть = ПолучитьИмяВременногоФайла("png");
КопироватьФайл(Картинка, КартинкаПуть);
ВидеоПуть = ПолучитьИмяВременногоФайла("mp4");
КопироватьФайл(Видео, ВидеоПуть);
ВидеоДД = Новый ДвоичныеДанные(ВидеоПуть);
Медиагруппа = Новый Соответствие;
Медиагруппа.Вставить(КартинкаПуть, "photo");
Медиагруппа.Вставить(ВидеоДД , "video");
Результат = OPI_Telegram.ОтправитьМедиагруппу(Токен, IDЧата, Текст, Медиагруппа);
- Bash
- CMD/Bat
# JSON данные также могут быть переданы как путь к файлу .json
oint telegram ОтправитьМедиагруппу \
--token "***" \
--chat "***" \
--text "Строковое значение" \
--media "{'https://hut.openintegrations.dev/test_data/document.docx':'document','/tmp/zqlmyosk.duu.docx':'document'}"
:: JSON данные также могут быть переданы как путь к файлу .json
oint telegram ОтправитьМедиагруппу ^
--token "***" ^
--chat "***" ^
--text "Строковое значение" ^
--media "{'https://hut.openintegrations.dev/test_data/document.docx':'document','/tmp/zqlmyosk.duu.docx':'document'}"
Результат
{
"ok": true,
"result": [
{
"message_id": 21828,
"from": {
"id": 6129457865,
"is_bot": true,
"first_name": "Бот Виталий",
"username": "sicheebot"
},
"chat": {
"id": 461699897,
"first_name": "Anton",
"last_name": "Titovets",
"username": "bayselonarrend",
"type": "private"
},
"date": 1779815083,
"media_group_id": "14238520667556882",
"photo": [
{
"file_id": "AgACAgIAAxkDAAJULmoTw3F0g929wxeavL_yMqOtGLNaAAIhIWsbcsGZSLK5DC2W3Y18AQADAgADcwADOwQ",
"file_unique_id": "AQADISFrG3LBmUh4",
"file_size": 1569,
"width": "***",
"height": 67
},
{
"file_id": "AgACAgIAAxkDAAJULmoTw3F0g929wxeavL_yMqOtGLNaAAIhIWsbcsGZSLK5DC2W3Y18AQADAgADbQADOwQ",
"file_unique_id": "AQADISFrG3LBmUhy",
"file_size": 21511,
"width": "***",
"height": 240
},
{
"file_id": "AgACAgIAAxkDAAJULmoTw3F0g929wxeavL_yMqOtGLNaAAIhIWsbcsGZSLK5DC2W3Y18AQADAgADeAADOwQ",
"file_unique_id": "AQADISFrG3LBmUh9",
"file_size": 98652,
"width": "***",
"height": 600
},
{
"file_id": "AgACAgIAAxkDAAJULmoTw3F0g929wxeavL_yMqOtGLNaAAIhIWsbcsGZSLK5DC2W3Y18AQADAgADeQADOwQ",
"file_unique_id": "AQADISFrG3LBmUh-",
"file_size": 217083,
"width": "***",
"height": 960
},
{
"file_id": "AgACAgIAAxkDAAJULmoTw3F0g929wxeavL_yMqOtGLNaAAIhIWsbcsGZSLK5DC2W3Y18AQADAgADdwADOwQ",
"file_unique_id": "AQADISFrG3LBmUh8",
"file_size": 645868,
"width": "***",
"height": 1920
}
],
"caption": "Строковое значение"
},
{
"message_id": 21829,
"from": {
"id": 6129457865,
"is_bot": true,
"first_name": "Бот Виталий",
"username": "sicheebot"
},
"chat": {
"id": 461699897,
"first_name": "Anton",
"last_name": "Titovets",
"username": "bayselonarrend",
"type": "private"
},
"date": 1779815083,
"media_group_id": "14238520667556882",
"video": {
"duration": 5,
"width": "***",
"height": 480,
"file_name": "video1",
"mime_type": "video/mp4",
"thumbnail": {
"file_id": "AAMCAgADFQdqFdKrTjDyVg_KUXmwo_TJltJkygACQ50AAk6VsUj_25bImmWFrQEAB20AAzsE",
"file_unique_id": "AQADQ50AAk6VsUhy",
"file_size": 19807,
"width": "***",
"height": 240
},
"thumb": {
"file_id": "AAMCAgADFQdqFdKrTjDyVg_KUXmwo_TJltJkygACQ50AAk6VsUj_25bImmWFrQEAB20AAzsE",
"file_unique_id": "AQADQ50AAk6VsUhy",
"file_size": 19807,
"width": "***",
"height": 240
},
"file_id": "BAACAgIAAxUHahXSq04w8lYPylF5sKP0yZbSZMoAAkOdAAJOlbFI_9uWyJplha07BA",
"file_unique_id": "AgADQ50AAk6VsUg",
"file_size": 1137878
}
}
]
}