Настройки чата и мессенджера Telegram
Работа с platform IDs в MaviBot
В MaviBot все сущности Telegram (пользователи, группы, каналы) идентифицируются общим platform_id переменным. Эта переменная не различает типы сущностей.
Проблема: Чтобы использовать функции вроде accept или reject которые требуют конкретных типов сущностей, вам нужно знать и chat ID, и user ID отдельно.
Решение: Когда вы получаете callback или сообщение, сразу сохраните platform_id значение в две отдельные переменные с понятными названиями:
chat_id— для хранения ID группы/канала.user_id— для хранения ID отдельного пользователя.
Это позволяет позже обращаться к правильному ID в логике вашего приложения.
Как изменить название чата через Telegram-бота
Описание
tg_set_group_title(platform_id, title) -
Параметры:
! platform_id
ID чата в Telegram *
! title
новое название чата
Как изменить описание чата через Telegram-бота
Описание
tg_set_chat_description(platform_id, description)
! platform_id
ID чата в Telegram *
! description
новое название чата
Как установить аватар в группе/чате в Telegram
Описание
tg_set_chat_photo(platform_id, photo)
! platform_id
ID чата в Telegram *, в котором вы хотите установить аватар
! photo
ссылка на фото
Как удалить аватар в группе/чате в Telegram
Описание
tg_delete_chat_photo(platform_id)
! platform_id
ID чата в Telegram *, в котором вам нужно установить аватар
Как забанить Telegram-группу
Описание
tg_ban_chat_sender_chat(platform_id, sender_chat_id)
Параметры:
! platform_id
ID чата в Telegram *которую нужно забанить
! sender_chat_id
ID чата, который будет забанен
При этом владелец заблокированного чата не сможет писать от имени своих других чатов, пока бан не будет снят.
Как разбанить Telegram-группу
Описание
tg_unban_chat_sender_chat(platform_id, sender_chat_id)
Параметр:
! platform_id
ID чата в Telegram *, в которой вы снимаете бан
! sender_chat_id
ID чата, который вы разбаниваете
Как создать ссылку-приглашение для входа в Telegram-чат
Описание
tg_create_chat_invite_link(platform_id, member_limit, hours, request, name)
Параметр:
! platform_id
ID чата в Telegram *
member_limit
лимит на число участников
hours
Время жизни ссылки (в часах)
request
параметр, после нажатия на ссылку должно быть создано приглашение на вступление в чат.
name
название ссылки
При передаче member_limit параметра значение request параметра автоматически изменяется на False. Если вам нужно принимать заявки на вступление, то оставьте member_limit параметр пустым.
Создание ссылки-приглашения в чат
Как удалить ссылку-приглашение в Telegram
Описание
tg_revoke_chat_invite_link(platform_id, invite_link)
Параметры:
! platform_id
ID чата в Telegram *
! invite_link
ссылка, которую нужно удалить
Как деактивировать все существующие ссылки и заменить их одной ссылкой
Описание
tg_export_chat_link(platform_id)
Параметры:
! platform_id
ID чата в Telegram *
! invite_link
ссылка, которую нужно удалить
В результате ссылка будет единственным способом попасть в группу, пока дополнительные ссылки не будут созданы другими способами.
Используйте с осторожностью. Все существующие ссылки входа в вашу группу станут неактивными.
Как принять заявку и добавить пользователя в Telegram-канал/чат
Как отклонить заявку в Telegram-канале/чате
Как заблокировать пользователя в Telegram
Как разблокировать пользователя в Telegram
Как проверить статус подписки в Telegram
Как определить количество участников в канале/чате
Как проверить, находится ли участник чата в определённом списке
some_client_in_list(list_id, recepient)
Параметры:
! list_id
номер списка
! recepient
ID пользователя в Telegram *. Для chat-клиентов это значение находится в переменной chat_member_id.
Как показать пользователю действия бота (печатает/выбирает стикер и т. д.)
Описание
tg_send_chat_action(platform_id, bot_action, message_thread_id)
! Работа с Telegram business-account
Параметры:
! platform_id
ID чата в Telegram *
! bot_action
действие бота из списка
message_thread_id
ID темы (доступно для супергрупп, если включён функционал форума).
Список доступных действий bot_action
typing для текстовых сообщений, upload_photo для фото, record_video или upload_video для видео, record_voice или upload_voice для голосовых сообщений, upload_document для обычных документов, choose_sticker для стикеров, find_location для данных о местоположении, record_video_note или upload_video_note для видеосообщения.
Это уведомление будет отображаться до тех пор, пока от бота не будет получен любой ответ, но не более 5 секунд.
Как показать пользователю Alert-уведомление
Описание
tg_answer_callback_query(callback_query_id, text,show_alert,cache_time)
! callback_query_id (обязательно)
Этот ID позволяет определить человека, нажавшего кнопку, и показать ему Alert-уведомление.
! text (обязательно)
Текст Alert-уведомления.
show_alert
Указание на исчезающее уведомление (False — исчезающее уведомление в стиле всплывающей подсказки, True — постоянное оконное уведомление)
cache_time
Максимальное время в секундах, в течение которого результат callback-запроса может быть закэширован на стороне клиента. Приложения Telegram поддерживают кэширование начиная с версии 3.14. Значение по умолчанию — 0
Пример
Alert-уведомления показываются только в результате нажатия на callback-кнопку в Telegram.
Например, мы используем следующие кнопки:
[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]
После нажатия на кнопку приходит callback с текстом, содержащимся в соответствующем поле. При нажатии на кнопку «111» вы получите callback с текстом «first».
Создадим блок Start и укажем нужный текст в триггере. В нашем случае: "first
Если в поле Matches вы выберете Игнорировать ошибки и неточности, этот блок в дальнейшем можно будет использовать повторно для всех похожих вариантов, отличающихся на 1–2 символа. Например, чтобы поблагодарить пользователя за предоставление оценки с такой кнопкой.
Далее в калькуляторе используйте tg_answer_callback_query функцию и передайте следующие параметры: callback_query_id - этот ID позволяет определить пользователя, нажавшего кнопку, и показать ему Alert-уведомление text - текст Alert-уведомления.
Пример кода для копирования:
tg_answer_callback_query('#{callback_query_id}', "You pressed the button 111")
Обратите внимание! Параметр callback_query_id следует передавать точно так, как показано в примере, то есть внутри '#{}'.
Если всё настроено правильно, нажатие кнопки вызовет Alert-уведомление с указанным текстом. В мобильной версии в заголовке над текстом будет отображаться имя бота.
Если вы хотите показать простое всплывающее сообщение вместо этого, передайте False в качестве третьего параметра, как показано в примере ниже: tg_answer_callback_query('#{callback_query_id}', "You passed the button 222", False)
Добавление редиректа бота с тегом в ответах callback-кнопки
Описание
tg_callback_url_open(callback_query_id, url, cache_time)
Параметры:
! callback_query_id
Этот ID позволяет определить человека, нажавшего кнопку, и показать ему Alert-уведомление.
! url
URL, ведущий к боту, и параметр (формат: t.me/your_bot?start=XXXX, где your_bot — имя бота)
cache_time
Максимальное время в секундах, в течение которого результат callback-запроса может быть закэширован на стороне клиента. Приложения Telegram поддерживают кэширование начиная с версии 3.14. Значение по умолчанию — 0
Пример
В ответе callback-кнопки вы можете добавить переход к боту с использованием тега tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX')
Например, используем следующие кнопки:
[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]
После нажатия на кнопку приходит callback с текстом, содержащимся в соответствующем поле. При нажатии на кнопку «111» вы получите callback с текстом «first».
Создайте блок с проверкой основного условия и укажите нужный текст в условии. В нашем случае: «first»:
Если в поле Вариант совпадения вы выберете Игнорировать ошибки и неточности, этот блок в дальнейшем можно будет использовать повторно для всех похожих вариантов, отличающихся на 1–2 символа. Например, чтобы поблагодарить пользователя за предоставление оценки с такой кнопкой.
Далее в калькуляторе блока укажите tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX'):
Как назначить пользователя администратором в супергруппе или канале
Обязательный параметр: promote_options_list
Можно указать следующие разрешения в promote_options_list :
is_anonymous — скрывает присутствие администратора в чате,
can_manage_chat — администратор может просматривать журнал событий чата, статистику чата, статистику сообщений в каналах, просматривать участников канала, просматривать анонимных администраторов в супергруппах и обходить медленный режим. Этот уровень разрешений предоставляется по умолчанию, если указано любое из последующих прав
can_post_messages — администратор может создавать публикации в канале (только каналы)
can_edit_messages — администратор может редактировать сообщения других пользователей и закреплять сообщения (только каналы)
can_delete_messages — администратор может удалять сообщения других пользователей
can_manage_video_chats — администратор может управлять видеочатами,
can_restrict_members — администратор может ограничивать участников, банить/разбанивать их в чате,
can_promote_members — администратор может назначать новых администраторов с набором собственных прав или понижать в должности администраторов, которых он назначил напрямую или косвенно (например, администраторов, назначенных ими)
can_change_info — администратор может изменять название чата, фото и другие настройки
can_invite_users — администратор может приглашать новых пользователей в чат
can_pin_messages — администратор может закреплять сообщения (только супергруппы).
Пример
Пример: назначение пользователя администратором в супергруппе:
В этом примере, помимо указанных разрешений, разрешение can_manage_chat будет выдано по умолчанию.
Пример кода для копирования
Как изменить титул администратора с помощью бота в Telegram
Описание
tg_set_administrator_title(platform_id, user_id, title)
Параметры:
ВАЖНО!
Это работает только для пользователей, которых бот повысил до администраторов в супергруппе
Пример кода для копирования:
Общие ограничения для обычных участников чата или конкретных пользователей Telegram
Описание
tg_chat_permission(platform_id, permission, media_permissions)
Параметры:
! platform_id
идентификатор чата в Telegram *
! permission
массив значений из списка ограничений (см. ниже).
1 = действие разрешено
0 = действие запрещено
Индекс массива соответствует позиции в списке ограничений
! media_permissions
массив значений, определяющих разрешения, связанные с медиа (подробности ниже).
1 = действие разрешено
0 = действие запрещено
Индекс массива соответствует позиции в списке медиа-разрешений
Список ограничений для обязательного параметра permission
Список ограничений для permission: 1. ! can_send_messages - разрешение отправлять текстовые сообщения, контакты, местоположение и места. 2. ! can_send_media_messages - разрешение отправлять аудио, документы, фото, видео, видеосообщения и голосовые сообщения. Требует can_send_messages 3. ! can_send_polls - разрешение отправлять опросы. Требует can_send_messages 4. ! can_send_other_messages - разрешение отправлять анимации, игры, стикеры и использовать inline-ботов. Требует can_send_media_messages 5. ! can_add_web_page_previews - разрешение добавлять предпросмотр веб-страниц к сообщениям. Требует can_send_media_messages 6. ! can_change_info - разрешение изменять название чата, фото и другие настройки. Игнорируется в публичных супергруппах. 7. ! can_invite_users - разрешение приглашать пользователей 8. ! can_pin_messages - разрешение закреплять сообщения. Игнорируется в публичных супергруппах. 9. can_manage_topics - разрешение создавать темы в форумах-группах. Если использовать в группе неподходящего типа, функция завершится ошибкой.
Список значений для обязательного параметра media_permissions
Значения для предоставления медиа-разрешений media_permissions:
1. can_send_audios - разрешение отправлять аудиофайлы 2. can_send_documents - разрешение отправлять документы 3. can_send_photos - разрешение отправлять фотографии 4. can_send_videos - разрешение отправлять видео 5. can_send_video_notes - разрешение отправлять круглые видеосообщения 6. can_send_voice_notes - разрешение отправлять голосовые сообщенияя
Личные ограничения Telegram для обычных пользователей чата или для конкретных пользователей Telegram
Описание
tg_restrict_chat_member(platform_id, user_id, minutes, permission, media_permissions).
Параметры:
! platform_id
ID чата в Telegram *
! user_id
ID пользователя в Telegram *
minutes
количество минут, в течение которых ограничение будет активно. Если значение не указано, по умолчанию используется 3600, что равно 60 часам. Если установить значение 0, ограничение станет постоянным
permission
массив значений из списка ограничений разрешений.
media_permissions
список значений для предоставления медиа-разрешений
Список ограничений для обязательного параметра permission
Список ограничений для permission: 1. ! can_send_messages - разрешение отправлять текстовые сообщения, контакты, местоположение и места. 2. ! can_send_media_messages - разрешение отправлять аудио, документы, фото, видео, видеосообщения и голосовые сообщения. Требует can_send_messages 3. ! can_send_polls - разрешение отправлять опросы. Требует can_send_messages 4. ! can_send_other_messages - разрешение отправлять анимации, игры, стикеры и использовать inline-ботов. Требует can_send_media_messages 5. ! can_add_web_page_previews - разрешение добавлять предпросмотр веб-страниц к сообщениям. Требует can_send_media_messages 6. ! can_change_info - разрешение изменять название чата, фото и другие настройки. Игнорируется в публичных супергруппах. 7. ! can_invite_users - разрешение приглашать пользователей 8. ! can_pin_messages - разрешение закреплять сообщения. Игнорируется в публичных супергруппах. 9. can_manage_topics - разрешение создавать темы в форумах-группах. Если использовать в группе неподходящего типа, функция завершится ошибкой.
Список значений для обязательного параметра media_permissions
Значения для предоставления медиа-разрешений media_permissions:
1. can_send_audios - разрешение отправлять аудиофайлы 2. can_send_documents - разрешение отправлять документы 3. can_send_photos - разрешение отправлять фотографии 4. can_send_videos - разрешение отправлять видео 5. can_send_video_notes - разрешение отправлять круглые видеосообщения 6. can_send_voice_notes - разрешение отправлять голосовые сообщенияя
Пример
Пример использования функции, где пользователю запрещено всё на 3 минуты:
Когда пользователь входит в чат, он увидит уведомление о том, что не может отправлять сообщения в чате. Если задан лимит времени, он также увидит длительность этого ограничения.
Пример кода для копирования:
Как закрепить сообщение
Описание
tg_pin_chat_message(platform_id, message_id, disable_notification)
Параметры:
! platform_id
ID чата в Telegram *
message_id
ID сообщения, которое нужно закрепить
disable_notification
Параметр определяет, нужно ли отправлять всем участникам чата уведомление о новом закреплённом сообщении (в каналах и личных чатах уведомления всегда отключены). Если вы не хотите отправлять уведомления, установите параметр disable_notification в 1. В противном случае установите его в 0.
Как открепить сообщение
Описание
tg_unpin_chat_message(platform_id, message_id)
Параметры:
! platform_id
ID чата в Telegram *
message_id
ID сообщения, которое нужно открепить. Если message_id не указан, будет откреплено самое последнее закреплённое сообщение (по дате отправки)
Как открепить все закреплённые сообщения
Описание
tg_unpin_all(platform_id)
Параметры:
! platform_id
ID чата в Telegram *
ВНИМАНИЕ!
В Telegram есть ограничение для функций закрепления/открепления сообщений.
Временные ограничения для использования tg_pin_chat_message / tg_unpin_chat_message / tg_unpin_all НЕ устанавливаются системой MaviBot.
Если допустимое время для закрепления сообщения прошло, функция всё равно вернёт true, но Telegram не применит изменение.
Также важно учитывать, что закреплённые сообщения могут оставаться в кэше, поэтому они могут не исчезнуть визуально сразу.
Как создать опрос в Telegram
Описание
tg_send_poll(platform_id, question, options, is_anonymous, allows_multiple_answers, reply_markup, disable_notification, protect_content, token, reply_to_message_id, message_thread_id, business_connection_id)
Параметры:
! platform_id
ID чата в Telegram *
! question
question
! options
массив вариантов ответов
is_anonymous
1 - анонимный опрос, '' - не анонимный
allows_multiple_answers
1 - доступны множественные ответы, '' - один ответ
reply_markup
keyboard или '' - без клавиатуры
disable_notification
флаг отправки со звуковым уведомлением (по умолчанию 0) 1 – отключить уведомление при получении, 0 – отправить с уведомлением
protect_content
1 — для защиты от копирования и скриншотов, '' — без защиты
token
токен бота; если не указан, используется текущий
reply_to_message_id
ID цитируемого сообщения
message_thread_id
ID темы (доступно для супергрупп, если функция форума существует)
business_connection_id
значение при подключении бота (Business ID). Отображается в каналах. Должно быть указано, если используется токен бота и сообщение должно быть отправлено через подключённую к боту учётную запись пользователя
Важно знать!
Примечания
1. Функция возвращает ответ от Telegram с message_id. Его лучше сохранить. Используя message_id, вы можете остановить опрос с помощью tg_stop_poll (см. описание ниже) и получить результат.
2. Если пользователь добавляет опрос в мессенджере, в чат отправляется callback:
poll_added - неизменная часть YOUR QUESTION - текст вопроса из опроса
Пример колбека при добавлении опроса в канал
Пример колбека при добавлении опроса в чат
Второй колбек после poll_added содержит цифры — это не что иное, как идентификатор пользователя в Telegram, который добавил опрос.
При создании опроса ботом колбек не приходит.
3. В канале можно создавать только анонимные опросы
Внимание, рекомендуется отправлять в группу только анонимные опросы!
4. После создания опроса в переменную сохраните его идентификатор, чтобы понимать, на какой опрос пришёл колбек.
Пример
Отзывы клиентов — ключ к нашему росту. Опросы предлагают простой способ собирать эти отзывы и превращать их в конкретные бизнес-выводы.
Пример кода для копирования:
Функция для создания опроса в Telegram:
Созданный нами опрос в Telegram
Как создать викторину в Telegram
Описание
tg_send_quiz_poll(platform_id, question, options, explanation, correct_option_id, is_anonymous, reply_markup, parse_mode, protect_content, disable_notification, token, reply_to_message_id, message_thread_id )
Параметры:
! platform_id
ID чата в Telegram *
! question
question
! options
массив вариантов ответов
! explanation
текст, отображаемый, когда пользователь выбирает неправильный ответ или нажимает на значок лампочки в викторине, 0–200 символов и не более двух разрывов строк после разбора сущностей.
! correct_option_id
номер правильного ответа, нумерация с 1
is_anonymous
1 - анонимный опрос, '' - не анонимный
reply_markup
keyboard или '' - без клавиатуры
parse_mode
формат объяснения: markdown, html, или '' (пустая строка без форматирования)
protect_content
1 — для защиты от копирования и скриншотов, '' — без защиты
disable_notification
флаг отправки со звуковым уведомлением (по умолчанию 0) 1 – отключить уведомление при получении, 0 – отправить с уведомлением
token
токен бота; если не указан, используется текущий
reply_to_message_id
ID цитируемого сообщения
message_thread_id
ID темы (доступно в супергруппах с активными функциями форума)
Важно знать!
Примечания
1. Сохраните message_id
Функция API возвращает ответ Telegram, содержащий message_id. Всегда сохраняйте этот ID, так как он нужен для:
Завершения викторины с помощью
tg_stop_pollфункции (см. описание ниже).Получения финальных результатов.
2. Callback poll_added
Если пользователь добавляет опрос в канал, бот получает callback:
Формат:
poll_added+ Вопрос опросаЕсли добавлено в групповой чат: callback также включает Telegram User ID человека, который добавил опрос.
Если создано ботом: Нет poll_added callback не отправляется.
3. Ограничение канала
Только анонимные викторины можно создавать в каналах.
4. Callback poll_answer (голосование пользователя)
Когда пользователь голосует в викторине, отправленной в личный чат или group, в диалог бота с этим клиентом отправляется callback:
Формат:
poll_answer+ ID опроса + [Индекс ответа]Пример:
poll_answer 5325838371359031648 [3]Примечание: нумерация ответов начинается с 0.
[3]означает, что пользователь выбрал четвёртый вариант ответа.
5. Webhook для неанонимных групповых опросов
Для неанонимных опросов в группах, где бот является администратором, webhook отправляется для каждого голоса. После его получения бот передаст poll_answer callback (как в пункте 4) в свой диалог с соответствующим клиентом.
6. Требование активации и лучшая практика
Требование: бот не может сам начать разговор. Если клиент никогда не контактировал с ботом, вы не можете отправить ему прямое сообщение в ответ на его голос, пока он не активирует бота сначала (например, отправив
/startкоманду).
Рекомендация: чтобы избежать этого ограничения, крайне рекомендуется отправлять в группы только анонимные викторины.
7. Отслеживайте свои опросы
Сразу после создания викторины сохраните её уникальный ID опроса в переменную. Это позволяет определить, к какому именно опросу относится входящий callback.
Как завершить опрос
Описание
tg_stop_poll(platform_id, message_id)
Параметры:
! platform_id
ID чата в Telegram *
! message_id
ID сообщения опроса/викторины. Его можно получить из webhook
Вызов этой функции для завершения опроса/викторины возвращает словарь, содержащий окончательные результаты.
Как работать с темами в Telegram
Важно: основная тема группы не имеет ID и требует отдельных функций для работы с ней.
Как переименовать «Общую тему» группы
Описание
tg_edit_general_forum_topic(platform_id, topic_name)
Параметры:
! platform_id
ID чата в Telegram *
! topic_name
новое имя темы
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Пример
«Общую тему» группы можно изменить с помощью tg_edit_general_forum_topic() функции. Она требует двух обязательных параметров: ID чата и новое имя для темы группы:
Пример кода для копирования
переименовать чат «Общая тема»/
answer = tg_edit_general_forum_topic(-1001839380031, 'General')
Как закрыть «Общую тему»
Описание
tg_close_general_forum_topic(platform_id)
Параметры:
! platform_id
ID чата в Telegram *
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Пример кода для копирования
/закрыть чат «Общая тема»/
answer = tg_close_general_forum_topic(-1001839380031)
Как заново открыть ранее закрытую «Общую тему»
Описание
tg_reopen_general_forum_topic(platform_id)
Параметры:
! platform_id
ID чата в Telegram *
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Пример кода для копирования
/заново открыть чат «Общая тема»/
answer = tg_reopen_general_forum_topic(-1001839380031)
Как скрыть «Общую тему»
Описание
tg_hide_general_forum_topic(platform_id)
Параметры:
! platform_id
ID чата в Telegram *
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Чат «Общая тема» можно закрыть для участников темы (они смогут читать, но не писать) и скрыть из общего списка чатов Telegram для новых пользователей.
Пример кода для копирования
/скрыть чат «Общая тема»/
answer = tg_hide_general_forum_topic(-1001839380031)
Как отобразить «Общую тему» или восстановить её видимость
Описание
tg_unhide_general_forum_topic(platform_id)
Параметры:
! platform_id
ID темы внутри Telegram *
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Важно!
Эта функция не открывает «Общую тему»; она только делает её видимой.
Пример кода для копирования
/отобразить чат «Общая тема»/
answer = tg_unhide_general_forum_topic(-1001839380031)
Как создать новую тему в Telegram
Описание
tg_create_forum_topic(platform_id, name, icon, icon_color)
Параметры:
! platform_id
ID чата в Telegram *
! name
новое имя темы
icon
ID эмодзи, который будет установлен для темы. Передаётся как строка. Можно использовать только эмодзи из списка, полученного с помощью tg_get_forum_icon .
icon_color
цвет эмодзи из списка: 7322096, 16766590, 13338331, 9367192, 16749490, 16478047. Не все эмодзи поддерживают смену цвета.
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Установленный цвет изменить нельзя; цвет можно задать только при создании темы.
После выполнения функция вернёт ответ, содержащий параметры новой темы, включая ID темы (он требуется для различных функций).
Пример кода для копирования
Чтобы создать дополнительный чат-тему
answer = tg_create_forum_topic(-1001839380031, 'second_bot_topic', None, 7322096)
Чтобы сохранить ID созданного дополнительного чат-темы
answer={"ok":true,"result":{"message_thread_id":254,"name":"second_bot_topic","icon_color":7322096}}/
idtema1=answer['result']['message_thread_id']
Как редактировать тему. Как переименовать и/или изменить эмодзи темы
Описание
tg_edit_forum_topic(platform_id, message_thread_id, name, icon)
Параметры:
! platform_id
ID чата в Telegram *
! message_thread_id
ID дополнительного чат-темы
name
новое имя темы
icon
ID эмодзи, который будет установлен для темы. Передаётся как строка. Можно использовать только эмодзи из списка, полученного с помощью tg_get_forum_icon .
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Как закрыть выбранную тему
Описание
Закрыть тему означает сделать её доступной только для чтения; писать в закрытой теме нельзя.
tg_close_forum_topic(platform_id, message_thread_id)
Параметры:
! platform_id
ID чата в Telegram *
! message_thread_id
ID дополнительного чат-темы
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Как заново открыть ранее закрытую тему
Описание
tg_reopen_forum_topic(platform_id, message_thread_id)
Параметры:
! platform_id
ID чата в Telegram *
! message_thread_id
ID дополнительного чат-темы
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Как удалить тему и все её сообщения
Описание
tg_delete_forum_topic(platform_id, message_thread_id)
Параметры:
! platform_id
ID чата в Telegram *
! message_thread_id
ID дополнительного чат-темы
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Как открепить все сообщения в теме
Описание
tg_unpin_topic_messages(platform_id, message_thread_id)
Параметры:
! platform_id
ID чата в Telegram *
! message_thread_id
ID дополнительного чат-темы
bot_name
необязательный параметр: имя бота.
При работе с темами вы можете указать, какой бот должен выполнять функцию. Это полезно, если ваш проект использует несколько Telegram-ботов. Имя бота можно найти в разделе «Каналы», в поле «Group ID».
Как получить список эмодзи для темы Telegram
Описание
Как получить список эмодзи
tg_get_forum_icon() — эта функция возвращает список эмодзи, доступных для использования в качестве иконок темы форума. Результат необходимо присвоить переменной, так как она возвращает словарь, где каждый ключ — это эмодзи, а соответствующее ему значение — уникальный идентификатор эмодзи (id).
Параметры: нет.
Содержимое списка эмодзи
Чтобы получить список эмодзи для чата темы, отправьте команду в соответствующий чат.
Функция вернёт список эмодзи в своём ответе. Это означает, что переменная answer будет содержать словарь в качестве значения.
{'📰': '5434144690511290129', '💡': '5312536423851630001', '⚡️': '5312016608254762256', '🎙': '5377544228505134960', '🔝': '5418085807791545980', '🗣': '5368697802761185083', '🆒': '5420216386448270341', '❗️': '5379748062124056162', '📝': '5357193964787081133', '📆': '5433614043006903194', '📁': '5357315181649076022', '🔎': '5309965701241379366', '📣': '5309984423003823246', '🔥': '5312241539987020022', '❤️': '5312138559556164615', '❓': '5377316857231450742', '📈': '5350305691942788490', '📉': '5350713563512052787', '💎': '5309958691854754293', '💰': '5350452584119279096', '💸': '5309929258443874898', '\U0001fa99': '5377690785674175481', '💱': '5310107765874632305', '⁉️': '5377438129928020693', '🎮': '5309950797704865693', '💻': '5350554349074391003', '📱': '5409357944619802453', '🚗': '5312322066328853156', '🏠': '5312486108309757006', '💘': '5310029292527164639', '🎉': '5310228579009699834', '‼️': '5377498341074542641', '🏆': '5312315739842026755', '🏁': '5408906741125490282', '🎬': '5368653135101310687', '🎵': '5310045076531978942', '🔞': '5420331611830886484', '📚': '5350481781306958339', '👑': '5357107601584693888', '⚽️': '5375159220280762629', '🏀': '5384327463629233871', '📺': '5350513667144163474', '👀': '5357121491508928442', '\U0001fae6': '5357185426392096577', '🍓': '5310157398516703416', '💄': '5310262535021142850', '👠': '5368741306484925109', '✈️': '5348436127038579546', '\U0001f9f3': '5357120306097956843', '🏖': '5310303848311562896', '⛅️': '5350424168615649565', '🦄': '5413625003218313783', '🛍': '5350699789551935589', '👜': '5377478880577724584', '🛒': '5431492767249342908', '🚂': '5350497316203668441', '🛥': '5350422527938141909', '🏔': '5418196338774907917', '🏕': '5350648297189023928', '🤖': '5309832892262654231', '\U0001faa9': '5350751634102166060', '🎟': '5377624166436445368', '🏴\u200d☠️': '5386395194029515402', '🗳': '5350387571199319521', '🎓': '5357419403325481346', '🔭': '5368585403467048206', '🔬': '5377580546748588396', '🎶': '5377317729109811382', '🎤': '5382003830487523366', '🕺': '5357298525765902091', '💃': '5357370526597653193', '\U0001fa96': '5357188789351490453', '💼': '5348227245599105972', '\U0001f9ea': '5411138633765757782', '👨\u200d👩\u200d👧\u200d👦': '5386435923204382258', '👶': '5377675010259297233', '🤰': '5386609083400856174', '💅': '5368808634392257474', '🏛': '5350548830041415279', '\U0001f9ee': '5355127101970194557', '🖨': '5386379624773066504', '👮\u200d♂️': '5377494501373780436', '\U0001fa7a': '5350307998340226571', '💊': '5310094636159607472', '💉': '5310139157790596888', '\U0001f9fc': '5377468357907849200', '\U0001faaa': '5418115271267197333', '🛃': '5370947704199323325', '🍽': '5350344462612570293', '🐟': '5384574037701696503', '🎨': '5310039132297242441', '🎭': '5350658016700013471', '🎩': '5357504778685392027', '🔮': '5350367161514732241', '🍹': '5350520238444126134', '🎂': '5310132165583840589', '☕️': '5350392020785437399', '🍣': '5350406176997646350', '🍔': '5350403544182694064', '🍕': '5350444672789519765', '\U0001f9a0': '5312424913615723286', '💬': '5417915203100613993', '🎄': '5312054580060625569', '🎃': '5309744892677727325'}
Последнее обновление