1
0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2024-11-24 08:52:18 +02:00

Правки документации Telegram под форум

This commit is contained in:
Anton Titovets 2024-02-29 09:31:15 +03:00
parent 57aca42ba3
commit 4e01dfbdad
18 changed files with 237 additions and 15 deletions

View File

@ -11,7 +11,7 @@ sidebar_position: 5
| Параметр | Тип | Назначение | | Параметр | Тип | Назначение |
|-|-|-| |-|-|-|
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) |
| Текст | Строка | Текст сообщения | | Текст | Строка | Текст сообщения |
| Аудио | Двоичные данные / Строка | Двоичные данные аудио или путь к файлу | | Аудио | Двоичные данные / Строка | Двоичные данные аудио или путь к файлу |
| Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) |

View File

@ -11,7 +11,7 @@ sidebar_position: 6
| Параметр | Тип | Назначение | | Параметр | Тип | Назначение |
|-|-|-| |-|-|-|
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) |
| Текст | Строка | Текст сообщения | | Текст | Строка | Текст сообщения |
| Документ | Двоичные данные / Строка | Двоичные данные картинки или путь к документу | | Документ | Двоичные данные / Строка | Двоичные данные картинки или путь к документу |
| Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) |

View File

@ -11,7 +11,7 @@ sidebar_position: 4
| Параметр | Тип | Назначение | | Параметр | Тип | Назначение |
|-|-|-| |-|-|-|
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) |
| Текст | Строка | Текст сообщения | | Текст | Строка | Текст сообщения |
| Гифка | Двоичные данные / Строка | Двоичные данные гифки или путь к файлу | | Гифка | Двоичные данные / Строка | Двоичные данные гифки или путь к файлу |
| Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) |

View File

@ -11,7 +11,7 @@ sidebar_position: 7
| Параметр | Тип | Назначение | | Параметр | Тип | Назначение |
|-|-|-| |-|-|-|
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) |
| Текст | Строка | Текст сообщения | | Текст | Строка | Текст сообщения |
| СоответствиеФайлов | Соответствие из Строка | Ключ - двоичные данны или путь к файлу, Значение - тип медиафайла См.ОтправитьФайл | | СоответствиеФайлов | Соответствие из Строка | Ключ - двоичные данны или путь к файлу, Значение - тип медиафайла См.ОтправитьФайл |
| Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) |

View File

@ -11,7 +11,7 @@ sidebar_position: 2
| Параметр | Тип | Назначение | | Параметр | Тип | Назначение |
|-|-|-| |-|-|-|
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) |
| Текст | Строка | Текст сообщения | | Текст | Строка | Текст сообщения |
| Картинка | Двоичные данные / Строка | Двоичные данные картинки или путь к файлу | | Картинка | Двоичные данные / Строка | Двоичные данные картинки или путь к файлу |
| Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) |

View File

@ -11,7 +11,7 @@ sidebar_position: 9
| Параметр | Тип | Назначение | | Параметр | Тип | Назначение |
|-|-|-| |-|-|-|
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) |
| Имя | Строка | Имя контакта | | Имя | Строка | Имя контакта |
| Фамилия | Строка | Фамилия контакта | | Фамилия | Строка | Фамилия контакта |
| Телефон | Строка | Номер телефона | | Телефон | Строка | Номер телефона |

View File

@ -11,7 +11,7 @@ sidebar_position: 8
| Параметр | Тип | Назначение | | Параметр | Тип | Назначение |
|-|-|-| |-|-|-|
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) |
| Широта | Строка/Число | Географическая широта | | Широта | Строка/Число | Географическая широта |
| Долгота | Строка/Число | Географическая долгота | | Долгота | Строка/Число | Географическая долгота |
| Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) |

View File

@ -11,7 +11,7 @@ sidebar_position: 10
| Параметр | Тип | Назначение | | Параметр | Тип | Назначение |
|-|-|-| |-|-|-|
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) |
| Вопрос | Строка | Заголовок опроса | | Вопрос | Строка | Заголовок опроса |
| МассивОтветов | Массив из Строка | Массив строк вариантов ответов | | МассивОтветов | Массив из Строка | Массив строк вариантов ответов |
| Анонимный | Булевно (необяз.) | Анонимный опроса. Неанонимные опросы в каналах не разрешены | | Анонимный | Булевно (необяз.) | Анонимный опроса. Неанонимные опросы в каналах не разрешены |

View File

@ -11,7 +11,7 @@ sidebar_position: 1
| Параметр | Тип | Назначение | | Параметр | Тип | Назначение |
|-|-|-| |-|-|-|
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) |
| Текст | Строка | Текст сообщения | | Текст | Строка | Текст сообщения |
| Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) |

View File

@ -11,7 +11,7 @@ sidebar_position: 3
| Параметр | Тип | Назначение | | Параметр | Тип | Назначение |
|-|-|-| |-|-|-|
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) |
| Текст | Строка | Текст сообщения | | Текст | Строка | Текст сообщения |
| Видео | Двоичные данные / Строка | Двоичные данные видео или путь к файлу **(формат - MP4)** | | Видео | Двоичные данные / Строка | Двоичные данные видео или путь к файлу **(формат - MP4)** |
| Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) |

View File

@ -13,7 +13,7 @@ sidebar_position: 11
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDОригинала | Строка/Число | ID сообщения для пересылки | | IDОригинала | Строка/Число | ID сообщения для пересылки |
| ОткудаID | Строка/Число | ID чата источника | | ОткудаID | Строка/Число | ID чата источника |
| КудаID | Строка/Число | ID чата приемника | | КудаID | Строка/Число | ID чата приемника. Если необходима отправка в определенную тему, её номер нужно указывать через * (КудаID*IDТемы) |
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram

View File

@ -13,7 +13,7 @@ sidebar_position: 3
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата |
| Заголовок | Строка (необяз.) | Новый заголовок темы | | Заголовок | Строка (необяз.) | Новый заголовок темы |
| IDИконки | Строка (необяз.) | Новый ID иконки-аватара темы. См. [Сформировать клавиатуру по массиву кнопок](./Poluchit-spisok-ikonok-avatarov) | | IDИконки | Строка (необяз.) | Новый ID иконки-аватара темы. См. [Получить список иконок-аватаров](./Poluchit-spisok-ikonok-avatarov) |
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram
@ -24,7 +24,8 @@ sidebar_position: 3
НовоеИмя = "Новый тестовый заголовок"; НовоеИмя = "Новый тестовый заголовок";
НовяИконка = "5310132165583840589"; НовяИконка = "5310132165583840589";
Результат = OPI_Telegram.ИзменитьТемуФорума(Токен, Чат, Тема, НовоеИмя, НовяИконка); Ответ = OPI_Telegram.ИзменитьТемуФорума(Токен, Чат, Тема, НовоеИмя, НовяИконка); //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //JSON строка
``` ```

View File

@ -0,0 +1,38 @@
---
sidebar_position: 5
---
# Открыть тему форума
Повторно открывает ранее закрытую тему форума
*Функция ОткрытьТемуФорума(Знач Токен, Знач IDЧата, Знач IDТемы = "") Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата |
| IDТемы | Строка/Число (необяз.) | ID темы для открытия. Если пусто - открывает главную тему чата |
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram
```bsl title="Пример кода"
Токен = "6129457325:BWDF...";
Чат = "-10019711...";
Ответ = OPI_Telegram.ОткрытьТемуФорума(Токен, Чат, 46); //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //JSON строка
```
![Результат](img/4.png)
```json title="Результат"
{
"result": true,
"ok": true
}
```

View File

@ -0,0 +1,144 @@
---
sidebar_position: 1
---
# Получить список иконок-аватаров
Получает соответствие ID-Emoji для установки в качестве иконок тем форума
*Функция ПолучитьСписокИконокАватаров(Знач Токен) Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен бота |
Вовзращаемое значение: Соответствие - Ключ - ID, Значение - Emoji
```bsl title="Пример кода"
Ответ = ПолучитьСписокИконокАватаров("6129457325:BWDF..."); //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //JSON строка
```
```json title="Результат"
// 1С не умеет отображать Emoji - необходимо вставить в другой текстовый редактор
{
"5238234236955148254": "🤡",
"5235579393115438657": "⭐️",
"5309744892677727325": "🎃",
"5237999392438371490": "🦮",
"5312054580060625569": "🎄",
"5417915203100613993": "💬",
"5312424913615723286": "🦠",
"5350444672789519765": "🍕",
"5350392020785437399": "☕️",
"5310132165583840589": "🎂",
"5357504778685392027": "🎩",
"5350658016700013471": "🎭",
"5310039132297242441": "🎨",
"5350344462612570293": "🍽",
"5372819184658949787": "🛃",
"5418115271267197333": "🪪",
"5310139157790596888": "💉",
"5350307998340226571": "🩺",
"5355127101970194557": "🧮",
"5386609083400856174": "🤰",
"5350367161514732241": "🔮",
"5386435923204382258": "👨‍👩‍👧‍👦",
"5350403544182694064": "🍔",
"5348227245599105972": "💼",
"5357188789351490453": "🪖",
"5357298525765902091": "🕺",
"5377317729109811382": "🎶",
"5357419403325481346": "🎓",
"5377624166436445368": "🎟",
"5350497316203668441": "🚂",
"5413625003218313783": "🦄",
"5350424168615649565": "⛅️",
"5350406176997646350": "🍣",
"5348436127038579546": "✈️",
"5368741306484925109": "👠",
"5310262535021142850": "💄",
"5377478880577724584": "👜",
"5357370526597653193": "💃",
"5310157398516703416": "🍓",
"5377468357907849200": "🧼",
"5377494501373780436": "👮‍♂️",
"5350548830041415279": "🏛",
"5357185426392096577": "🫦",
"5310094636159607472": "💊",
"5357121491508928442": "👀",
"5357107601584693888": "👑",
"5420331611830886484": "🔞",
"5310045076531978942": "🎵",
"5408906741125490282": "🏁",
"5377498341074542641": "‼️",
"5350699789551935589": "🛍",
"5350648297189023928": "🏕",
"5237699328843200968": "✅",
"5384574037701696503": "🐟",
"5310228579009699834": "🎉",
"5235912661102773458": "🐈",
"5312486108309757006": "🏠",
"5309950797704865693": "🎮",
"5350520238444126134": "🍹",
"5431492767249342908": "🛒",
"5377690785674175481": "🪙",
"5350554349074391003": "💻",
"5350452584119279096": "💰",
"5350481781306958339": "📚",
"5309958691854754293": "💎",
"5310107765874632305": "💱",
"5350387571199319521": "🗳",
"5386379624773066504": "🖨",
"5350305691942788490": "📈",
"5368808634392257474": "💅",
"5350713563512052787": "📉",
"5377316857231450742": "❓",
"5418196338774907917": "🏔",
"5312322066328853156": "🚗",
"5312241539987020022": "🔥",
"5377675010259297233": "👶",
"5309832892262654231": "🤖",
"5309965701241379366": "🔎",
"5411138633765757782": "🧪",
"5350751634102166060": "🪩",
"5238027455754680851": "🎖",
"5377438129928020693": "⁉️",
"5357315181649076022": "📁",
"5433614043006903194": "📆",
"5312138559556164615": "❤️",
"5310029292527164639": "💘",
"5373251851074415873": "📝",
"5309929258443874898": "💸",
"5382003830487523366": "🎤",
"5386395194029515402": "🏴‍☠️",
"5379748062124056162": "❗️",
"5237889595894414384": "🧠",
"5309984423003823246": "📣",
"5420216386448270341": "🆒",
"5312315739842026755": "🏆",
"5409357944619802453": "📱",
"5238156910363950406": "✍️",
"5375159220280762629": "⚽️",
"5377580546748588396": "🔬",
"5368585403467048206": "🔭",
"5370870893004203704": "🗣",
"5350422527938141909": "🛥",
"5377544228505134960": "🎙",
"5350513667144163474": "📺",
"5312016608254762256": "⚡️",
"5310303848311562896": "🏖",
"5312536423851630001": "💡",
"5357120306097956843": "🧳",
"5384327463629233871": "🏀",
"5368653135101310687": "🎬",
"5434144690511290129": "📰",
"5418085807791545980": "🔝"
}
```

View File

@ -13,7 +13,7 @@ sidebar_position: 2
| Токен | Строка | Токен бота | | Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата | | IDЧата | Строка/Число | ID целевого чата |
| Заголовок | Строка | Заголовок темы | | Заголовок | Строка | Заголовок темы |
| IDИконки | Строка | ID иконки-аватара темы. См. [Сформировать клавиатуру по массиву кнопок](./Poluchit-spisok-ikonok-avatarov) | | IDИконки | Строка | ID иконки-аватара темы. См. [Получить список иконок-аватаров](./Poluchit-spisok-ikonok-avatarov) |
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram
@ -24,7 +24,8 @@ sidebar_position: 2
Имя = "Тестовая тема"; Имя = "Тестовая тема";
Иконка = "5357419403325481346"; Иконка = "5357419403325481346";
Результат = OPI_Telegram.СоздатьТемуФорума(Токен, Чат, Имя, Иконка); Ответ = OPI_Telegram.СоздатьТемуФорума(Токен, Чат, Имя, Иконка);//Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //JSON строка
``` ```

View File

@ -0,0 +1,38 @@
---
sidebar_position: 4
---
# Закрыть тему форума
Закрывает тему для новых сообщений
*Функция ЗакрытьТемуФорума(Знач Токен, Знач IDЧата, Знач IDТемы = "") Экспорт*
| Параметр | Тип | Назначение |
|-|-|-|
| Токен | Строка | Токен бота |
| IDЧата | Строка/Число | ID целевого чата |
| IDТемы | Строка/Число (необяз.) | ID темы для закрытия. Если пусто - закрывает главную тему чата |
Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram
```bsl title="Пример кода"
Токен = "6129457325:BWDF...";
Чат = "-10019711...";
Ответ = OPI_Telegram.ЗакрытьТемуФорума(Токен, Чат, 46); //Соответствие
Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //JSON строка
```
![Результат](img/3.png)
```json title="Результат"
{
"result": true,
"ok": true
}
```

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB