Хабарламаларды жіберу және өңдеу функциялары

Қажетті параметрлер жиынтығы бар қарапайым мысалды қарастырайық:

platform_id нақты клиенттің идентификаторын көрсетеді.

Айнымалыларды қолданатын сол мысалды қараңыз:

Бұл мысалда soob айнымалысы хабарламаны жібергеннен кейін сервердің жауабын қамтиды.

Алынған жауаптан message_id сақтасаңыз, бұл кейінірек осы хабарламамен жұмыс істеуге мүмкіндік береді (өңдеу, жою, қайта жіберу, пікір қалдыру).

Барлық параметрлерді пайдаланған кезде қиындықтар жиі туындайды. Келесі мысалды қарастырайық:

• Алдымен функцияда қолданылатын барлық параметрлерді жариялаңыз. Есіңізде болсын, параметрлерді мәндер ретінде ғана емес, сонымен қатар айнымалылар ретінде де беруге болады, бұл жиі ыңғайлы және түсінікті. platform_id және client_message_id сияқты айнымалыларды клиенттің профиль картасынан алуға болады.
  platform_id — хабарлама жіберілетін Telegram клиентінің идентификаторы *\ >Біз клиент жазған чатта жауап береміз

  text - хабарлама мәтіні. \ >Біз мәтінді пішімдеуді қолданамыз - мысалы, қалың қаріппен бөлектеу.

  client_message_id - Дәйексөзге алынатын хабарлама идентификаторы\ >Чаттарда бұл айнымалыға оның мәні автоматты түрде тағайындалады.
  reply_markup — түйме параметрлері **. \ >Оны opts айнымалысына тағайындайық.
  parse_mode — Сипаттамадағы қалың және курсив мәтін пішімдеу ***. Ол html, markdown, markdownV2 сияқты мәндерге ие бола алады. Хабарлама мәтінін пішімдеу үшін қолданылатын таңбалар осы жерде сипатталған. \ >markdown қолданайық.
  disable_web_page_preview - Сілтеме алдын ала қарауын көрсету. Өшіру үшін 1 мәнін беріңіз; әйтпесе 0 мәнін беріңіз немесе бос "" қалдырыңыз.\ >Хабарлама мәтінінде сілтеме болмағандықтан, біз кез келген мәнді бере аламыз.
  protect_content — Мазмұнды қорғау жалаушасы. Қосу үшін 0, False немесе '' мәндерінен басқа кез келген мәнді беріңіз.\ >Бізге мазмұнды қорғау қажет емес, сондықтан біз бос жолды ''' береміз.
  disable_notification — Дыбыстық хабарландыру жалаушасы (әдепкі: 0). Хабарландыруды өшіру үшін 1, қосу үшін 0 мәнін беріңіз.\ >Хабарландыру - бұл хабарлама мәтінін көрсететін қалқымалы терезе. Оны қосамыз.

• Әрі қарай, функцияны жинаймыз. Функцияны айнымалыға тағайындауды ұмытпаңыз - бұл хабарламаны жіберу күйін бақылауға мүмкіндік береді.

Міне, біз алған нәтиже:

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

ok ішінде біз жіберу күйін көреміз; келесіде хабарламаның өзі туралы ақпарат - оның идентификаторы, жіберуші деректері және мазмұны.

entities параметрімен мысал

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

text = "qwert asdfg zxcvb poiuy lkjhg 12345"

Параметрді деректері бар сөздік ретінде жазып, қаріптерді көрсету арқылы қажетті пішімдеуді көрсету керек:

entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"`` https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

Параметрді қолданатын функцияда соңғы ретінде беріңіз. Параметрді tg_send_message және tg_send_message_1 функцияларына да беруге болады:

x = tg_send_message(platform_id, text, None, None, None, False, False, False, None, entities)

Параметрді беру мысалы:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

Мысал тек сөздікті көрсетеді, ал хабарлама мәтінінің өзі бөлек айнымалыға тағайындалады.

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

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

Калькулятордағы мысал:

Төменде хабарламаларды өңдеуге арналған Telegram API функцияларымен жұмыс істеудің егжей-тегжейлі мысалын таба аласыз.

1-мысал

/*Мәтінді алдын ала айнымалыда анықтау ыңғайлы*/
text='Жазу-жазу-жазу мәтіні'
/*Хабарлама жіберу функциясы*/
soob=tg_send_message(platform_id, text)
/*Жіберілген хабарлама идентификаторын сақтау*/
soob_id=soob['result']['message_id']

2-мысал

id_group=-1001847103100
text='API әдісі арқылы хабарлама жіберуді тестілеу. Мысалы, *қалың мәтін*'
opts = {"inline_keyboard": [[{"text": "👍","callback_data":1}, {"text": "👎","callback_data":2}]]}
disable_web_page_preview=1
protect_content=''
disable_notification=1
parse_mode='markdown'
soob=tg_send_message(id_group, text,client_message_id, opts, parse_mode, disable_web_page_preview, protect_content, disable_notification) 

Сонымен, өзімізге инлайн пернетақтасы бар хабарлама жіберейік:

Әрі қарай, хабарлама мәтінін өңдейміз:

Және түймелерді өңдейміз:

Суреті бар хабарламаны өңдеуге тырысайық. Ол үшін суреті бар хабарламаны жіберіп, жіберілген хабарлама идентификаторын сақтаңыз. Сурет URL мекенжайын қалай алуға болатыны туралы егжей-тегжейлі нұсқауларды осы жерден оқыңыз:

Енді суретті және оның сипаттамасын өңдейік:

/*Параметрлерді алдын ала айнымалыда анықтау ыңғайлы.*/
text='Қандай пакетті таңдағыңыз келеді?'
opts = {"inline_keyboard": [[{"text": "Пакет 1","callback_data":1}, {"text": "Пакет 2","callback_data":2}]]}
/*Хабарлама жіберу функциясы*/
soob=tg_send_message(platform_id, text, None, opts)
/*Жіберілген хабарлама идентификаторын сақтау*/
soob_id=soob['result']['message_id']

/*Хабарламаны өңдеу*/
text='Сізге қандай пакет қызықты?'
tg_edit_message_text(platform_id, soob_id, text, opts)  

/*Инлайн пернетақтаны өңдеу*/
opts = {"inline_keyboard": [[{"text": "Стандартты","callback_data":1}, {"text": "Премиум","callback_data":2}]]}
tg_edit_message_reply_markup(platform_id, soob_id, opts)


/*Сипаттамасы бар суретті жіберу*/
soob=tg_send_photo(platform_id, "AgACAgIAAxkBAAIPpWO4T7jhOgYHq6uR8rjnq9rIvBs-AAJlwDEb5fHASaGdhzgWjyn7AQADAgADeAADLQQ", "Бұл сурет")
/*Жіберілген хабарлама идентификаторын сақтау*/
soob_id=soob['result']['message_id']

/*Суретті өңдеу*/
media='{"type": "photo", "media": "AgACAgIAAxkBAAIPrmO4UiH7Tazqn-3IbFVzPKNsVEZmAAJ1wDEb5fHASWcNXKah-egvAQADAgADeQADLQQ"}'
tg_edit_message_media(platform_id, soob_id, media)
/*Сурет сипаттамасын өңдеу*/
tg_edit_message_caption(platform_id, soob_id, 'Бұл - МЕН!')

Хабарламаны жіберіп, оның идентификаторын сақтайық.

Және бұрын жіберілген хабарламаны көшірейік.

/*Параметрлерді алдын ала айнымалыда анықтау ыңғайлы.*/
text='Қандай пакетті таңдағыңыз келеді?'
opts = {"inline_keyboard": [[{"text": "Пакет 1","callback_data":1}, {"text": "Пакет 2","callback_data":2}]]}
/*Хабарлама жіберу функциясы*/
soob=tg_send_message(platform_id, text, None, opts)
/*Жіберілген хабарлама идентификаторын сақтау*/
soob_id=soob['result']['message_id']


/*Жіберілген хабарламаны көшіру*/
tg_copy_message('5081438490', '1840834360', soob_id, None, opts, None, None, 1)