Мақаланы оқуды ұсынамыз Түйме.
Telegram-да жауап түймелерін (қарапайым немесе пернетақта түймелері) және Inline түймелерін (мәтін ішіндегі түймелер) пайдалануға болады.
Маңызды: түймелерге қойылған шектеулер
Түймелерді жасау кезінде келесі платформа шектеулерін ескеріңіз:
- Жауап түймелері (пернетақта): бір жолда ең көбі 12 түйме.
- Inline түймелері: бір жолда ең көбі 8 түйме.
- Түйме мәтіні: 32 таңбамен шектелген.
- Түйме түсі: теңшеу мүмкін емес. Түймелер платформаның әдепкі стилін пайдаланады.
Блокта түймені қалай жасауға болады
Чат-ботта кез келген түймені жасау үшін блок параметрлеріне өтіп, "Түймелер" қойындысын басыңыз:
Содан кейін түймелерді қосу және өңдеу параметрлері ашылады. Содан кейін Қосу түймесін басыңыз:
Параметрлер терезесі ашылып, түйменің жапсырмасын, әрекетін және қосымша опцияларын анықтауға мүмкіндік береді.
Келесі түйме түрлері тек Telegram боты үшін қолжетімді:
- Бөлісу түймесі – пайдаланушыларға мазмұнмен бөлісуге мүмкіндік береді.
- Кері шақыру түймесі – ботыңызға үнсіз кері шақыру сұрауын жібереді.
- Telegram WebApp – Telegram ішінде шағын қосымшаны (мысалы, виджет немесе веб-сайт) ашады.
- Telegram кіру – пайдаланушыларды Telegram тіркелгісі арқылы авторизациялайды.
Telegram-да төлем, телефон нөмірін немесе геолокацияны сұрау және сілтеме жіберу сияқты басқа да түймелер бар.
Бөлісу түймесі
Түймені жасау кезінде "Бөлісу (тек Telegram)" таңдап, өрістерді толтырыңыз (міндетті емес қосымша мәтін өрісі):
Бұл түйме тізімнен контактіні таңдау арқылы ақпаратты жіберуге мүмкіндік береді.
Түйменің "Бөлісу сілтемесі" өрісіне бөліскіңіз келетін URL мекенжайын енгізіңіз.
Контактіні таңдағаннан кейін "Бөлісу сілтемесі" және "Қосымша мәтін" өрістеріндегі мазмұн жіберіледі. Telegram арнасындағы жазбаларға және басқа мазмұнға сілтемелермен бөлісу үшін пайдаланыңыз.
Назар аударыңыз! Кейбір iOS құрылғыларында дұрыс жұмыс істемеуі мүмкін.
Веб-сайтқа кіру түймесі
Кіру түймесі жұмыс істеуі үшін ботыңыз алдымен мақсатты домен үшін авторизацияланған болуы керек. Бұл конфигурация @BotFather арқылы орындалады.
Конфигурациялау қадамдары:
- @BotFather ботпен сөйлесуді ашыңыз.
- Тізімнен ботыңызды таңдаңыз.
- Bot Settings > Domain тармағын таңдап, веб-сайтыңыздың доменін қосыңыз.
Содан кейін Domain түймесіне өтіңіз:
Ескерту: Егер домен бар болса, түйме Edit domain деп, ал доменді қосу қажет болса, Set domain деп оқылады.
Сізге ботыңыз үшін доменді орнату ұсынылады:
Доменнің дұрыс пішімі:
Доменіңізді mavibot.ai немесе MaviBot-қа қосылған веб-сайтыңыз болса, yourdomain.com ретінде енгізіңіз.
Келесі қадам:
Доменіңіз тексеріліп, конфигурацияланғаннан кейін авторизация түймесін жасауға кірісуге болады.
Мәтін өрісіне түймеде көрсетілетін жапсырманы енгізіңіз.
Содан кейін Сілтеме өрісіне авторизация жүретін беттің URL мекенжайын беріңіз.
Қалған өрістер авторизация үшін бөлек бот пайдаланылса қажет болады (осы бот үшін хабарлама жіберуге рұқсат алу керек): атап айтқанда, боттың атын көрсету қажет.
Егер көрсетілген боттан хабарлама жіберу мүмкіндігі қажет болса, онда "Пайдаланушыдан боттан хабарлама жіберуге рұқсат сұрау" құсбелгісін қойыңыз:
Telegram кіру түймесі
Кері шақыру түймесі
Кері шақыру түймесі - бұл клиент бір нәрсені көргенде, ал ботта біз воронканың кез келген блогын іске қосу үшін қажетті кері шақыруды алатын кері байланыс түймесі.
Оны жасау өте қарапайым: Түймелер өрісінде Қосу түймесін басыңыз. Ашылған пішінде мәтінді енгізіңіз, түрін - Кері шақыру түймесі (Telegram) деп көрсетіңіз және түймені басқан кезде қайтарылуы керек Кері шақыру мәтінін енгізіңіз:
Көрнекі түрде түйме кәдімгі inline түймесіне ұқсайды:
Түймені басқаннан кейін клиент картасында конфигурацияланған Кері шақыруды көресіз:
Бұл маңызды!
Telegram пернетақтаның кері шақыру түймелерін қолдамайды.
Назар аударыңыз!
Егер "Кері шақыру" түйме түрі таңдалса, түйме кері шақыру ретінде тек түйме мәтіні кері шақыру мәтінінен өзгеше болғанда ғана көрсетіледі.
Telegram веб-қосымшасы түймесі
Бұл түйме веб-сайтты Telegram-да веб-қосымша ретінде ашуға мүмкіндік береді.
Түймені қосу кезінде оның жапсырмасын көрсетіңіз, Telegram Web App түймесінің түрін таңдаңыз және веб-қосымша ретінде ашылатын веб-сайтқа сілтемені беріңіз:
- Сілтемені айнымалы арқылы көрсетуге болады:
Сілтеме үшін айнымалыны пайдалану мақсатты бет немесе веб-сайт мекенжайы жиі өзгерген кезде өте практикалық.
Қалай жұмыс істейді:
- Жоба параметрлерінде айнымалыны анықтаңыз (мысалы,
landing_page_url). - Барлық ағындардағы Web App түймелерінде осы айнымалыға сілтеме жасаңыз (мысалы,
#{landing_page_url}).
Артықшылығы: әрбір жеке түйме блогында URL мекенжайын қолмен жаңартудың орнына, жоба параметрлерінде айнымалының мәнін бір рет өзгерту жеткілікті, және барлық түймелер автоматты түрде жаңартылады.
Балама: әрине, түйме параметрлерінде тікелей статикалық URL мекенжайын көрсетуге болады.
Telegram API функциялары үшін түймелерді қалай жасауға болады
Telegram Bot API-мен тікелей жұмыс істеу, әсіресе жаңадан бастаушылар үшін қиын болуы мүмкін, бірақ MaviBot әлдеқайда қолжетімді балама ұсынады.
Әдіс: генерацияланған кодты пайдалану
API шақыруларын қолмен жазу қажеттілігін болдырмай, кеңейтілген параметрлерден алдын ала генерацияланған түйме кодын пайдалануға болады.
Қадамдар:
- Блок параметрлеріне өтіп, Түймелер бөлімін ашыңыз.
- Интерфейсті пайдаланып, барлық қажетті түймелерді қосыңыз және конфигурациялаңыз (мәтін, сілтемелер, функциялар).
- Жүйе фондық режимде дұрыс Telegram API кодын автоматты түрде генерациялайды.
Бұл тәсіл платформа негізгі техникалық іске асыруды өңдеген кезде күрделі пернетақталарды көрнекі түрде жасауға мүмкіндік береді.
Түймелеріңіз үшін генерацияланған Telegram API кодын көру үшін "Кеңейтілген параметрлер" түймесін басыңыз.
Түймелеріңізді сынап көріңіз, содан кейін Кеңейтілген параметрлер бөлімінен генерацияланған кодты buttons сияқты айнымалыға көшіріңіз.
Бұл функция Telegram API арқылы келесі параметрлермен хабарлама жібереді: tg_send_message (platform_id, text,client_message_id, reply_markup, sparse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities):
reply_markup параметріндегі функцияға buttons айнымалысын беріңіз:
Түймелеріңіз сіз анықтаған орналасу және стильмен чатта пайда болады.
Жауап түймелерін қалай жоюға болады
Пернетақта түймелері әдетте автоматты түрде жоғалса да, кейде олар көрініп қалуы мүмкін.
Қалған жауап түймелерін мәжбүрлеп тазалау үшін Кеңейтілген параметрлер өрісіне келесі кодты енгізіңіз:
[{"buttons":[],"one_time":true,"index_in_line":0,"line":0}]
Бұл бос түйме конфигурациясы Telegram-ға теңшелетін пернетақтаны жасыруды бұйырады.
Telegram-дағы пернетақта мәзірінің түймелері
Бұл мүмкіндікті тек тәжірибелі пайдаланушыларға пайдалануды ұсынамыз!
Пернетақта түймелері
Пернетақта түймелерін (жауап) Telegram-да тұрақты мәзір ретінде пайдалану мүмкіндігіне ие болу үшін tg_permanent_reply_buttons айнымалысына кез келген мәнді тағайындау жеткілікті (айнымалы жобаның тұрақтысы ретінде жарияланады).
Айнымалы: tg_permanent_reply_buttons
tg_permanent_reply_buttons айнымалысын орнату жауап пернетақтасының (хабарламаның астындағы түймелер) көрінуін толық қолмен басқаруға мүмкіндік береді. Платформаның барлық автоматты жасыру әрекеті өшіріледі.
Қолдану аясы: бұл параметр айнымалы белсенді болған кезде ботта жасалған барлық жауап түймелеріне қолданылады.
Автоматты әрекетке қайта оралу
Пернетақтаны стандартты автоматты жасыруды қалпына келтіру үшін:
-
tg_permanent_reply_buttonsайнымалысын жоба параметрлерінен жойыңыз. - Айнымалы белсенді болған кезде жасалған кез келген жауап түймелерін қайта жасаңыз. "Тұрақты" ереже бойынша жасалған түймелер сол күйді сақтайды және жаңа, автоматты әрекетті мұрагер ету үшін оларды қайта жасау керек.
Telegram-да мәзірді қалай жасауға болады
Telegram ботын жасаушы осындай мәзірді жасай алады.
Ол үшін Telegram-да Botfather ботқа жазыңыз.
/mybots пәрменін енгізіңіз, сонда боттар тізімі ашылады. Қажеттісін таңдаңыз. Сізге мәзір ашылады. Мұнда Edit Bot, содан кейін Edit Commands таңдау керек.
Барлық пәрмендерді және олардың сипаттамаларын бір хабарламада, пәрмен атаулары үшін кіші әріптерді пайдаланып енгізіңіз. Тізім жаңартылған кезде сіз растауды аласыз.
Енді сіз Telegram-да ботпен сөйлесуде мәзірді көре және пайдалана аласыз.
Мәзір түймесін басқан кезде BotFather-де бұрын тіркелген пәрмендер тізімі ашылады:
Содан кейін Mavibot-қа өтіп, осы telegram боты қосылған жобаны ашыңыз.
Start немесе Trigger блоктарын жасаңыз, шарттарға пәрмендерді, ал "Хабарлама мәтіні" өрісіне — жауап ретінде алынатын мәтіндерді жазыңыз.
Мысал:
Екі түйме түрін қалай біріктіруге болады
Визуализациялау қажет жауап түймесі (пернетақта) бар блокты жасаңыз.
Келесі блокты (0 секунд таймер) inline түймелерімен (мәтін ішіндегі түймелер) жасаңыз, олар жауап түймелерін жоймай орналастырылуы керек. Мысалы: [{"type": "inline", "text": "ТҮЙМЕ АТАУЫ", "line": 0, "index_in_line": 0}]
Міне, нәтиже:
Маңызды: бір блокта түймелерді қосу кезінде келесі ретті сақтау керек:
- Алдымен, барлық Жауап (пернетақта) түймелерін қосыңыз.
- Содан кейін, кез келген Inline түймелерін қосыңыз.
Егер бұл реттілік кері болса, келесі хабарлама блогы жіберілген кезде жауап түймелері жойылады.