API функциялары Telegram-дағы боттың мүмкіндіктерін айтарлықтай кеңейтеді. API функцияларын пайдалана отырып, Telegram-дағы тіркемелермен, топтармен және чаттармен жұмыс істеуге болады — мысалы, пайдаланушыларды блоктау немесе блоктан шығаруды автоматтандыру және т.б.!

Дереккөз: Telegram bot API

Маңызды!

API функцияларымен жұмыс істеуді түсіну үшін калькуляторда функциялар мен параметрлерді көрсету ережелерімен танысуды ұсынамыз.

БЕЛГІЛЕУ:

! — леп белгісі міндетті параметрлерді көрсетеді

parameter=None — бұл көрсетілген параметрдің әдепкі мәнін көрсетеді.

Құжаттамадан функция мәтінін дәл осылай көшіру дұрыс емес: tg_send_message(platform_id, "Some text", client_message_id=61818138, reply_markup=None, parse_mode=None, disable_web_page_preview=0, protect_content=False)

Теңдік белгісінен кейінгі мәндер әрбір параметрдің әдепкі мәндерін білдіреді. Сондықтан, егер сізге белгілі бір параметр қажет болмаса, бірақ одан кейінгі параметр қажет болса, пайдаланылмаған параметрді жай ғана өткізіп жіберуге болмайды — оның орнына оның әдепкі мәнін анық көрсету керек.

Осылайша, дұрыс пайдалану: tg_send_message(platform_id, "Some text", 61818138, None, None, 0, True)

Хабарландыруларды жіберу үшін platform_id қайдан алуға болады?

  • Жобаңызға Telegram боты қосылған болуы керек.
  • Хабарландыруларды алғыңыз келетін Telegram аккаунтынан осы ботқа кез келген хабарлама жіберіңіз.
  • Жоба клиенттерінің тізімінен сұрауларды жібергіңіз келетін клиент диалогын таңдаңыз.
  • Мессенджер өрісінен ID мәнін көшіріңіз.

  1. platform_id параметрін сандық мәндерді анық көрсетпей-ақ беруге болады.

react = tg_set_reaction(platform_id, 1556, '👌')

Бұл параметрі бар функциялар platform_id мәнін анық көрсетпесе де жұмыс істейді.

Маңызды: Көптеген функцияларда бұл параметр міндетті және оны алып тастауға болмайды.

2. Функцияны белгілі бір чатта, арнада немесе топта пайдалану қажет болса, platform_id сандық мән ретінде берілуі керек.

Жоғарыда көрсетілген tg_send_message(!platform_id, !text) функциясында platform_id параметрі сандық мәнді қамтитын тырнақшалар арқылы беріледі:

tgmess = tg_send_message('1234566788', 'Hello!')

reply_markup параметрінде түймелерді қалай анықтауға болады

Жауап түймелерінің мысалы:

opts = {"keyboard": [[{"text": "Left"}, {"text": "Right"}]]}

Ішкі түймелердің мысалы:

opts = {"inline_keyboard": [[{"text": "Package 1","callback_data":1}, {"text": "Package 2","callback_data":2}]]}

parse_mode параметрінде мәтінді пішімдеуді (Markdown) қалай пайдалануға болады?

parse_mode параметрі бүкіл мәтінді немесе оның бөліктерін курсив немесе қалың етіп пішімдейді. Ол келесі мәндерге ие болуы мүмкін: html, markdown немесе markdownV2.

  1. Егер html таңдасаңыз:

қалың мәтін үшін "<b>caption</b>" қолданыңыз

курсив мәтін үшін "<i>caption</i>" қолданыңыз

  1. Markdown үшін:

қалың мәтін үшін "*caption*" қолданыңыз

курсив мәтін үшін "_caption_" қолданыңыз

Курсив мәтінді жіберу мысалы:
tg_send_message(47615196, "<i>italic</i>",None,None,"html")

Қалың мәтінді жіберу мысалы:
tg_send_message(platform_id, '*test*', None, None, 'markdown')