MaviBot-та платформа идентификаторларымен жұмыс істеу

MaviBot-та барлық Telegram нысандары (пайдаланушылар, топтар, арналар) жалпы platform_id айнымалысы арқылы анықталады. Бұл айнымалы нысан түрлерін ажыратпайды.

Мәселе: accept немесе reject сияқты нақты нысан түрлерін қажет ететін функцияларды пайдалану үшін чат ID және пайдаланушы ID бөлек білу қажет.

Шешім: Кері қоңырау немесе хабарлама алған кезде, platform_id мәнін бірден екі түрлі, мақсатты атаумен айнымалыларда сақтаңыз:

  • chat_id – топ/арна ID сақтау үшін.
  • user_id – жеке пайдаланушының ID сақтау үшін.

Бұл қолданба логикаңызда кейінірек дұрыс ID сілтеме жасауға мүмкіндік береді.

Telegram боты арқылы чат атауын қалай өзгертуге болады

Сипаттама

tg_set_group_title(platform_id, title)

Telegram тобының атауын өзгертеді.

Параметрлер

Параметр Сипаттама
platform_id Telegram ішіндегі чат ID.
title Жаңа чат атауы.
Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** title жаңа чат атауы

Telegram боты арқылы чат сипаттамасын қалай өзгертуге болады

Сипаттама

tg_set_chat_description(platform_id, description)

Telegram чатының сипаттамасын өзгертеді.

Параметрлер

Параметр Сипаттама
platform_id Telegram ішіндегі чат ID.
description Жаңа чат сипаттамасы.
Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** description жаңа чат атауы

Telegram тобында/чатында аватарды қалай орнатуға болады

Сипаттама

tg_set_chat_photo(platform_id, photo)

Telegram чаты үшін жаңа профиль фотосын орнатады.

Параметрлер

Параметр Сипаттама
platform_id Жаңа профиль фотосын орнатқыңыз келетін Telegram ішіндегі чат ID.
photo Фотоға тікелей сілтеме.
Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *, онда аватар орнатқыңыз келеді
**!** photo фото сілтемесі

Telegram тобында/чатында аватарды қалай жоюға болады

Сипаттама

tg_delete_chat_photo(platform_id)

Telegram чатынан ағымдағы профиль фотосын жояды.

Параметрлер

Параметр Сипаттама
platform_id Профиль фотосын жойғыңыз келетін Telegram ішіндегі чат ID.
Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *, онда аватар орнату қажет

Telegram тобын қалай бұғаттауға болады

Сипаттама

tg_ban_chat_sender_chat(platform_id, sender_chat_id)

Жіберуші чатын Telegram чатында хабарламаларды жариялаудан бұғаттайды.

Параметрлер

Параметр Сипаттама
platform_id Жіберуші чаты бұғатталатын Telegram чатының ID.
sender_chat_id Бұғаттау үшін жіберуші чатының ID.

Ескерту

Бұғатталғаннан кейін, жіберуші чатының иесі бұғаттау алынғанша көрсетілген Telegram чатында сол чат атынан хабарламаларды жариялай алмайды.

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *, оны бұғаттау қажет
**!** sender_chat_id бұғаттайтын чат ID

Сонымен қатар, бұғатталған чат иесі бұғатталмайынша, өзінің/өзінің басқа чаттары атынан жаза алмайды.

Telegram тобын қалай бұғаттан шығаруға болады

Сипаттама

tg_unban_chat_sender_chat(platform_id, sender_chat_id)

Telegram чатында бұрын бұғатталған жіберуші чатын бұғаттан шығарады.

Параметрлер

Параметр Сипаттама
platform_id Жіберуші чаты бұғаттан шығарылатын Telegram чатының ID.
sender_chat_id Бұғаттан шығару үшін жіберуші чатының ID.
Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *, онда бұғаттан шығарасыз
**!** sender_chat_id бұғаттан шығаратын чат ID

Telegram чатына қосылуға шақыру сілтемесін қалай жасауға болады

Сипаттама

Telegram чаты үшін жаңа шақыру сілтемесін жасайды.

Параметрлер

Параметр Сипаттама
platform_id Telegram чатының ID.
member_limit Осы шақыру сілтемесі арқылы қосыла алатын пайдаланушылардың максималды саны.
hours Шақыру сілтемесінің мерзімінің аяқталу уақыты, сағатпен.
request Егер True мәніне орнатылса, сілтемені басқан пайдаланушылар әкімші мақұлдай алатын қосылу сұрауын жіберуі керек.
name Шақыру сілтемесі үшін теңшелетін атау.

Маңызды

Егер member_limit параметрі көрсетілсе, request параметрі автоматты түрде False мәніне орнатылады.

Пайдаланушылардан қосылу сұрауларын жіберуді талап ету үшін member_limit параметрін бос қалдырыңыз.

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
member_limit қатысушылар санына шектеу
hours Сілтеменің мерзімінің аяқталу уақыты (сағатпен)
request сілтемені басқаннан кейін чатқа қосылу сұрауы жасалуы керек параметр.
name сілтеме атауы

member_limit параметрін беру кезінде request параметрінің мәні автоматты түрде False мәніне өзгертіледі. Егер мүшелікке өтінімдерді қабылдау қажет болса, member_limit параметрін бос қалдырыңыз.

Чатқа шақыру сілтемесін жасау

Telegram чатындағы шақыру сілтемесін қалай жоюға болады

Сипаттама

Telegram чаты үшін бар шақыру сілтемесін кері қайтарады.

Параметрлер

Параметр Сипаттама
platform_id Telegram чатының ID.
invite_link Кері қайтарылатын шақыру сілтемесі.
Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** invite_link жою қажет сілтеме

Барлық бар сілтемелерді қалай жоюға және оларды бір сілтемеге ауыстыруға болады

Сипаттама

Telegram чаты үшін жаңа негізгі шақыру сілтемесін жасайды.

Параметрлер

Параметр Сипаттама
platform_id Telegram чатының ID.

Ескерту

Бұл әдіс чат үшін жаңа негізгі шақыру сілтемесін жасайды.

Бұрын жасалған барлық негізгі шақыру сілтемелері жарамсыз болады. Жаңадан жасалған сілтеме қосымша шақыру сілтемелері жасалғанға дейін жалғыз белсенді негізгі шақыру сілтемесі болады.

Бұл әдісті сақтықпен пайдаланыңыз.

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** invite_link жою қажет сілтеме

Telegram арнасына/чатына сұрауды қабылдау және пайдаланушыны қосу

Сипаттама

tg_approve_chat_join_request(chat_id, user_id)

Telegram тобы немесе арнасы үшін күтілетін қосылу сұрауын мақұлдайды.

Параметрлер

Параметр Сипаттама
chat_id Telegram тобының немесе арнасының ID.
user_id Қосылу сұрауы мақұлдануы тиіс пайдаланушының Telegram пайдаланушы ID.
**!** chat_id Telegram ішіндегі топ/арна ID *
**!** user_id Telegram ішіндегі пайдаланушы ID *

Сұрауды қабылдау:

Telegram арнасында/чатында сұрауды қалай қабылдамауға болады

Сипаттама

tg_decline_chat_join_request(chat_id, user_id)

Telegram тобы немесе арнасы үшін күтілетін қосылу сұрауын қабылдамайды.

Параметрлер

Параметр Сипаттама
chat_id Telegram тобының немесе арнасының ID.
user_id Қосылу сұрауы қабылданбауы тиіс пайдаланушының Telegram пайдаланушы ID.
**!** chat_id Telegram ішіндегі топ/арна ID *
**!** user_id Telegram ішіндегі пайдаланушы ID *

Telegram-да пайдаланушыны қалай бұғаттауға болады

Сипаттама

tg_ban_chat_member(chat_id, user_id, hours)

Пайдаланушыны Telegram чатынан бұғаттайды.

Параметрлер

Параметр Сипаттама
chat_id Telegram чатының ID.
user_id Бұғатталатын пайдаланушының Telegram пайдаланушы ID.
hours Бұғаттау ұзақтығы, сағатпен. Егер көрсетілмесе, бұғаттау тұрақты болады.

Ескертпе

Егер сағат мәні 366 күннен асса, пайдаланушы мәңгілікке бұғатталады.

Параметр Сипаттама
**!** chat_id Telegram ішіндегі чат ID *
**!** user_id Telegram ішіндегі пайдаланушы ID * бұғаттау үшін
hours Бұғаттау ұзақтығы сағатпен. Әдепкі бойынша бұғаттау тұрақты. Егер бұғаттау ұзақтығы 366 күннен асса, бұғаттау тұрақты болып орнатылады.

Telegram-да пайдаланушыны бұғаттан шығару жолы

Сипаттама

tg_unban_chat_member(chat_id, user_id)

Telegram чатындағы пайдаланушыны бұғаттан шығарады.

Параметрлер

Параметр Сипаттама
chat_id Telegram чатының ID.
user_id Бұғаттан шығарылатын пайдаланушының Telegram ID.
Параметр Сипаттама
**!** chat_id Telegram ішіндегі чат ID *
**!** user_id Telegram ішіндегі пайдаланушы ID *, бұғаттан шығару қажет

Telegram-да жазылым күйін тексеру жолы

Сипаттама

tg_get_chat_member(chat_id, user_id)

Telegram чатындағы пайдаланушының мүшелік күйі туралы ақпаратты алады.

Параметрлер

Параметр Сипаттама
chat_id Telegram чатының ID.
user_id Мүшелік күйі тексерілетін пайдаланушының Telegram ID.
Параметр Сипаттама
**!** chat_id Telegram ішіндегі чат ID *
**!** user_id Telegram ішіндегі пайдаланушы ID *, жазылымын тексереміз

Арнадағы/чаттағы мүшелер санын анықтау жолы

Сипаттама

tg_get_chat_member_count(platform_id)

Telegram чатындағы мүшелердің жалпы санын қайтарады.

Параметрлер

Параметр Сипаттама
platform_id Telegram чатының ID.
Параметр Сипаттама
**!** platform_id Telegram-дағы чат ID *

Чат мүшесінің белгілі бір тізімде екенін тексеру жолы

some_client_in_list(list_id, recepient)

Telegram пайдаланушысының көрсетілген тізімге енгізілгенін тексереді.

Параметрлер

Параметр Сипаттама
list_id Тексерілетін тізімнің ID.
recepient Telegram пайдаланушысының ID. Чат мүшелері үшін chat_member_id айнымалысын пайдаланыңыз.
Параметр Сипаттама
**!** list_id тізім нөмірі
**!** recepient Telegram ішіндегі пайдаланушы ID *. Чат клиенттері үшін бұл мән chat_member_id айнымалысында болады.

Боттың әрекеттерін пайдаланушыға көрсету жолы (теріп жазу/стикер таңдау және т.б.)

Сипаттама

tg_send_chat_action(platform_id, bot_action, message_thread_id)

Telegram чатына чат әрекетін (мысалы, теріп жазу немесе файл жүктеу) жібереді.

Параметрлер

Параметр Сипаттама
platform_id Telegram чатының ID.
bot_action Көрсетілетін чат әрекеті. Қолдау көрсетілетін Telegram чат әрекеттерінің бірін таңдаңыз.
message_thread_id Тақырып ID. Тек Тақырыптар (Форумдар) қосылған супертоптар үшін қолжетімді.

Ескертпе

Бұл функция Telegram Business аккаунттарымен жұмыс істеу кезінде қолдау көрсетіледі.

Параметр Сипаттама
**!** platform_id Telegram-дағы чат ID *
**!** bot_action тізімдегі боттың әрекеті
message_thread_id тақырып ID (форум функционалы қолжетімді болса, супертоптар үшін қолжетімді).
**Қолжетімді әрекеттер тізімі bot_action**

typing мәтіндік хабарламалар үшін,
&#xNAN;upload_photo фотосуреттер үшін,
&#xNAN;record_video немесе upload_video бейнелер үшін,
&#xNAN;record_voice немесе upload_voice дауыстық жазбалар үшін,
&#xNAN;upload_document жалпы құжаттар үшін,
&#xNAN;choose_sticker стикерлер үшін,
&#xNAN;find_location орналасу деректері үшін,
&#xNAN;record_video_note немесе upload_video_note бейне жазба үшін.

Бұл хабарландыру боттан кез келген жауап алынғанша, бірақ 5 секундтан аспайтын уақыт ішінде көрсетіледі.

Пайдаланушыға Alert-хабарландыруды көрсету жолы

Сипаттама

tg_answer_callback_query(callback_query_id, text, show_alert, cache_time)

Telegram-да пайдаланушы инлайн түймені басқан кезде іске қосылатын кері шақыру сұрауына жауап жібереді.

Параметрлер

Параметр Сипаттама
callback_query_id Пайдаланушы инлайн түймені басқан кезде алынған кері шақыру сұрауының ID. Бұл қай кері шақыруға жауап беру керектігін анықтайды.
text Хабарландыруда көрсетілетін мәтін.
show_alert Хабарландырудың қалай көрсетілетінін басқарады. Уақытша кеңес-стиліндегі хабарландыруды көрсету үшін False мәнін, немесе тұрақты ескерту диалогын көрсету үшін True мәнін орнатыңыз.
cache_time Кері шақыру жауабын клиент жағында кэштеуге болатын максималды уақыт, секундпен. Әдепкі мәні 0. Telegram клиенттері 3.14 нұсқасынан бастап кэштеуді қолдайды.

Маңызды

Бұл функцияны тек 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"}]

Түймені басқаннан кейін, тиісті өрістегі мәтіні бар кері шақыру келеді. "111" түймесін басқан кезде, сіз "first" мәтіні бар кері шақыру аласыз.

Start блогын жасап, триггерде қажетті мәтінді көрсетейік. Біздің жағдайда: "first"

Егер Сәйкестік өрісінде Қателер мен дәлсіздіктерді елемеу таңдалса, бұл блокты кейінірек 1–2 таңбамен ерекшеленетін барлық ұқсас нұсқалар үшін қайта пайдалануға болады. Мысалы, пайдаланушыға осындай түймемен рейтинг бергені үшін алғыс білдіру үшін.

Әрі қарай, калькуляторда tg_answer_callback_query функциясын пайдаланып, келесі параметрлерді беріңіз:
callback_query_id - бұл ID түймені басқан пайдаланушыны анықтауға және оған Alert-хабарландыруды көрсетуге мүмкіндік береді
text - Alert-хабарландырудың мәтіні.

Көшіруге арналған код мысалы:

tg_answer_callback_query('#{callback_query_id}', "Сіз 111 түймесін бастыңыз")

Назар аударыңыз! callback_query_id параметрі мысалда көрсетілгендей, яғни '#{}' ішінде берілуі керек

Егер бәрі дұрыс орнатылса, түймені басу көрсетілген мәтіні бар Alert-хабарландыруға әкеледі. Мобильді нұсқада боттың аты мәтіннің үстінде тақырып ретінде пайда болады.

Егер сіз оның орнына қарапайым қалқымалы хабарламаны көрсеткіңіз келсе, төмендегі мысалда көрсетілгендей, үшінші параметр ретінде False мәнін беріңіз:
tg_answer_callback_query('#{callback_query_id}', "Сіз 222 түймесін бастыңыз", False)

Кері шақыру түймесінің жауаптары ретінде тегпен ботты қайта бағыттауды қосу

Сипаттама

tg_callback_url_open(callback_query_id, url, cache_time)

Инлайн түйменің кері шақыруына жауап ретінде терең сілтеме арқылы Telegram ботын ашады.

Параметрлер

Параметр Сипаттама
callback_query_id Пайдаланушы инлайн түймені басқан кезде алынған кері шақыру сұрауының ID. Бұл қай кері шақыруға жауап беру керектігін анықтайды.
url https://t.me/your_bot?start=XXXX пішіміндегі ботқа терең сілтеме, мұнда your_bot - боттың пайдаланушы аты, ал XXXX - бастау параметрі.
cache_time Кері шақыру жауабын клиент жағында кэштеуге болатын максималды уақыт, секундпен. Әдепкі мәні 0. Telegram клиенттері 3.14 нұсқасынан бастап кэштеуді қолдайды.

Маңызды

Бұл функцияны тек Telegram-да пайдаланушы инлайн кері шақыру түймесін басуына жауап ретінде пайдалануға болады.

Мысал

Кері шақыру түймесінің жауабында 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"}]

Түймені басқаннан кейін, тиісті өрістегі мәтіні бар кері шақыру келеді. "111" түймесін басқан кезде, сіз "first" мәтіні бар кері шақыру аласыз.

Негізгі шартты тексеру блогын жасап, шартта қажетті мәтінді көрсетіңіз. Біздің жағдайда: "first":

Егер Сәйкестендіру опциясы өрісінде Қателер мен дәлсіздіктерді елемеу таңдалса, бұл блокты кейінірек 1–2 таңбамен ерекшеленетін барлық ұқсас нұсқалар үшін қайта пайдалануға болады. Мысалы, пайдаланушыға осындай түймемен рейтинг бергені үшін алғыс білдіру үшін.

Әрі қарай, блоктың калькуляторында tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX') көрсетіңіз:

Супертоп немесе арнада пайдаланушыны әкімші етіп тағайындау

Сипаттама

tg_promote_user(platform_id, user_id, promote_options_list)

Telegram пайдаланушысын супертопта немесе арнада көрсетілген рұқсаттармен әкімші етіп тағайындайды.

Параметрлер

Параметр Сипаттама
platform_id Telegram супертобының идентификаторы немесе пайдаланушыны арнада тағайындау кезіндегі @channelusername форматындағы арнаның пайдаланушы аты.
user_id Тағайындалатын пайдаланушының Telegram пайдаланушы идентификаторы.
promote_options_list Пайдаланушыға берілетін әкімші рұқсаттарының тізімі.

Ескерту

Пайдаланушыға promote_options_list тізіміне енгізілген рұқсаттар ғана беріледі.

**Қажетті параметр: promote_options_list**

promote_options_list параметрінде келесі рұқсаттарды көрсетуге болады:

  1. is_anonymous — әкімшінің чаттағы қатысуын жасырады,
  2. can_manage_chat — әкімші чат оқиғалары журналына, чат статистикасына, арналардағы хабарлама статистикасына, арна мүшелерін көруге, супертоптардағы анонимді әкімшілерді көруге және баяу режимді айналып өтуге қол жеткізе алады. Бұл рұқсат деңгейі келесі артықшылықтардың кез келгені көрсетілсе, әдепкі бойынша беріледі
  3. can_post_messages — әкімші арна жазбаларын жасай алады (тек арналар үшін)
  4. can_edit_messages — әкімші басқа пайдаланушылардың хабарламаларын өңдей алады және хабарламаларды бекіте алады (тек арналар үшін)
  5. can_delete_messages — әкімші басқа пайдаланушылардың хабарламаларын жоя алады
  6. can_manage_video_chats — әкімші бейнечаттарды басқара алады,
  7. can_restrict_members — әкімші мүшелерді шектей алады, оларды чатта бұғаттай/бұғаттан шығара алады,
  8. can_promote_members — әкімші өз артықшылықтарының бір бөлігімен жаңа әкімшілерді тағайындай алады немесе тікелей немесе жанама түрде (мысалы, олар тағайындаған әкімшілерді) тағайындаған әкімшілердің өкілеттігін тоқтата алады
  9. can_change_info — әкімші чаттың атауын, фотосын және басқа параметрлерін өзгерте алады
  10. can_invite_users — әкімші чатқа жаңа пайдаланушыларды шақыра алады
  11. can_pin_messages — әкімші хабарламаларды бекіте алады (тек супертоптар үшін).
Мысал

Мысал: Пайдаланушыны супертопта әкімші етіп тағайындау:

Бұл мысалда көрсетілген рұқсаттардан басқа, can_manage_chat рұқсаты әдепкі бойынша беріледі.

Көшіруге арналған код мысалы

Мысал 1. 
promote_options_list = ‘[“can_promote_members”,”can_change_info”,”can_invite_users”]’ 
tg_promote_user(platform_id, user_id, promote_options_list)

Мысал 2. 
promote_options_list = '["can_manage_chat","can_post_messages","can_edit_messages","can_delete_messages","can_manage_video_chats","can_promote_members","can_restrict_members","can_invite_users","can_pin_messages"]' 
result=tg_promote_user(platform_id, reply_from, promote_options_list)  

Telegram боты арқылы әкімші атауын өзгерту

Сипаттама

tg_set_administrator_title(platform_id, user_id, title)

Telegram супертоп әкімшісі үшін теңшелетін әкімші атауын орнатады.

Параметрлер

Параметр Сипаттама
platform_id Telegram супертобының идентификаторы.
user_id Әкімшінің Telegram пайдаланушы идентификаторы.
title Теңшелетін әкімші атауы.

Маңызды

  • Атау ұзындығы 0-ден 16 символға дейін болуы керек.
  • Атауда эмодзилерге рұқсат етілмейді.
  • Бұл функция тек бот тағайындаған әкімшілер үшін жұмыс істейді.

Мысал

result = tg_set_administrator_title(platform_id, reply_from, "firetitle")

Кәдімгі чат мүшелеріне немесе нақты Telegram пайдаланушыларына арналған жалпы шектеулер

Сипаттама

tg_chat_permission(platform_id, permission, media_permissions)

Telegram чатындағы мүшелер үшін әдепкі рұқсаттарды орнатады.

Параметрлер

Параметр Сипаттама
platform_id Telegram чатының идентификаторы.
permission Жалпы чат рұқсаттарының массиві. Әрбір элемент қолдау көрсетілетін рұқсаттар тізіміндегі рұқсатқа сәйкес келеді. Әрекетке рұқсат беру үшін 1 мәнін, тыйым салу үшін 0 мәнін пайдаланыңыз.
media_permissions Медиаға қатысты рұқсаттар массиві. Әрбір элемент қолдау көрсетілетін медиа рұқсаттар тізіміндегі рұқсатқа сәйкес келеді. Әрекетке рұқсат беру үшін 1 мәнін, тыйым салу үшін 0 мәнін пайдаланыңыз.

Ескерту

Екі массивтегі мәндердің реті сәйкес рұқсаттар тізімдерінің ретіне сәйкес келуі керек. Әрбір массив элементі белгілі бір рұқсатты басқарады:

  • 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 - анимацияларды, ойындарды, стикерлерді жіберуге және инлайн боттарды пайдалануға рұқсат. Ол 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 Telegram чатының идентификаторы *
! user_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 - анимацияларды, ойындарды, стикерлерді жіберуге және инлайн боттарды пайдалануға рұқсат. Ол 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 минут бойы бәрінен шектелген:

Пайдаланушы чатқа кіргенде, ол чатта хабарлама жібере алмайтыны туралы хабарландыруды көреді.
Егер уақыт шектеуі орнатылса, олар бұл шектеудің ұзақтығын да көреді.

Көшіруге арналған код мысалы:

permission = [0, 0, 0, 0, 0, 0, 0, 0] 
tg_restrict_chat_member(-1001607137668, 473737685, 3, permission)

Хабарламаны бекіту

Сипаттама

tg_pin_chat_message(platform_id, message_id, disable_notification)

Telegram чатында хабарламаны бекітеді.

Параметрлер

Параметр Сипаттама
platform_id Telegram чатының ID.
message_id Бекітілетін хабарламаның ID.
disable_notification Чат мүшелеріне бекітілген хабарлама туралы хабарландыру жіберу керек пе екенін басқарады. Хабарламаны үнсіз бекіту үшін 1 мәнін, немесе хабарландыру жіберу үшін 0 мәнін орнатыңыз.

Ескерту

Арналарда және жеке чаттарда хабарландырулар әрқашан өшірілген, disable_notification параметрінің мәніне қарамастан.

Хабарламаны бекітуді алып тастау

Сипаттама

tg_unpin_chat_message(platform_id, message_id)

Telegram чатында хабарламаның бекітілуін алып тастайды.

Параметрлер

Параметр Сипаттама
platform_id Telegram чатының ID.
message_id Бекітілуі алынып тасталатын хабарламаның ID. Егер көрсетілмесе, ең соңғы бекітілген хабарламаның бекітілуі алынып тасталады.

Ескерту

Егер message_id көрсетілмесе, функция жіберу уақыты бойынша ең соңғы бекітілген хабарламаның бекітілуін алып тастайды.

Барлық бекітілген хабарламалардың бекітілуін алып тастау

Сипаттама

tg_unpin_all(platform_id)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *

НАЗАР АУДАРЫҢЫЗ!

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 Telegram ішіндегі чат ID *
**!** question сұрақ
**!** options жауап нұсқаларының массиві
is_anonymous 1 - анонимді сауалнама , '' - анонимді емес
allows_multiple_answers 1 - бірнеше жауап қолжетімді, '' - бір жауап
reply_markup пернетақта немесе '' - пернетақтасыз
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. Егер пайдаланушы мессенджерде сауалнама қосса, чатқа кері шақыру жіберіледі:

poll_added - өзгермейтін бөлік
YOUR QUESTION - сауалнамадағы сұрақ мәтіні

Арнаға сауалнама қосу кезіндегі кері шақыру мысалы

Чатқа сауалнама қосу кезіндегі кері шақыру мысалы

poll_added-тен кейінгі екінші кері шақыру сандарды қамтиды - бұл сауалнаманы қосқан пайдаланушының Telegram-дағы идентификаторынан басқа ештеңе емес.

Бот сауалнаманы жасаған кезде кері шақыру келмейді.

3. Арнада тек анонимді сауалнамалар жасауға болады

Назар аударыңыз, топқа тек анонимді сауалнамаларды жіберу ұсынылады!

  1. Сауалнаманы жасағаннан кейін оның идентификаторын айнымалыға сақтаңыз, осылайша қай сауалнамаға кері шақыру келгенін түсінуге болады.
Мысал

Клиенттердің кері байланысы біздің өсуіміздің кілті болып табылады. Сауалнамалар бұл кері байланысты алудың және оны нақты бизнес қорытындыларына айналдырудың қарапайым әдісін ұсынады.

Көшіруге арналған код мысалы:

/* Қарапайым сауалнама құру мысалы */
options = ["white", "red", "blue", "green"]
poll1 = tg_send_poll(platform_id, 'What is your favorite color?', options, 1, '', '', 1, '')

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 Telegram ішіндегі чат ID *
**!** question сұрақ
**!** options жауап нұсқаларының массиві
**!** explanation пайдаланушы қате жауапты таңдағанда немесе викторина стиліндегі сауалнамада шам белгішесін басқанда көрсетілетін мәтін, нысандарды талдаудан кейін 0–200 таңба, екі жол үзілімінен аспайды.
**!** correct_option_id дұрыс жауаптың нөмірі, нөмірлеу 1-ден басталады
is_anonymous 1 - анонимді сауалнама , '' - анонимді емес
reply_markup пернетақта немесе '' - пернетақтасыз
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 функциясы message_id қамтитын Telegram жауабын қайтарады. Бұл ID әрқашан сақтаңыз, себебі ол келесі әрекеттер үшін қажет:

  • tg_stop_poll функциясын пайдаланып викторинаны аяқтау (төмендегі сипаттаманы қараңыз).
  • Қорытынды нәтижелерді алу.

2. poll_added кері шақыруы

Егер пайдаланушы арнаға сауалнама қосса, бот кері шақыруды алады:

  • Пішімі: poll_added + Сауалнама сұрағы
  • Топтық чатқа қосылса: кері шақыру сонымен қатар сауалнаманы қосқан адамның Telegram пайдаланушы ID мәнін қамтиды.

Егер бот жасаса: poll_added кері шақыруы жіберілмейді.

3. Арна шектеуі

Арналарда тек анонимді викториналар жасауға болады.

4. poll_answer кері шақыруы (Пайдаланушы дауыс беруі)

Пайдаланушы жеке чатқа немесе топқа жіберілген викторинада дауыс бергенде, боттың сол клиентпен диалогына кері шақыру жіберіледі:

  • Пішімі: poll_answer + Сауалнама ID + [Жауап индексі]
  • Мысалы: poll_answer 5325838371359031648 [3]
  • Ескерту: жауаптарды нөмірлеу 0-ден басталады. [3] пайдаланушы төртінші жауап нұсқасын таңдағанын білдіреді.

5. Анонимді емес топтық сауалнамаларға арналған вебхук

Бот әкімші болып табылатын топтардағы анонимді емес сауалнамалар үшін әрбір дауысқа вебхук жіберіледі. Оны алғаннан кейін бот poll_answer кері шақыруын (4-тармақтағыдай) тиісті клиентпен диалогына жібереді.

6. Белсендіру талабы және ең жақсы тәжірибе

  • Талап: бот әңгімені бастай алмайды. Егер клиент ботқа ешқашан хабарласпаса, олар ботты алдымен белсендірмейінше (мысалы, /start пәрменін жіберу арқылы) сіз оларға дауыс беруіне жауап ретінде тікелей хабарлама жібере алмайсыз.

Ұсыныс: бұл шектеуді болдырмау үшін топтарға тек анонимді викториналарды жіберу ұсынылады.

7. Сауалнамаларыңызды бақылаңыз

Викторинаны жасағаннан кейін бірден оның бірегей Сауалнама ID мәнін айнымалыға сақтаңыз. Бұл кіріс кері шақырудың қай нақты сауалнамаға қатысты екенін анықтауға мүмкіндік береді.

Мысал

Көшіруге арналған код мысалы.

options = ["white", "red", "blue", "green"] 
r = tg_send_quiz_poll(platform_id, "What color is a crocodile?", options, "That is the explanation", 4, '', '', '', '', 1)

Мысал: викторина құру.

Сауалнаманы аяқтау

Сипаттама

tg_stop_poll(platform_id, message_id)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** message_id сауалнама/викторина хабарламасының ID. Оны вебхуктан алуға болады

Сауалнаманы/викторинаны аяқтау үшін осы функцияны шақыру қорытынды нәтижелерді қамтитын сөздікті қайтарады.

Telegram-да тақырыптармен жұмыс істеу

Маңызды: топтың негізгі тақырыбының ID-і жоқ және онымен жұмыс істеу үшін бөлек функциялар қажет.

Топтың Жалпы тақырыбын қайта атау

Сипаттама

tg_edit_general_forum_topic(platform_id, topic_name)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** topic_name жаңа тақырып атауы
bot_name

қосымша параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай бот орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары пайдаланылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ ID" өрісінен табыңыз.

Мысал

Топтың Жалпы тақырыбын tg_edit_general_forum_topic() функциясы арқылы өзгертуге болады. Ол екі міндетті параметрді қажет етеді: чат ID және Топ тақырыбының жаңа атауы:

Көшіруге арналған код мысалы

Жалпы тақырып чатын қайта атау/
answer = tg_edit_general_forum_topic(-1001839380031, 'General')

Жалпы тақырыпты қалай жабу керек

Сипаттама

tg_close_general_forum_topic(platform_id)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
bot_name

міндетті емес параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай боттың орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары қолданылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ ID" өрісінен табыңыз.

Көшіруге арналған код мысалы

/Жалпы тақырып чатын жабу/
answer = tg_close_general_forum_topic(-1001839380031)

Бұрын жабылған Жалпы тақырыпты қалай қайта ашу керек

Сипаттама

tg_reopen_general_forum_topic(platform_id)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
bot_name

міндетті емес параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай боттың орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары қолданылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ ID" өрісінен табыңыз.

Көшіруге арналған код мысалы

/Жалпы тақырып чатын қайта ашу/
answer = tg_reopen_general_forum_topic(-1001839380031)

Жалпы тақырыпты қалай жасыру керек

Сипаттама

tg_hide_general_forum_topic(platform_id)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
bot_name

міндетті емес параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай боттың орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары қолданылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ ID" өрісінен табыңыз.

Жалпы тақырып чатын Тақырып қатысушылары үшін жабуға болады (олар оқи алады, бірақ жаза алмайды) және жаңа пайдаланушылар үшін Telegram жалпы чат тізімінен жасыруға болады.

Көшіруге арналған код мысалы

/Жалпы тақырып чатын жасыру/
answer = tg_hide_general_forum_topic(-1001839380031)

Жалпы тақырыпты қалай көрсету немесе оның көрінуін қалпына келтіру

Сипаттама

tg_unhide_general_forum_topic(platform_id)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі тақырып ID *
bot_name

міндетті емес параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай боттың орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары қолданылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ ID" өрісінен табыңыз.

Маңызды!

Бұл функция Жалпы тақырыпты қайта ашпайды; ол тек оны көрінетін етеді.

Көшіруге арналған код мысалы

/Жалпы тақырып чатын көрсету/
answer = tg_unhide_general_forum_topic(-1001839380031)

Telegram-да жаңа тақырыпты қалай жасау керек

Сипаттама

tg_create_forum_topic(platform_id, name, icon, icon_color)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** name жаңа тақырып атауы
icon тақырыпқа орнатылатын эмодзи ID. Жол ретінде беріледі. Тек tg_get_forum_icon функциясы арқылы алынған тізімдегі эмодзилерді ғана пайдалануға болады.
icon_color эмодзи түсі: 7322096, 16766590, 13338331, 9367192, 16749490, 16478047 тізімінен. Барлық эмодзилер түс өзгертуді қолдамайды.
bot_name

міндетті емес параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай боттың орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары қолданылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ 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 Telegram ішіндегі чат ID *
**!** message_thread_id қосымша тақырып чатының ID
name жаңа тақырып атауы
icon тақырыпқа орнатылатын эмодзи ID. Жол ретінде беріледі. Тек tg_get_forum_icon функциясы арқылы алынған тізімдегі эмодзилерді ғана пайдалануға болады.
bot_name

міндетті емес параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай боттың орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары қолданылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ ID" өрісінен табыңыз.

Көшіруге арналған код мысалы

answer = tg_edit_forum_topic(-1001839380031, 254)

Таңдалған тақырыпты қалай жабу керек

Сипаттама

Тақырыпты жабу оны тек оқуға арналған етуді білдіреді; жабылған тақырыпта жазуға рұқсат етілмейді.

tg_close_forum_topic(platform_id, message_thread_id)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** message_thread_id қосымша тақырып чатының ID
bot_name

міндетті емес параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай боттың орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары қолданылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ ID" өрісінен табыңыз.

Көшіруге арналған код мысалы

answer = tg_close_forum_topic(-1001839380031, 254)

Бұрын жабылған тақырыпты қалай қайта ашу керек

Сипаттама

tg_reopen_forum_topic(platform_id, message_thread_id)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** message_thread_id қосымша тақырып чатының ID
bot_name

міндетті емес параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай боттың орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары қолданылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ ID" өрісінен табыңыз.

Көшіруге арналған код мысалы

answer = tg_reopen_forum_topic(-1001839380031, 254)

Тақырыпты және оның барлық хабарламаларын қалай жою керек

Сипаттама

tg_delete_forum_topic(platform_id, message_thread_id)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** message_thread_id қосымша тақырып чатының ID
bot_name

міндетті емес параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай боттың орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары қолданылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ ID" өрісінен табыңыз.

Көшіруге арналған код мысалы

answer = tg_delete_forum_topic(-1001839380031, 254)

Тақырыптағы барлық хабарламаларды қалай бекітуден шығару керек

Сипаттама

tg_unpin_topic_messages(platform_id, message_thread_id)

Параметрлер:

Параметр Сипаттама
**!** platform_id Telegram ішіндегі чат ID *
**!** message_thread_id қосымша тақырып чатының ID
bot_name

міндетті емес параметр: бот атауы.

Тақырыптармен жұмыс істеу кезінде функцияны қай боттың орындау керектігін көрсетуге болады. Бұл жобаңызда бірнеше Telegram боттары қолданылса пайдалы. Бот атауын "Арналар" бөліміндегі "Топ ID" өрісінен табыңыз.

Көшіруге арналған код мысалы

answer = tg_unpin_topic_messages(-1001839380031, 254)

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'}

Көшіруге арналған код мысалы
answer = tg_get_forum_icon()