diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-audio.md b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-audio.md index aad56b7da..7b1088e47 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-audio.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-audio.md @@ -11,7 +11,7 @@ sidebar_position: 5 | Параметр | Тип | Назначение | |-|-|-| | Токен | Строка | Токен бота | - | IDЧата | Строка/Число | ID целевого чата | + | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) | | Текст | Строка | Текст сообщения | | Аудио | Двоичные данные / Строка | Двоичные данные аудио или путь к файлу | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-dokument.md b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-dokument.md index 356c0e898..703084bb1 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-dokument.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-dokument.md @@ -11,7 +11,7 @@ sidebar_position: 6 | Параметр | Тип | Назначение | |-|-|-| | Токен | Строка | Токен бота | - | IDЧата | Строка/Число | ID целевого чата | + | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) | | Текст | Строка | Текст сообщения | | Документ | Двоичные данные / Строка | Двоичные данные картинки или путь к документу | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-gifku.md b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-gifku.md index dea8994d9..db86af313 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-gifku.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-gifku.md @@ -11,7 +11,7 @@ sidebar_position: 4 | Параметр | Тип | Назначение | |-|-|-| | Токен | Строка | Токен бота | - | IDЧата | Строка/Число | ID целевого чата | + | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) | | Текст | Строка | Текст сообщения | | Гифка | Двоичные данные / Строка | Двоичные данные гифки или путь к файлу | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-gruppu-media.md b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-gruppu-media.md index c7403da8b..126b601d6 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-gruppu-media.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-gruppu-media.md @@ -11,7 +11,7 @@ sidebar_position: 7 | Параметр | Тип | Назначение | |-|-|-| | Токен | Строка | Токен бота | - | IDЧата | Строка/Число | ID целевого чата | + | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) | | Текст | Строка | Текст сообщения | | СоответствиеФайлов | Соответствие из Строка | Ключ - двоичные данны или путь к файлу, Значение - тип медиафайла См.ОтправитьФайл | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-kartinku.md b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-kartinku.md index b49d6981e..36e36b5d0 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-kartinku.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-kartinku.md @@ -11,7 +11,7 @@ sidebar_position: 2 | Параметр | Тип | Назначение | |-|-|-| | Токен | Строка | Токен бота | - | IDЧата | Строка/Число | ID целевого чата | + | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) | | Текст | Строка | Текст сообщения | | Картинка | Двоичные данные / Строка | Двоичные данные картинки или путь к файлу | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-kontakt.md b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-kontakt.md index e260369c5..55482576b 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-kontakt.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-kontakt.md @@ -11,7 +11,7 @@ sidebar_position: 9 | Параметр | Тип | Назначение | |-|-|-| | Токен | Строка | Токен бота | - | IDЧата | Строка/Число | ID целевого чата | + | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) | | Имя | Строка | Имя контакта | | Фамилия | Строка | Фамилия контакта | | Телефон | Строка | Номер телефона | diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-mestopolozhenie.md b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-mestopolozhenie.md index f33f0318d..1abe3ccca 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-mestopolozhenie.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-mestopolozhenie.md @@ -11,7 +11,7 @@ sidebar_position: 8 | Параметр | Тип | Назначение | |-|-|-| | Токен | Строка | Токен бота | - | IDЧата | Строка/Число | ID целевого чата | + | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) | | Широта | Строка/Число | Географическая широта | | Долгота | Строка/Число | Географическая долгота | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-opros.md b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-opros.md index df52b9782..2611d08a8 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-opros.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-opros.md @@ -11,7 +11,7 @@ sidebar_position: 10 | Параметр | Тип | Назначение | |-|-|-| | Токен | Строка | Токен бота | - | IDЧата | Строка/Число | ID целевого чата | + | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) | | Вопрос | Строка | Заголовок опроса | | МассивОтветов | Массив из Строка | Массив строк вариантов ответов | | Анонимный | Булевно (необяз.) | Анонимный опроса. Неанонимные опросы в каналах не разрешены | diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-tekstovoe-soobschenie.md b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-tekstovoe-soobschenie.md index 7c1013f60..72340e887 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-tekstovoe-soobschenie.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-tekstovoe-soobschenie.md @@ -11,7 +11,7 @@ sidebar_position: 1 | Параметр | Тип | Назначение | |-|-|-| | Токен | Строка | Токен бота | - | IDЧата | Строка/Число | ID целевого чата | + | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) | | Текст | Строка | Текст сообщения | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-video.md b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-video.md index e2afc9791..5d4dbddcb 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-video.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Otpravit-video.md @@ -11,7 +11,7 @@ sidebar_position: 3 | Параметр | Тип | Назначение | |-|-|-| | Токен | Строка | Токен бота | - | IDЧата | Строка/Число | ID целевого чата | + | IDЧата | Строка/Число | ID целевого чата. Если необходима отправка в определенную тему, её номер нужно указывать через * (IDЧата*IDТемы) | | Текст | Строка | Текст сообщения | | Видео | Двоичные данные / Строка | Двоичные данные видео или путь к файлу **(формат - MP4)** | | Клавиатура | Строка (необяз.) | JSON клавиатуры. См. [Сформировать клавиатуру по массиву кнопок](./Sformirovat-klaviaturu-po-massivu-knopok) | diff --git a/docs/docs/Telegram/Rabota-s-dialogami/Pereslat-soobschenie.md b/docs/docs/Telegram/Rabota-s-dialogami/Pereslat-soobschenie.md index 780fb83aa..880ce180b 100644 --- a/docs/docs/Telegram/Rabota-s-dialogami/Pereslat-soobschenie.md +++ b/docs/docs/Telegram/Rabota-s-dialogami/Pereslat-soobschenie.md @@ -13,7 +13,7 @@ sidebar_position: 11 | Токен | Строка | Токен бота | | IDОригинала | Строка/Число | ID сообщения для пересылки | | ОткудаID | Строка/Число | ID чата источника | - | КудаID | Строка/Число | ID чата приемника | + | КудаID | Строка/Число | ID чата приемника. Если необходима отправка в определенную тему, её номер нужно указывать через * (КудаID*IDТемы) | Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram diff --git a/docs/docs/Telegram/Rabota-s-temami-foruma/Izmenit-temu-foruma.md b/docs/docs/Telegram/Rabota-s-temami-foruma/Izmenit-temu-foruma.md index 5b888a1ec..6c087eb47 100644 --- a/docs/docs/Telegram/Rabota-s-temami-foruma/Izmenit-temu-foruma.md +++ b/docs/docs/Telegram/Rabota-s-temami-foruma/Izmenit-temu-foruma.md @@ -13,7 +13,7 @@ sidebar_position: 3 | Токен | Строка | Токен бота | | IDЧата | Строка/Число | ID целевого чата | | Заголовок | Строка (необяз.) | Новый заголовок темы | - | IDИконки | Строка (необяз.) | Новый ID иконки-аватара темы. См. [Сформировать клавиатуру по массиву кнопок](./Poluchit-spisok-ikonok-avatarov) | + | IDИконки | Строка (необяз.) | Новый ID иконки-аватара темы. См. [Получить список иконок-аватаров](./Poluchit-spisok-ikonok-avatarov) | Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram @@ -24,7 +24,8 @@ sidebar_position: 3 НовоеИмя = "Новый тестовый заголовок"; НовяИконка = "5310132165583840589"; - Результат = OPI_Telegram.ИзменитьТемуФорума(Токен, Чат, Тема, НовоеИмя, НовяИконка); + Ответ = OPI_Telegram.ИзменитьТемуФорума(Токен, Чат, Тема, НовоеИмя, НовяИконка); //Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //JSON строка ``` diff --git a/docs/docs/Telegram/Rabota-s-temami-foruma/Otkryt-temu-foruma.md b/docs/docs/Telegram/Rabota-s-temami-foruma/Otkryt-temu-foruma.md new file mode 100644 index 000000000..9fc95c2b7 --- /dev/null +++ b/docs/docs/Telegram/Rabota-s-temami-foruma/Otkryt-temu-foruma.md @@ -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 +} + +``` diff --git a/docs/docs/Telegram/Rabota-s-temami-foruma/Poluchit-spisok-ikonok-avatarov.md b/docs/docs/Telegram/Rabota-s-temami-foruma/Poluchit-spisok-ikonok-avatarov.md new file mode 100644 index 000000000..2814f747d --- /dev/null +++ b/docs/docs/Telegram/Rabota-s-temami-foruma/Poluchit-spisok-ikonok-avatarov.md @@ -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": "🔝" +} + +``` diff --git a/docs/docs/Telegram/Rabota-s-temami-foruma/Sozdat-temu-foruma.md b/docs/docs/Telegram/Rabota-s-temami-foruma/Sozdat-temu-foruma.md index aeaeee6fc..d3b8c3a80 100644 --- a/docs/docs/Telegram/Rabota-s-temami-foruma/Sozdat-temu-foruma.md +++ b/docs/docs/Telegram/Rabota-s-temami-foruma/Sozdat-temu-foruma.md @@ -13,7 +13,7 @@ sidebar_position: 2 | Токен | Строка | Токен бота | | IDЧата | Строка/Число | ID целевого чата | | Заголовок | Строка | Заголовок темы | - | IDИконки | Строка | ID иконки-аватара темы. См. [Сформировать клавиатуру по массиву кнопок](./Poluchit-spisok-ikonok-avatarov) | + | IDИконки | Строка | ID иконки-аватара темы. См. [Получить список иконок-аватаров](./Poluchit-spisok-ikonok-avatarov) | Вовзращаемое значение: Соответствие - сериализованный JSON ответа от Telegram @@ -24,7 +24,8 @@ sidebar_position: 2 Имя = "Тестовая тема"; Иконка = "5357419403325481346"; - Результат = OPI_Telegram.СоздатьТемуФорума(Токен, Чат, Имя, Иконка); + Ответ = OPI_Telegram.СоздатьТемуФорума(Токен, Чат, Имя, Иконка);//Соответствие + Ответ = OPI_Инструменты.JSONСтрокой(Ответ); //JSON строка ``` diff --git a/docs/docs/Telegram/Rabota-s-temami-foruma/Zakryt-temu-foruma.md b/docs/docs/Telegram/Rabota-s-temami-foruma/Zakryt-temu-foruma.md new file mode 100644 index 000000000..775c20498 --- /dev/null +++ b/docs/docs/Telegram/Rabota-s-temami-foruma/Zakryt-temu-foruma.md @@ -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 +} + +``` diff --git a/docs/docs/Telegram/Rabota-s-temami-foruma/img/3.png b/docs/docs/Telegram/Rabota-s-temami-foruma/img/3.png new file mode 100644 index 000000000..9b4c65abc Binary files /dev/null and b/docs/docs/Telegram/Rabota-s-temami-foruma/img/3.png differ diff --git a/docs/docs/Telegram/Rabota-s-temami-foruma/img/4.png b/docs/docs/Telegram/Rabota-s-temami-foruma/img/4.png new file mode 100644 index 000000000..ea75cc3ce Binary files /dev/null and b/docs/docs/Telegram/Rabota-s-temami-foruma/img/4.png differ