Басу хабарландыруы бар сілтемелер
proxy() | proxy_date() | proxy_timeout()
АНЫҚТАМА:
! - Міндетті параметрлер
proxy(lnk, one-shot) - басу хабарландыруы бар сілтемені жасайды. Функция келесі параметрлерді қабылдайды:\ ! link - сілтеме
one-shot - сілтеменің бір реттік екенін көрсететін көрсеткіш. Жай ғана 1 мәнін беріңіз.
proxy_date(lnk, date, time) - басу хабарландыруы және белгіленген жарамдылық мерзімі бар сілтемені жасайды. Функция келесі параметрлерді қабылдайды:\ ! link - сілтеме\ ! date - сілтеменің жарамдылық мерзімі \ ! time - сілтеменің жарамдылық уақыты
one-shot - сілтеменің бір реттік екенін көрсететін көрсеткіш. Жай ғана 1 мәнін беріңіз.
proxy_timeout(lnk, minutes, one-shot) - басу хабарландыруы және белгіленген қолжетімділік таймері бар сілтемені жасайды. Функция келесі параметрлерді қабылдайды:\ ! link - сілтеме\ ! minutes - сілтеменің белсенді болу минуттарының саны.
one-shot - сілтеменің бір реттік екенін көрсететін көрсеткіш. Жай ғана 1 мәнін беріңіз.
Қарапайым мысалды қарастырайық:
Біз екі прокси сілтеме жасап, оларды түймелерге және хабарлама мәтініне енгіздік. Telegram-да сынақ жүргізіп жатқандықтан, Markdown көмегімен сілтемелерді дұрыс пішімдеуді еске салуға жақсы мүмкіндік. Арнайы таңбаларды өңдеу үшін біз tg_escape() функциясын қолдандық.
Мысалы, клиент оларды Telegram-да келесідей көреді:
Клиент сілтемені басқанда, біз кері шақыру аламыз:
Осы оқиғаға жауапты конфигурациялайық:
Енді сілтемелерді жою функцияларын сынап көрейік:
Осылайша, егер клиент бір реттік сілтемені ол жойылғаннан кейін пайдалануға тырысса, сілтеме енді жоқ болғандықтан, ол қате алады.
Уақытпен шектелген сілтемені жояйық:
Функцияны орындағаннан кейін клиент картасында ешқандай прокси сілтеме қалмайды және сілтеме бойынша өтудің кез келген әрекеті бірдей қатені қайтарады.
«Хабарлама» өрісіне арналған код мысалы (егер Telegram-мен жұмыс істесеңіз, Markdown қосулы екенін ұмытпаңыз):
*Сілтемелерді тексеру:*
[Басу](#{link3})
немесе келесі шығыс пішімін пайдаланып сынап көріңіз:
«Калькулятор» өрісіндегі код мысалы:
link1=proxy('https://mavibot.ai/', 1)
link2=short_date('https://mavibot.ai/#tariff', '11.06.2025', '2pm')
link3=tg_escape(link2)
Клиент прокси сілтемені басқанда, сіз link_was_pressed түрінде кері шақыру аласыз. Бұл сілтемені басуға реакцияны конфигурациялауға мүмкіндік береді.
Мұны істеу үшін алынған кері шақыруды «Шарт» өрісіне енгізіңіз және сәйкестік түрін «Нақты сәйкестік» деп орнатыңыз.
Сілтемелерді қысқарту
short() | short_date() | short_timeout()
АНЫҚТАМА:
! - Міндетті параметрлер
short(lnk, one-shot) - басу хабарландыруынсыз сілтемені жасайды. Функция келесі параметрлерді қабылдайды:\ ! link - сілтеме
one-shot - сілтеменің бір реттік екенін көрсететін көрсеткіш. Жай ғана 1 мәнін беріңіз.
short_date(lnk, date, time) - басу хабарландыруынсыз және белгіленген жарамдылық мерзімі бар сілтемені жасайды. Функция келесі параметрлерді қабылдайды:\ ! link - сілтеме\ ! date - сілтеменің жарамдылық мерзімі \ ! time - сілтеменің жарамдылық уақыты
one-shot - сілтеменің бір реттік екенін көрсететін көрсеткіш. Жай ғана 1 мәнін беріңіз.
short_timeout(lnk, minutes, one-shot) - басу хабарландыруынсыз және белгіленген қолжетімділік таймері бар сілтемені жасайды. Функция келесі параметрлерді қабылдайды:\ ! link - сілтеме\ ! minutes - сілтеменің белсенді болу минуттарының саны.
one-shot - сілтеменің бір реттік екенін көрсететін көрсеткіш. Жай ғана 1 мәнін беріңіз.
Сілтемелерді жою
remove_links() | remove_one_time_links()| remove_timer_links()
АНЫҚТАМА:
! - Міндетті параметрлер
remove_links() - клиентке жіберілген барлық қысқартылған сілтемелерді өшіру
remove_one_time_links() - клиентке жіберілген барлық бір реттік сілтемелерді өшіру
remove_timer_links() - клиентке жіберілген барлық уақытпен шектелген сілтемелерді өшіру
Telegram бот викторина сілтемесі
quiz_link_timeout() | quiz_link_date() | quiz_link()
Назар аударыңыз!
Сілтеменің жарамдылық мерзіміне 21 күн шектеуі бар, сондықтан оны жаңарту қажет!
Telegram-да викторинаны көрсетуді қосу үшін келесі әрекеттерді орындау қажет:
1. Веб-сайт бетінің идентификаторын көшіріп алыңыз. Ол үшін «Веб-сайттар» бөліміне өтіп, қажетті веб-сайтты таңдаңыз:
Мәтінде әрі қарай біз mini_landing_page_id айнымалысының атауын қолданамыз.
2. «Калькулятор» өрісінде келесі функциялардың бірін пайдаланыңыз:
АНЫҚТАМА:
! - Міндетті параметрлер
quiz_link_timeout(mini_landing_page_id, minutes) - минуттармен белгіленген өмір сүру ұзақтығы шегі бар сілтемені жасайды
Параметрлер:
! mini_landing_page_id - веб-сайт бетінің идентификаторы
minutes - сілтеменің өмір сүру ұзақтығы минуттармен (тип: сан)
quiz_link_date(mini_landing_page_id, date, time) - белгілі бір күн мен уақытпен шектелген жарамдылық мерзімі бар сілтемені жасайды
Параметрлер:
! mini_landing_page_id - веб-сайт бетінің идентификаторы
date - сілтеменің белсенді күні (пішім: кк.аа.жжжж)
time - сілтеменің белсенді уақыты (пішім: сағ:мм)
quiz_link(mini_landing_page_id) - жарамдылық мерзімі жоқ сілтемені жасайды
Параметрлер:
! mini_landing_page_id - веб-сайт бетінің идентификаторы
3. Telegram Web App түймесін жасаңыз және айнымалы атауын фигуралық жақшаларда хэш белгісімен көрсетіңіз.
Маңызды!
Қосымша параметрлерде айнымалы мәнінің дұрыс сақталғанына көз жеткізіңіз.
Егер клиентті веб-сайт бетіне бағыттау үшін quiz_link_timeout пайдалансаңыз, бет тақырыбы мен сипаттамасында клиент айнымалыларын пайдалануға болады. Мысалы, егер клиентте name айнымалысы «John» мәнімен болса және бет сипаттамасы «Hi #{name}, how are you?» деп көрсетілсе, шығыс «Hi John, how are you?» болады. Алайда, егер клиентте бұл айнымалы болмаса, мән жобаның жаһандық айнымалыларынан алынады.
Ескерту! Жарамдылық мерзімі жоқ сілтемелерді пайдалану кезінде абай болыңыз. Егер сілтеме басқа біреумен бөлісілсе және ол викторинаны аяқтаса, нәтижелер сілтеме бастапқыда жасалған клиентке жазылады.